更新记录
1.0.2(2026-11-20)
- 增加截图
- 增加直播
1.0.0(2026-11-18)
- 点播
平台兼容性
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
集成步骤
- 插件详细集成步骤可以参考https://www.jianshu.com/p/c1615a7880a7
- 拷贝demo里的Info.plist、AndroidManifest.xml文件到项目根目录
- 本页面右上角可以点击"使用HBuilderX导入示例项目"下载demo,导入demo的时候选vue3,插件支持vue2和vue3
- 如需定制或增加功能请点击插件标题下方的"进入交流群"私聊作者
接口
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;
}
}

收藏人数:
购买源码授权版(
试用
使用 HBuilderX 导入示例项目
赞赏(0)
下载 518
赞赏 0
下载 12777683
赞赏 1960
赞赏
京公网安备:11010802035340号