更新记录

0.1.0(2021-05-14)

changed

  • 【Android】修复同时集成云点播、VideoPlayer、Payment插件的云打包兼容问题
  • 【Android】0.1.0起集成此插件必须同时集成Polyv播放器插件-Android
  • 新增 setMarqueeConfig 方法,支持响应后台自定义跑马灯设置;

0.0.3(2021-01-26)

-【Android】修复HBuilderx3.0+云打包无法正常拉取Httpdns库的问题

查看更多

平台兼容性

Android iOS
适用版本区间:5.0 - 11.0 支持CPU类型:armeabi-v7a,arm64-v8a,x86 ×

原生插件通用使用流程:

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


该插件封装了保利威 Android 与 iOS 原生云课堂 Demo SDK。使用本模块可以轻松把保利威 Android 与 iOS 云课堂功能集成到自己的 app 中,实现保利威视频教学直播、ppt 在线演示同步播放、教学连麦、在线聊天功能,以及直播回放功能。想要集成本插件,需要在保利威视频云平台注册账号,并开通相关服务。

注意事项

  • 请务必通过 ConfigModule 的 setViewerInfo 设置观众ID,观众ID是后台区分用户的唯一标识别。
  • iOS端不支持云打包,需要移步到 uniapp-cloudclass-ios 离线插件工程,进行离线打包。
  • Android端自v0.1.0+已经解决云打包与uni-app官方原生插件VideoPlayer(视频播放)Payment(支付)产生依赖冲突导致云打包失败的问题,旧版本可以仍旧解决方案请点击文档说明:《Android Uni app 插件冲突解决指南》
  • Android端自v0.1.0+起,需要同时集成Polyv播放器插件-Android。此外若不同时集成VideoPlayer,则还需要集成Polyv弹幕库插件-Android

快速使用

下面代码中展示了模块的基本使用,更多方法请查看下方的相关模块说明。

    var playModule = uni.requireNativePlugin("PLV-CloudUniPlugin-PlayModule")
    var configModule = uni.requireNativePlugin("PLV-CloudUniPlugin-ConfigModule")

//初始化,需要在保利威官网注册账号。详情查看setConfig说明。
configModule.setConfig({
    your appId,
    your userId,
    your appSecret
}, (result) => {
    uni.showToast({
        title:result.isSuccess ? "setConfig succeed" : result.errMsg,
        icon: "none"
    })
})

//设置观看用户信息
configModule.setViewerInfo({
    your viewerId,
    your viewerName,
    your viewerAvatar,
    custom param4,
    custom param5
}, (result) => {
    uni.showToast({
        title:result.isSuccess ? "setViewerInfo succeed" : result.errMsg,
        icon: "none"
    })
});

//进入直播
playModule.startLive({
    live channelId,
}, (result) => {
    uni.showToast({
        title:result.isSuccess ? "startLive succeed" : result.errMsg,
        icon: "none"
    })
})

配置模块 - PLV-CloudUniPlugin-ConfigModule

ConfigModule 封装了账号信息、用户信息配置功能。 开发者要播放保利威视频,需先到 保利威官网 注册账号,登录账号后,进入云直播 - 开发设置 获取 userIdAppIDAppSecret,并将加密得到加密串放到自己的服务器,再在移动端通过网络获取加密串,app 本地解密,并设置给 setConfig 方法。

setConfig

配置信息可在保利威官网的云直播 - 开发设置获取,建议开发者在服务器二次加密后,在本地解密配置。

params

userId

  • 类型:字符串
  • 描述:(必选项)账号ID

appId

  • 类型:字符串
  • 描述:(必选项)应用ID

appSecret

  • 类型:字符串
  • 描述:(必选项)应用密匙

callback

isSuccess

  • 类型:布尔类型
  • 描述:是否设置成功

errMsg

  • 类型:字符串
  • 描述:错误信息

setViewerInfo

设置观众信息。

params

viewerId

  • 类型:字符串
  • 描述:(必选项)对应观看日志中的 用户ID

viewerName

  • 类型:字符串
  • 描述:(必选项)对应观看日志中的 用户昵称

viewerAvatar

  • 类型:字符串
  • 描述:(可选项)观看用户的头像

param4

  • 类型:字符串
  • 描述:(可选项)自定义统计参数,对应观看日志中的 param4

param5

  • 类型:字符串
  • 描述:(可选项)自定义统计参数,对应观看日志中的 param5

callback

isSuccess

  • 类型:布尔类型
  • 描述:是否设置成功

errMsg

  • 类型:字符串
  • 描述:错误信息

setMarqueeConfig

设置跑马灯配置。该配置将会支持响应后台配置的防录屏跑马灯

params

code

  • 类型:字符串
  • 描述:(必选项)当设置自定义跑马灯后,开发者定义的code字段,该字段将用于校验,需与后台定义的一致。更多请查看文档《URL自定义跑马灯》

callback

isSuccess

  • 类型:布尔类型
  • 描述:是否设置成功

errMsg

  • 类型:字符串
  • 描述:错误信息

播放模块 - PLV-CloudUniPlugin-PlayModule

ConfigModule 封装了跳转到直播或者回放的功能。支持三分屏、普通直播。

startLive

跳转到直播间。

params

channelId

  • 类型:字符串
  • 描述:(必选项)频道号

callback

isSuccess

  • 类型:布尔类型
  • 描述:是否设置成功

errMsg

  • 类型:字符串
  • 描述:错误信息

startPlayback

跳转到回放。

params

channelId

  • 类型:字符串
  • 描述:(必选项)频道号

videoId

  • 类型:字符串
  • 描述:(必选项)回放视频videoId

videoType

  • 类型:布尔类型
  • 描述:(可选项)是否是点播列表视频。默认为false

callback

isSuccess

  • 类型:布尔类型
  • 描述:是否设置成功

errMsg

  • 类型:字符串
  • 描述:错误信息

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.CAMERA"/> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> <uses-permission android:name="android.permission.GET_TASKS"/> <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> <uses-permission android:name="android.permission.RECORD_AUDIO"/> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

本插件采集用户ID、视频ID、播放时长等直播视频播放的基础数据,发送服务器地址为:https://prtas.videocc.net/。 采集的数据用于向客户提供观众的播放情况统计。 隐私政策:https://s2.videocc.net/app-simple-pages/privacy-policy/index.html

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

请参考开源项目地址的开源协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问