更新记录

0.1.0（2026-04-20）

0.1.0（2026-04-19）

• 鸿蒙原生视频播放器插件首发版发布
• 支持范围为 uni-app + HarmonyOS
• 自定义控制栏支持播放/暂停、进度条拖动、倍速、全屏、标题栏、返回/更多按钮
• 提供 createVideoContext 基础控制能力，支持播放、暂停、倍速与全屏控制
• 完善 README、示例页和插件市场元数据
• 首发售价为普通授权 99 元、源码授权 399 元

平台兼容性

uni-app(4.87)

鸿蒙原生视频播放器（gy-video-player）

适用于 uni-app 的 HarmonyOS 原生视频播放器插件，首发版聚焦 6 个核心能力：

• 播放 / 暂停
• 全屏切换
• 倍速切换
• 进度条拖动
• 顶部标题栏
• 返回 / 更多按钮事件

支持平台

版本说明

• 普通授权版：99 元
• 源码授权版：399 元
• 两个版本的运行能力一致，差异只在于是否提供源码及二次开发权限

安装方式

在 HBuilderX 中将插件导入到项目的 uni_modules 目录。

基本用法

<template>
  <gy-video-player
    video-id="demo-player"
    :src="videoSrc"
    :autoplay="true"
    :controls="false"
    title="鸿蒙演示视频"
    :show-back-btn="true"
    :show-more-btn="true"
    @back="onBack"
    @more="onMore"
    @play="onPlay"
    @pause="onPause"
    @fullscreenchange=""
    @error="onError"
  />
</template>

<script>
import { createVideoContext } from '@/uni_modules/gy-video-player'

export default {
  data() {
    return {
      videoSrc: 'https://example.com/demo.m3u8',
      playerContext: null
    }
  },
  mounted() {
    this.playerContext = createVideoContext('demo-player')
  },
  methods: {
    onPlay() {
      console.log('开始播放')
    },
    onPause() {
      console.log('暂停播放')
    },
    (e) {
      console.log('全屏状态', e.fullScreen)
    },
    onBack() {
      uni.navigateBack()
    },
    onMore() {
      uni.showToast({ title: '更多操作预留', icon: 'none' })
    },
    onError(e) {
      console.log('播放失败', e.errMsg)
    }
  }
}
</script>

组件属性

事件

state 取值：idle / prepared / playing / paused / finished / error

createVideoContext

import { createVideoContext } from '@/uni_modules/gy-video-player'

const ctx = createVideoContext('demo-player')
ctx.play()
ctx.pause()
ctx.playbackRate(2.0)
ctx.requestFullScreen()
ctx.exitFullScreen()

方法列表

当前版本说明

• 首发版故意保持轻量，保留播放、倍速、全屏、进度条拖动和顶部栏等高频能力。
• 当前版本不包含双击切换播放、手势快进等复杂交互。
• 插件默认使用自定义轻量控制栏；若设置 controls 为 true，将使用系统原生控件。
• 请通过插件根目录 @/uni_modules/gy-video-player 导入，不要直接引用内部文件。