更新记录

1.0.2(2026-11-20)

  1. 增加截图
  2. 增加直播

1.0.0(2026-11-18)

  1. 点播

平台兼容性

uni-app(3.8.11)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ - - √ √ 5.0 √ √
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

uni-app x(3.8.11)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - 5.0 √ - -

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
√ √ √ ×

腾讯云视立方超级播放器,直播、点播

功能介绍

  • 点播(MP4、MP3、HLS、DASH(DASH 仅高级版支持)等),支持自定义UI
  • 直播(RTMP、FLV、HLS(m3u8) 和 WebRTC 等),支持自定义UI

集成步骤

  1. 插件详细集成步骤可以参考https://www.jianshu.com/p/c1615a7880a7
  2. 拷贝demo里的Info.plist、AndroidManifest.xml文件到项目根目录
  3. 本页面右上角可以点击"使用HBuilderX导入示例项目"下载demo,导入demo的时候选vue3,插件支持vue2和vue3
  4. 如需定制或增加功能请点击插件标题下方的"进入交流群"私聊作者

接口


import * as superplayer from "@/uni_modules/wrs-uts-superplayer"

配置license

在腾讯云后台创建license

https://cloud.tencent.com/document/product/1449/56980#62e63074-0f32-4ac5-9799-65aaabd32ebd


superplayer.onObserver((resp)=>{
    let opt = resp.opt
    switch (opt) {
        case "onLicenceLoaded":
            {
                let result = resp.result
                if(result == 0) {
                    console.log("License 加载成功")
                } else {
                    console.log("License 加载失败:" + JSON.stringify(resp))
                }
            }
            break;

        default:
            break;
    }

})
const url = "xxx"
const key = "xxx"
superplayer.setLicense(url, key)

点播

页面要用nvue


<view class="player-wrap" :style="{width:width+'px',height:height+'px'}">
    <!-- #ifdef APP-HARMONY -->
    <embed tag="superplayer" :options="options" @onevent="onEvent"
        :style="{width:width+'px',height:height+'px'}"></embed>
    <!-- #endif -->
    <!-- #ifndef APP-HARMONY -->
    <wrs-uts-superplayer :params="params" :style="{width:width+'px',height:height+'px'}"
        @onEvent="onEvent"></wrs-uts-superplayer>
    <!-- #endif -->
</view>

总体采用业务组数的方式更新组件属性,会自动遍历执行业务

let params = {}
params.businessArray = [
    {
        business: "",
        params: {}
    }
]
let paramsStr = JSON.stringify(params)

绑定组件属性
params: paramsStr,
options: {
    params: paramsStr
},
  • 设置视频url

方式1:


let url = "https://vd3.bdstatic.com/mda-pdc2kmwtd2vxhiy4/cae_h264/1681502407203843413/mda-pdc2kmwtd2vxhiy4.mp4"

{
    business: "setUrl",
    params: {
        url: url,
        autoPlay: true
    }
}

方式2:


let url = "https://vd3.bdstatic.com/mda-pdc2kmwtd2vxhiy4/cae_h264/1681502407203843413/mda-pdc2kmwtd2vxhiy4.mp4"

{
    business: "setUrl",
    params: {
        appId: 22,
        fileId: "",
        pSign: "",
        autoPlay: true
    }
}
  • 设置视频画面填充方式(暂不支持鸿蒙)

{
    business: "setRenderFillMode",
    params: {
        mode: "fill" // fill、fit
    }
}
  • 暂停播放

{
    business: "pause"
}
  • 继续播放

{
    business: "resume"
}
  • 停止播放

{
    business: "stopPlay"
}
  • 快进到第几秒播放

{
    business: "seek",
    params: {
        time: 15 // 单位:秒
    }
}
  • 设置倍速

{
    business: "setRate",
    params: {
        rate: 1.5
    }
}
  • 设置是否循环播放

{
    business: "setLoop",
    params: {
        loop: true
    }
}
  • 设置是否静音

{
    business: "setMute",
    params: {
        mute: true
    }
}
  • 设置音量

{
    business: "setAudioPlayoutVolume",
    params: {
        volume: 50 // 0~100
    }
}
  • 设置码率

{
    business: "setBitrateIndex",
    params: {
        index: 1
    }
}
  • 选择轨道

{
    business: "selectTrack",
    params: {
        index: 1
    }
}
  • 取消选择轨道

{
    business: "deselectTrack",
    params: {
        index: 1
    }
}
  • 截图

截图结果在onEvent里的snapshot的opt里返回


{
    business: "snapshot",
    params: {
        filePath: "/xxx/xxx/xx.jpg", // 保存截图的本地绝对文件路径
        needBase64: false // 是否返回base64
    }
}
  • 组件事件

onEvent(e) {
    const detail = e.detail
    const opt = detail.opt
    switch (opt) {
        case "onPlayEvent": {
            // 更多code可以参考腾讯云官方文档里的"播放事件通知(onPlayEvent)" https://cloud.tencent.com/document/product/881/20216#13.E3.80.81.E6.92.AD.E6.94.BE.E8.BF.9B.E5.BA.A6.E7.9B.91.E5.90.AC
            const code = detail.code
            switch (code) {
                case 2013: {
                    console.log("detail:" + JSON.stringify(detail))
                }
                break;
                case 2004: {
                    this.isPlaying = true;
                    this.startHideTimer();
                }
                break;
                case 2006: {
                    this.isPlaying = false;
                    this.showControls = true;
                    this.clearHideTimer();
                }
                break;
                case 2005: {
                    console.log("detail:" + JSON.stringify(detail))
                    if (detail.current !== undefined) {
                        this.currentProgress = this.nativeProgressInMs ? detail.current : detail.current *
                            1000;
                    }
                    if (detail.duration && detail.duration > 0) {
                        this.totalDuration = this.nativeProgressInMs ? detail.duration : detail.duration *
                            1000;
                    }
                }
                break;
                default:
                    break;
            }

        }
        break;
        case "snapshot": {
            if (detail.filePath) {
                this.imageSrc = "file://" + detail.filePath
            }
        }
        break;
    }
}

直播

页面要用nvue


        <!--  #ifdef  APP-HARMONY -->
<embed tag="superplayerlive" :options="options" @onevent="onEvent"
    :style="'width:' + width + 'px; height:' + height + 'px;'"></embed>
<!--  #endif -->
<!--  #ifndef  APP-HARMONY -->
<wrs-uts-superplayerlive :params="params" :style="'width:'+width+'px;height:'+height+'px;'"
    @onEvent="onEvent"></wrs-uts-superplayerlive>
<!--  #endif -->

总体采用业务组数的方式更新组件属性,会自动遍历执行业务

let params = {}
params.businessArray = [
    {
        business: "",
        params: {}
    }
]
let paramsStr = JSON.stringify(params)

绑定组件属性
params: paramsStr,
options: {
    params: paramsStr
},
  • 设置url

let url = "webrtc://liteavapp.qcloud.com/live/liteavdemoplayerstreamid?tabr_bitrates=demo1080p,demo720p,demo480p&tabr_start_bitrate=demo1080p"
let newParams = {
    businessArray: [{
        business: "setUrl",
        params: {
            url: url
        }
    }]
}
let newParamsStr = this.formatNewParams(newParams)
this.params = newParamsStr
this.options = {
    params: newParamsStr
}
  • 设置视频画面填充方式

let model = array[index]
let newParams = {
    businessArray: [{
        business: "setRenderFillMode",
        params: {
            mode: "fill" // fill、fit、scaleFill
        }
    }]
}
let newParamsStr = this.formatNewParams(newParams)
this.params = newParamsStr
this.options = {
    params: newParamsStr
}
  • 截图 截图结果在onEvent的snapshot的opt里返回

let dir = superplayer.getFileDir()
let name = new Date().getTime()
let filePath = `${dir}/${name}.jpg`
let newParams = {
    businessArray: [{
        business: "snapshot",
        params: {
            filePath: filePath,
            needBase64: false
        }
    }]
}
let newParamsStr = this.formatNewParams(newParams)
this.params = newParamsStr
this.options = {
    params: newParamsStr
}
  • 事件

onEvent(e) {
    let detail = e.detail
    let opt = detail.opt
    if (opt !== "onStatisticsUpdate") {
        this.showMsg("onEvent :" + JSON.stringify(e))
    }
    switch (opt) {
        case "snapshot": {
            let filePath = detail.filePath
            if (filePath) {
                this.imageSrc = "file://" + filePath
            } else {
                this.showMsg("截图失败:" + JSON.stringify(detail))
            }
        }
        break;
        case "onError": {
            this.showMsg("播放失败:" + JSON.stringify(detail))
        }
        break;
        case "onWarning": {
            // 告警
        }
        break;
        case "onVideoResolutionChanged": {

        }
        break;
        case "onConnected": {

        }
        break;
        case "onVideoPlaying": {

        }
        break;
        case "onAudioPlaying": {

        }
        break;
        case "onVideoLoading": {

        }
        break;
        case "onAudioLoading": {

        }
        break;
        case "onPlayoutVolumeUpdate": {

        }
        break;
        case "onStatisticsUpdate": {

        }
        break;
        case "onRenderVideoFrame": {

        }
        break;
        case "onPlayoutAudioFrame": {

        }
        break;
        case "onReceiveSeiMessage": {

        }
        break;
        case "onStreamSwitched": {

        }
        break;
        default:
            break;
    }
}

隐私、权限声明

1. 本插件需要申请的系统权限列表:

网络权限

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无