更新记录

0.2.0（2026-04-27） 下载此版本

• 当前包正式调整为 鸿蒙原生视频播放器 Lite
• 组件名调整为 <gy-video-player-lite>
• Lite 版本保留播放/暂停、进度条拖动、倍速、全屏、标题栏和返回按钮
• Lite 版本继续移除更多按钮，聚焦免费试用体验
• 更新 README、示例页和市场文案，明确非商用试用与 Pro 升级路径

平台兼容性

uni-app(4.87)

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

适用于 uni-app Vue3 的 HarmonyOS 原生视频播放器 Lite 插件。

Lite 版本聚焦 6 个核心能力：

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

支持平台

Lite 定位

• 免费下载，插件市场下载前需观看广告解锁
• 仅供学习、评估和非商用试用
• 商用项目请购买 gy-video-player-pro
• Pro 当前主售源码授权版，源码授权价 599 元
• Lite 与 Pro 为两个独立插件包，组件名不同

安装方式

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

基本用法

<template>
  <gy-video-player-lite
    video-id="demo-player"
    :src="videoSrc"
    :autoplay="true"
    :controls="false"
    title="鸿蒙演示视频"
    :show-back-btn="true"
    @back="onBack"
    @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()
    },
    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()

方法列表

当前版本说明

• Lite 版故意保持轻量，适合作为 HarmonyOS 播放器的试用入口。
• 当前版本不包含更多按钮、双击切换播放、手势快进等复杂交互。
• 插件默认使用自定义轻量控制栏；若设置 controls 为 true，将使用系统原生控件。
• 请通过插件根目录 @/uni_modules/gy-video-player 导入，不要直接引用内部文件。
• 若需要完整功能版和完整源码，请购买 gy-video-player-pro 源码授权版，当前定价 599 元。