更新记录

1.0.0（2026-10-29）

首次更新

平台兼容性

uni-app(4.01)

uni-app x(4.42)

Tencent Super Player for uni-app

基于 testSdkDemo 中腾讯云官方播放器 SDK 封装的 uni-app UTS 兼容模式原生组件，供传统 uni-app Vue 3 项目的 App-Android / App-iOS nvue 页面使用。该插件直接依赖腾讯官方 SDK，不依赖插件市场的播放器成品。

依赖与运行

• Android：com.tencent.liteav:LiteAVSDK_Player:13.5.0.20670，最低 Android API 19。
• iOS：CocoaPods TXLiteAVSDK_Player:13.5.21355，最低 iOS 12。
• 使用 HBuilderX 云端打包或本地打包，并在原生依赖解析时保持网络可用。iOS 端需要 macOS、Xcode 和 CocoaPods 构建环境。
• 这是原生 UI 组件，只能在 App 的 nvue 页面中使用；不支持 H5、小程序、普通 .vue 页面或 App WebView 页面。

使用

UTS 组件在 uni-app 中默认全局注册。把组件放入 nvue 页，设置确定的宽高，然后通过 ref 调用公开方法：

<template>
  <view>
    <tencent-super-player
      ref="player"
      style="width: 100%; height: 220px;"
      @playerEvent="onPlayerEvent"
    />
    <button @tap="configure">初始化 License</button>
    <button @tap="play">播放</button>
  </view>
</template>

<script>
export default {
  methods: {
    configure() {
      this.$refs.player.configure('LICENSE_URL', 'LICENSE_KEY')
    },
    play() {
      this.$refs.player.play({
        sourceType: 'url',
        url: 'https://example.com/video.mp4'
      })
    },
    onPlayerEvent(event) {
      console.log(event)
    }
  }
}
</script>

FileId 点播：

this.$refs.player.play({
  sourceType: 'fileId',
  appId: 1250000000,
  fileId: 'your-file-id',
  pSign: '由可信业务服务端签发的播放器签名'
})

pSign 不是云 API 密钥，不要在客户端生成或放置 API Secret。License URL/Key 应由应用按自身配置安全管理，不要提交真实 License 到公共源码仓库。

API

• configure(licenseUrl, licenseKey)：设置腾讯播放器 License，播放前调用。
• play(options)：播放点播 URL 或 FileId。
• playLiveUrl(url)：播放直播 URL；RTMP/WebRTC 按 RTMP 类型启动，其他 URL 按 FLV 类型启动。项目启动页提供“直播”Tab。
• pause()、resume()、stop()：播放控制。
• destroy()：停止播放并释放播放器。组件卸载时会自动释放。
• playerEvent：原生播放器事件，事件对象包含 type、eventCode 和可用的 message；Android 还提供 progress、duration。常见 type 为 ready、ended、error、state。

迁移到其他项目

详细步骤见 MIGRATION.md。

复制整个 uni_modules/tencent-super-player 目录到目标 uni-app 项目的 uni_modules，然后使用 HBuilderX 导入/识别该本地 uni_modules 插件。保留 package.json、两端 config.json 与对应 index.vue，在目标应用的 nvue 页面按上述方式调用。不要只拷贝 UTS 源码而遗漏 Android Maven / iOS CocoaPods 依赖声明。目标应用需使用支持 UTS 兼容模式组件的 HBuilderX 版本，并按其 App 云打包或本地打包流程重新构建原生工程。

验证状态

HBuilderX CLI 的 iOS UTS 模块编译已通过。Android UTS 编译在解析腾讯类时受当前 HBuilderX 环境限制：该项目尚未配置本地运行环境/自定义基座，腾讯 Maven SDK 没有进入编译 classpath；需在配置运行环境或云端生成自定义基座后完成真机验证。Windows 无法完成 iOS 原生链接与设备验证，仍需在 macOS/Xcode 环境验证 CocoaPods 依赖和实际播放。