更新记录

1.6.0（2025-10-23） 下载此版本

新增：【插件】支持api方式获取下载列表、批量删除、ios支持控制下载进度回调频率 修复：【demo】安卓调整播放音量无法跟随系统

1.5.2（2025-04-03） 下载此版本

适配Xcode16

1.5.1（2025-03-31） 下载此版本

修复：IOS适配Xcode16打包

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

本插件为获得场景视频云点播原生插件，开发者可以通过在uni工程中集成本插件来制作原生应用程序。插件提供获得场景视频的播放、下载等功能。

插件组成

插件包含一个Component扩展、3个Module扩展

1. CCView 原生播放器UI组件
2. Bokecc-CcVodUniPlugin-CCDownload 下载组件
3. Bokecc-CcVodUniPlugin-CCProjection 投屏组件
4. Bokecc-CcVodUniPlugin-CCNetSpeedModule 网速组件

使用限制

1. 本插件只支持vue2,不支持vue3，uni工程Vue版本请确保是2
2. 本插件只支持播放已上传至获得场景admin后台的视频，插件内部通过视频的唯一id获取视频播放信息，不支持按视频地址进行播放
3. 本插件只可用来制作原生应用程序，如果要制作微信小程序、h5网页，请对接微信小程序插件 或 h5播放器 SDK

1.插件集成

对于第一次使用原生插件的开发者，需遵循上文的原生插件通用使用流程。这里给出使用图示。有原生插件使用经验的开发者可直接移步到2.快速开始

1 购买插件，选择该插件绑定的项目

2 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块

3 根据插件文档开发代码，在代码中引用插件，调用插件功能

4 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试

制作自定义基座

点击打包，成功后，控制台会有绿色的文字提示

运行

5 开发完毕后正式云打包

2.快速开始

基础播放器组件（CCView）

播放器组件为component类型，仅可在nvue页面中使用。为纯播放器视图，开发者可自行实现状态控制部分的样式，也可以下载示例工程复用示例的播放器实现。

页面添加播放器视图组件

播放器视图组件名称为 CCView，可以通过视频id播放获得场景视频

在nvue页面中添加如下代码：

<CCView 
        ref="CCView"
        class="cc-view"
        @onCCViewInit="onCCViewInit"
        @onPrepared="onPrepared"
        @onCompletion="onCompletion"
        @onBufferingUpdate="onBufferingUpdate"
        @onBufferingStart="onBufferingStart"
        @onBufferingEnd="onBufferingEnd"
        @onLog="onLog"
        @onPlayError="onPlayError"></CCView>

注意：CCView默认无尺寸，需要自行添加样式设置宽高!

设置播放信息(必要步骤)

CCView初始化成功之后，会触发视图初始化通知事件onCCViewInit，在onCCViewInit中需要调用设置播放信息API setVideoPlayInfo

methods: {
    onCCViewInit() {
       const options = {
           videoId: this.videoId, // 视频id
           userId: this.userId, // 用户id
           apiKey: this.apiKey // apiKey
       }
       this.$refs.CCView.setVideoPlayInfo(options);
    }
}

setVideoPlayInfo执行成功之后，会触发视频准备就绪事件onPrepared，此时视频已准备就绪，在onPrepared中调用开始播放等操作

API及回调通知的使用

在CCView组件上添加 ref="CCView", 即可通过this.$refs.CCView调用播放器丰富的API

例如开始播放视频

this.$refs.CCView.start();

在CCView组件上添加@xxx="xxx",即可定义回调事件，xxx为回调事件名称

例如自定义onPrepared视频准备就绪可播放回调

<template>
    <CCView @onPrepared="onPrepared"></CCView>
</template>

<script>
    // ...
    methods: {
        onPrepared() {
            console.log('视频准备就绪');
        }
    }
</script>

api详细说明请参考 3.API说明

视频下载组件

下载组件为独立的module类型, 需要在 App.vue中引入，并在onLaunch时初始化

使用下载组件

// APP.vue
const CCDownload = uni.requireNativePlugin('HD-CCView-CCDownload');

// 初始化
onLaunch: function () {
    const { platform } = uni.getSystemInfoSync();
    if (platform === 'android') {
        CCDownload.init({
            userId: this.userId,
            apiKey: this.apiKey
        });
    } else {
        CCDownload.initDownloadManager();
    }
}

开始下载

Downloader.start(params); // 参数格式见下方API说明

监听下载状态更新

const globalEvent = uni.requireNativePlugin('globalEvent');
// ios监听下载进度更新
globalEvent.addEventListener('downloadProgressUpdate', (e) => {}
// android监听下载进度
更新globalEvent.addEventListener('onUpdate', (e) => {}
// android、ios监听下载完成
globalEvent.addEventListener('onDownloadFinish', (e) => {}

投屏组件

投屏为独立的module类型, 需要在 App.vue中引入，并在onLaunch时初始化

使用投屏组件

// APP.vue
const CCProjection = uni.requireNativePlugin('HD-CCView-CCProjection');

//初始化
onLaunch: function () {
    CCProjection.initProjectionScreen();
}

监听可用投屏设备

const globalEvent = uni.requireNativePlugin('globalEvent');
globalEvent.addEventListener('onDevice', (e) => {})

开始投屏

Projection.startPush(params); // 参数格式见下方API说明

实时网速组件

实时网速组件为独立的module类型，需要在App.vue中引入, 并在onLaunch时初始化

使用实时网速组件

// APP.vue
const CCNetSpeedModule = uni.requireNativePlugin('HD-CCView-CCNetSpeedModule');
// 初始化并开启网络检测
onLaunch: function () {
    if (ios) {
        CCNetSpeedModule.initInternetSpeed();
        CCNetSpeedModule.speedStart();
    }
    if (android) {
        CCNetSpeedModule.getNetSpeed();
    }
}

监听实时网速

const globalEvent = uni.requireNativePlugin('globalEvent');
globalEvent.addEventListener('onNetSpeed', (e) => {})

3.API说明

基础播放器

1.设置播放信息

this.$refs.CCView.setVideoPlayInfo(JsonObject json,UniJSCallback callback)

1.作用

初始化播放信息

2.注意

无

3.参数

4. apiKey模式与sid模式说明 如果开发者对接了SDKSID接口验证，则参数apiKey可置空，但在调用setVideoPlayInfo之前需调用setSdkSid去设置sid

2. 设置sid

this.$refs.CCView.setSdkSid(sid)

1.作用

   设置sid

2.注意

   setVideoPlayInfo参数传递apiKey的话，则无需调用该api
   sid的获取请参考SDKSID接口验证文档: https://doc.bokecc.com/vod/developer/base/sdksid/sdksid.html

3.开始播放

this.$refs.CCView.start()

1.作用

开始播放

2.注意

如果设置了自动播放无需调用

3.参数

4.暂停

this.$refs.CCView.pause()

1.作用

暂停播放

2.注意

3.参数

5.停止

this.$refs.CCView.stop()

1.作用

停止播放

2.注意

3.参数

6.释放资源

this.$refs.CCView.destroy()

1.作用

释放所有播放资源

2.注意

3.参数

7.获取播放总时长

this.$refs.CCView.getDuration(UniJSCallBack callback)

1.作用

 获取当前视频的总长度，单位：秒

2.注意

 需要在onPrepared触发后调用

3.参数

8.获取当前进度

this.$refs.CCView.getCurrentPosition(UniJSCallBack callback)

1.作用

 获取当前播放的进度，单位：秒

2.注意

 需要在onPrepared触发后调用

3.参数

9.跳转

this.$refs.CCView.seekTo(long msec)

1.作用

跳转到某一位置

2.注意

​

3.参数

10.自动播放

this.$refs.CCView.setAutoPlay(boolean autoPlay)

1.作用

设置自动播放

2.注意

​

3.参数

11.获取自动播放状态

this.$refs.CCView.isAutoPlay(UniJSCallBack callback)

1.作用

 获取自动播放

2.注意

3.参数

12. 获取清晰度列表

this.$refs.CCView.getDefinitions(callback)

1.作用

 获取清晰度列表

2.注意

需在onPrepared触发后调用

3.参数

13.设置清晰度

this.$refs.CCView.setDefinition(JSonObject jsonObject)

1.作用

设置清晰度

2.注意

3.参数

14.获取清晰度

this.$refs.CCView.getDefinition(UniJSCallBack callback)

1.作用

获取清晰度

2.注意

3.参数

15.设置倍速

this.$refs.CCView.setSpeed(float speed)

1.作用

设置倍速

2.注意

3.参数

16.获取标题

this.$refs.CCView.getVideoTitle(UniJSCallBack callback)

1.作用

获取标题

2.注意 需在onPrepared触发后调用 ​ 3.参数

17.获取流媒体类型

this.$refs.CCView.getMediaType(UniJSCallBack callback)

1.作用

获取媒体类型

2.注意

3.参数

18. 截图

this.$refs.CCView.getScreenShot()

1.作用

视频截图

2.注意

3.参数

19. 音视频切换

// 安卓
this.$refs.CCView.playModelChanged(this.isVideoMode)
// ios
this.$refs.CCView.changeMedia(this.isVideoMode ? this.iosPlayModeData.radios[0] : this.iosPlayModeData.videos[0])

1.作用

切换音频或视频播放

2.注意

1 前提
需要先获取当前视频是否支持音频播放
安卓通过回调onPlayMode获取
ios通过 this.$refs.CCView.getVideoData(callback); 获取
2 参数
安卓传入参数true表示 切换到音频播放 ，false 表示切换到视频播放
ios传入上一步获取的音频列表的第一项，切换到音频播放，传入上一步获取的视频列表的第一项，切换到视频播放

3.参数

20. 弹幕初始化（ios）

this.$refs.CCView.barrageInit();

1.作用

初始化弹幕功能

2.注意

1. 仅ios需要调用
2. 在onPrepared中调用

3.参数

21. 设置弹幕视频id （ios）

this.$refs.CCView.setBarrageVideoId(id);

1.作用

设置弹幕视频id

2.注意

1. 仅ios需要调用
2. 在onPrepared中调用

3.参数

22. 发送弹幕

this.$refs.CCView.sendBarrageWithBarrage(params);

1.作用

发送弹幕

2.注意

3.参数

23. 获取知识点数据 （ios）

this.$refs.CCView.getKnowledgeData(params, callback)

1.作用

获取知识点数据列表

2.注意

仅ios需要调用

3.参数

24. 获取音视频数据 （ios）

this.$refs.CCView.getVideoData(callback);

1.作用

停止播放

2.注意

仅ios需要调用
返回数据调用 this.$refs.CCView.playModelChanged的时候作为参数用到

3.参数

25. 获取视频地址

this.$refs.CCView.getPlayUrl(callback)

1.作用

获取视频地址

2.注意

调用投屏api时会作为参数用到

3.参数

26. 获取视频尺寸（安卓）

this.$refs.CCView.getVideoSize(callback)

1.作用

  安卓获取视频画面尺寸

2.注意

安卓需要调用该api获取视频宽高，用来自行实现视频的铺满或自适应，ios有提供api: this.$refs.CCView.changeAspectType() 自适应；this.$refs.CCView.changeFillType() 铺满

3.参数

27. 视频切换至铺满默认（ios）

this.$refs.CCView.changeFillType()

1.作用

  视频画面切换到铺满容器

2.注意

  仅ios生效

28. 视频切换至自适应默认（ios）

this.$refs.CCView.changeAspectType()

1.作用

  视频画面切换到适应容器

2.注意

  仅ios生效

29. 播放已下载视频

this.$refs.CCView.playLocalVideo(JsonObject json);

1. 作用 播放已缓存（下载）的视频资源
2. 注意 ios传入参数为下载进度返回数据外***ideoTitle、definition
3. 参数

30. 获取视频信息

this.$refs.CCView.getVideoInfo(callback)

1.作用

获取视频信息（默认清晰度等）

2.注意

3.参数

31. 指定视频播放清晰度

this.$refs.CCView.setVideoQuality(quality)

1.作用

设置播放清晰度

2.注意

在setVideoPlayInfo前调用，设置播放清晰度

3.参数

32. 切换备用线路

this.$refs.CCView.switchSparLine();

1. 作用

   视频播放由主线路切换至备用线路

2. 注意

   只可由主线路单向切至备用线路

3. 参数 无

33. 回调说明

下载组件

1. 初始化下载组件

// 安卓
CCDownload.init(JsonObject);
// ios
CCDownload.initDownloadManager();

1.作用

初始化下载组件

2.注意

App全局调用一次

3.参数

4. apiKey模式与sid模式说明 如果开发者对接了SDKSID接口验证，则参数apiKey可置空，但在调用init/initDownloadManager之前需调用setSdkSid去设置sid

2. 设置sid

// ios
CCDownload.setSdkSid(sid)
// android
CCDownload.setSdkSid(uid, sid)

1.作用

   设置sid

2.注意

   init/initDownloadManager参数传递apiKey的话，则无需调用该api
   sid的获取请参考SDKSID接口验证文档:https://doc.bokecc.com/vod/developer/base/sdksid/sdksid.html

3.参数

3. 获取下载好的视频路径（安卓）

CCDownload.getFilePath();

1.作用 告诉安卓端下载好的视频的路径, 目的是在APP在断网情况下，缓存视频可以正常播放 2.注意 调用时机：在CCDownload.init之前调用

4. 开始下载

CCDownload.startWithDownload(JsonArray | JsonObj);

1.作用

开始下载

2.注意

安卓、ios参数格式有差异

3.参数

5. 暂停下载

CCDownload.setDownloadPause(JsonArray | JsonObj)

1. 作用

   暂停下载

2. 注意

   1 安卓、ios参数格式有差异
   2 ios的参数是 downloadProgressUpdate的返回值原样传入

3. 参数

6. 暂停全部下载

CCDownload.suspendAllDownloadModel()

1.作用

暂停全部下载中视频

2.注意

7. 恢复下载

CCDownload.setDownloadResume(params)

1.作用

恢复下载

2.注意

8. 恢复全部下载

// ios
CCDownload.setDownloadResumeAll()
// android
CCDownload.resumeAllDownloadModel()

1.作用

  所有暂停下载视频恢复下载

2.注意

9. 删除

CCDownload.setDownloadDelete(params);

1.作用

安卓：删除正在下载或暂停下载（除了下载完成）的视频
ios：删除所有状态的视频

2.注意

10. 删除已下载视频（安卓）

CCDownload.setDownloadFinishedDelete(params);

1.作用

删除已下载视频

2.注意

1. 仅安卓
2. 参数格式与删除下载中、暂停中视频有差异

11. 主动更新进度

CCDownload.update();

1.作用

触发进度更新回调 globalEvent onUpdate（安卓） / downloadProgressUpdate (ios)

2.注意

1. 需要定时调用该方法，才能触发进度更新通知

3.参数

12. 获取下载中列表

CCDownload.getDownloadList(callback)

1.作用

获取下载中列表数据

2.注意

3.参数

13. 获取已下载列表

CCDownload.getFinishDownloadList(callback)

1.作用

获取已下载列表数据

2.注意

3.参数

14. 暂停所有下载中视频

CCDownload.pauseAll()

1. 作用

   暂停所有下载中视频

2. 注意

15. 恢复所有暂停中视频

// ios
CCDownload.setDownloadResumeAll()
// 安卓
CCDownload.resumeAllDownloadModel()

1. 作用

   恢复所有暂停中视频

2. 注意

16. 删除全部正在下载视频

// ios
CCDownload.deleteAllDownloading()
// 安卓
CCDownload.deleteAllDownloadingModel()

1. 作用

   删除全部正在下载视频

2. 注意

17. 删除全部已下载视频

CCDownload.deleteAllDownloadModel()

1. 作用

   删除全部已下载视频

2. 注意

18. globalEvent说明

投屏组件

1. 初始化

CCProjection.initProjectionScreen();

1.作用

投屏组件初始化

2.注意

1. 全局执行一次

3.参数

2. 获取当前连接wifi名称

CCProjection.getConnectWifiName(callback)

1.作用

获取当前连接wifi的名称

2.注意

3.参数

3. 刷新设备列表

CCProjection.projectionScreenRefresh()

1.作用

刷新当前可用设备列表

2.注意

3.参数

4. 开始投屏

CCProjection.startPush(params);

1.作用

开始投屏

2.注意

1. 安卓、ios参数有差异
2. 加密视频安卓不支持投屏播放、ios可提示使用airplay播放（加密视频格式为.pcm）

3.参数

5.投屏暂停

CCProjection.pause();

1.作用

暂停投屏中的视频播放

2.注意

3.参数

6. 投屏恢复

CCProjection.resume();

1.作用

恢复投屏中的视频播放

2.注意

3.参数

7. 结束投屏

CCProjection.stopPush();

1.作用

退出投屏

2.注意

3.参数

8. 设置音量

CCProjection.setVolume(volume);

1.作用

设置投屏音量

2.注意

3.参数

9. 进度跳转

CCProjection.seek(position);

1.作用

投屏视频进度跳转

2.注意

3.参数

10. globalEvent说明

实时网速组件

1. 初始化（ios）

CCNetSpeedModule.initInternetSpeed();

1.作用

组件初始化

2.注意

1. 全局执行一次

3.参数

2. 开始检测网速 （ios）

CCNetSpeedModule.speedStart();

1.作用

开始检测网速

2.注意

3.参数

3. 停止检测网速 （ios）

CCNetSpeedModule.speedEnd();

1.作用

停止检测网速

2.注意

3.参数

4. 获取实时网速 （安卓）

CCNetSpeedModule.getNetSpeed();

1.作用

获取实时网速，触发安卓端 的globalEvent onNetSpeed

2.注意

1. 需要定时调用该方法，才能触发安卓的网速更新通知

3.参数

5. GlobalEvent说明

4.版本说明