更新记录

1.4.3（2024-09-19） 下载此版本

修复:【插件】安卓偶现视频播放到中间卡住或者从头开始播放 修复：【插件】安卓onPlayError无错误信息返回

1.4.2（2024-08-16） 下载此版本

修复：【插件】ios开启手势返回上一页，播放中播放器无法销毁

1.4.1（2024-06-05） 下载此版本

【修复】视频下载中杀掉app视频无法继续下载

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

[TOC]

1.版本说明

2.快速开始

基础播放器

播放器插件为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默认无尺寸，需要自行添加样式设置宽高

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>

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

在视图初始化通知事件onCCViewInit中调用设置播放信息API

methods: {
    onCCViewInit() {
       const options = {
           videoId: this.videoId,
           userId: this.userId,
           apiKey: this.apiKey
       }
       this.$refs.CCView.setVideoPlayInfo(options);
    }
}

视频下载

下载插件为独立的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监听下载完成
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.设置播放信息

setVideoPlayInfo(JsonObject json,UniJSCallback callback)

1.作用

初始化播放信息

2.注意

无

3.参数

2.开始播放

start()

1.作用

开始播放

2.注意

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

3.参数

3.暂停

pause()

1.作用

暂停播放

2.注意

​

3.参数

4.停止

stop()

1.作用

停止播放

2.注意

​

3.参数

5.释放资源

destroy()

1.作用

释放所有播放资源

2.注意

​

3.参数

6.获取播放总时长

getDuration(UniJSCallBack callback)

1.作用

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

2.注意

​

3.参数

7.获取当前进度

getCurrentPosition(UniJSCallBack callback)

1.作用

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

2.注意

​

3.参数

8.跳转

seekTo(long msec)

1.作用

跳转到某一位置

2.注意

​

3.参数

9.自动播放

setAutoPlay(boolean autoPlay)

1.作用

设置自动播放

2.注意

​

3.参数

10.获取自动播放状态

isAutoPlay(UniJSCallBack callback)

1.作用

获取自动播放

2.注意

​

3.参数

11.设置清晰度

setDefinition(JSonObject jsonObject)

1.作用

设置清晰度

2.注意

​

3.参数

12.获取清晰度

getDefinition(UniJSCallBack callback)

1.作用

获取清晰度

2.注意

​

3.参数

13.设置倍速

setSpeed(float speed)

1.作用

设置倍速

2.注意

​

3.参数

14.获取标题

getVideoTitle(UniJSCallBack callback)

1.作用

获取标题

2.注意

​

3.参数

15.获取流媒体类型

getMediaType(UniJSCallBack callback)

1.作用

获取媒体类型

2.注意

​

3.参数

16 截图

getScreenShot()

1.作用

视频截图

2.注意

​

3.参数

17 音视频切换

// 安卓
this.$refs.CCView.playModelChanged(this.isVideoMode)
// ios
this.$refs.CCView.playModelChanged(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.参数

18 弹幕初始化（ios）

this.$refs.CCView.barrageInit();

1.作用

初始化弹幕功能

2.注意

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

3.参数

19 设置弹幕视频id （ios）

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

1.作用

设置弹幕视频id

2.注意

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

3.参数

20. 发送弹幕

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

1.作用

发送弹幕

2.注意

3.参数

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

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

1.作用

获取知识点数据列表

2.注意

仅ios需要调用

3.参数

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

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

1.作用

停止播放

2.注意

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

3.参数

23. 获取视频地址

this.$refs.CCView.getPlayUrl(callback)

1.作用

获取视频地址

2.注意

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

3.参数

24. 获取视频信息

this.$refs.CCView.getVideoInfo(callback)

1.作用

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

2.注意

3.参数

25. 指定视频播放清晰度

this.$refs.CCView.setVideoQuality(quality)

1.作用

设置播放清晰度

2.注意

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

3.参数

26.回调说明

下载插件

1.初始化下载插件

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

1.作用

初始化下载插件

2.注意

App全局调用一次

3.参数

2.开始下载

CCDownload.startWithDownload(JsonArray | JsonObj);

1.作用

开始下载

2.注意

安卓、ios参数格式有差异

3.参数

3. 暂停下载

CCDownload.setDownloadPause(JsonArray | JsonObj)

1. 作用

   暂停下载

2. 注意

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

3. 参数

4. 恢复下载

CCDownload.setDownloadResume(params)

1.作用

恢复下载

2.注意

5. 删除

CCDownload.setDownloadDelete(params);

1.作用

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

2.注意

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

CCDownload.setDownloadFinishedDelete(params);

1.作用

删除已下载视频

2.注意

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

7. 主动更新进度 （安卓）

CCDownload.update();

1.作用

触发安卓端 的globalEvent onUpdate

2.注意

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

3.参数

8. 获取下载视频路径 （安卓）

CCDownload.getFilePath();

1.作用

告诉安卓端下载好的视频的路径

2.注意

在CCDownload.init前调用

9. 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说明