更新记录
1.0.0(2023-12-20) 下载此版本
- 新增登录直播间、直播推流相关功能
- 新增支持聊天、打赏消息、商品信息的展示
- 新增支持横竖屏旋转、前后摄像头切换、美颜开关功能
- 新增支持调整帧率、码率、分辨率配置
- 新增支持选择推流节点
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 13.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:11 - 17 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在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原生插件配置”->”云端插件“列表中删除该插件重新选择
获得场景视频云直播推流插件使用说明
本插件提供跳转原生云直播推流页面的功能(基于获得场景视频云直播 推流demo 2.7.0 版本)
插件ID:Bokecc-CcLivePushUniPlugin
开发环境:HBuilder 3.8.7及以上,Android系统 5.0及以上
在manifest.json的配置中勾选插件所需要权限:
<!--云直播推流SDK需要权限-->
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<!-- =================CC Push SDK 权限========================== -->
<!-- 视频采集使用-->
<uses-permission android:name="android.permission.CAMERA" />
<!-- 二维码扫描震动提醒-->
<uses-permission android:name="android.permission.VIBRATE" />
<!-- 音频采集使用-->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- 视频采集界面保持屏幕常亮-->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!--手电筒-->
<uses-permission android:name="android.permission.FLASHLIGHT" />
<!-- 允许程序全局修改音频-->
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<!-- ===============================读写============================ -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
开发环境:HBuilder 3.8.7及以上,iOS系统 11.0及以上
在manifest.json的配置中勾选插件所需要权限:
/* ios打包配置 */
"ios" : {
"dSYMs" : false,
"privacyDescription" : {
"NSCameraUsageDescription" : "\"1\"",
"NSMicrophoneUsageDescription" : "\"1\"",
}
},
Plugin提供的API
API | 描述 | 备注 |
---|---|---|
loginLivePush(JSONObject options,UniJSCallback callback) | 登录直播页面 | options需包含参数:roomId、accountId、userName、password |
使用方式
-
引入插件
插件市场搜索:获得场景视频云直播推流插件
1.1 离线集成
下载离线包于uniapp项目nativeplugins目录下,打开manifest.json文件,选择App原生插件配置,选择本地插件,选中Bokecc-CcLivePushUniPlugin插件。
1.2 云端引用
将插件绑定至自己的DCloud账号,打开manifest.json文件,选择App原生插件配置,选择云端插件,选中Bokecc-CcLivePushUniPlugin插件。
-
示例代码
var ccLiveUniPlugin = uni.requireNativePlugin("Bokecc-CcLivePushUniPlugin") 登录直播推流页面: ccLiveUniPlugin.loginLivePush({ '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" }) })
FAQ
-
云打包报错,提示包冲突问题
目前SDK包含一些三方模块,其他的原生插件也可能包含这些模块,所以当产生冲突时,需要反馈客服并提供相关冲突报错信息。
-
云打包正常,执行插件方法报异常
检查插件ID是否正确
-
插件列表没有当前插件
需要检查D-Cloud账号是否绑定插件
-
业务界面UI支持修改么
由于当前插件基于原生Demo并面向aPaas(应用程序平台即服务),故不支持业务界面的UI修改
相关文档链接
获得场景视频云直播相关文档:https://doc.bokecc.com/live/
Uniapp原生插件开发教程:https://nativesupport.dcloud.net.cn/NativePlugin/course/android