更新记录
0.0.2(2023-08-07) 下载此版本
升级 ios 插件基于云直播 4.x 版本,支持多人连麦功能
0.0.1(2023-08-03) 下载此版本
- 增加直播间登录功能
- 增加在线回放登录功能
- 增加离线回放播放功能
- 增加主次验证登录方式与防录屏开关
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 10.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:11 - 16 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
获得场景视频云直播插件使用说明
本插件提供跳转原生云直播页面的功能
插件ID:Bokecc-CcLiveUniPlugin
开发环境:HBuilder 3.5.3及以上,Android系统 5.0及以上
请在manifest.json的配置中勾选插件所需要权限:
<!-- 直播所需权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<!-- 连麦所需权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<!--蓝牙-->
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<!--监听电话状态-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
Plugin提供的API
API | 描述 | 备注 |
---|---|---|
loginLive(JSONObject options) | 登录直播页面 | options需包含参数:roomId、accountId、userName、password(无密码可传递空字符串),可选参数:viewerCustomUa、viewerCustomInfo、groupId 参数含义 |
loginReplay(JSONObject options) | 登录回放页面 | options需包含参数:roomId、accountId、recordId、userName、password(无密码可传递空字符串) |
enterLocalReplay(JSONObject options) | 进入离线回放页面 | options需包含参数:ccrPath(传递空字符串即可) |
使用方式
-
引入插件
插件市场搜索:获得场景视频云直播插件
1.1 离线集成
下载离线包于uniapp项目nativeplugins目录下,打开manifest.json文件,选择App原生插件配置,选择本地插件,选中Bokecc-CcLiveUniPlugin插件。
1.2 云端引用
将插件绑定至自己的DCloud账号,打开manifest.json文件,选择App原生插件配置,选择云端插件,选中Bokecc-CcLiveUniPlugin插件。
-
打开manifest.json,点击App模块配置,勾选VideoPlayer(视频播放)模块
-
示例代码
var ccLiveUniPlugin = uni.requireNativePlugin("Bokecc-CcLiveUniPlugin") 登录直播: ccLiveUniPlugin.loginLive({ 'roomId': this.roomId, 'accountId': this.accountId, 'userName': this.userName, 'password': this.password }, (ret) => { let data = JSON.parse(ret); uni.hideLoading(); uni.showToast({ title: data.msg, icon: "none" }) }) 登录回放: ccLiveUniPlugin.loginReplay({ 'roomId': this.roomId, 'accountId': this.accountId, 'recordId': this.recordId, 'userName': this.userName, 'password': this.password }, (ret) => { let data = JSON.parse(ret); uni.hideLoading(); uni.showToast({ title: data.msg, icon: "none" }) }) 进入离线回放: ccLiveUniPlugin.enterLocalReplay({ 'ccrPath': '' }, (ret) => { let data = JSON.parse(ret); })
FAQ
-
云打包报错,提示包冲突问题
目前SDK包含一些三方模块,不能保证其他厂商的原生插件也包含这些模块,所以当产生冲突时,需要反馈客服并提供相关冲突报错信息
-
云打包正常,执行插件方法报异常
检查插件ID是否正确
-
插件列表没有当前插件
需要检查D-Cloud账号是否绑定插件
-
业务界面UI支持修改么
由于插件基于原生Demo并面向aPaas(应用程序平台即服务),故不支持业务界面的UI修改
相关文档链接
获得场景视频云直播相关文档:https://doc.bokecc.com/live/
Uniapp原生插件开发教程:https://nativesupport.dcloud.net.cn/NativePlugin/course/android