更新记录

1.0.0（2024-06-27）

Add

• 【Android/iOS】升级多场景SDK至1.17.1，支持开播端和观看端；

平台兼容性

原生插件通用使用流程：

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

Polyv云直播uni 插件

简介

该插件封装了保利威 Android 与 iOS 原生多场景 Demo SDK。使用本模块可以轻松把保利威 Android 与 iOS 多场景功能集成到自己的 App 中。目前主要集成了云课堂场景、直播带货场景、手机开播场景。

• 云课堂场景：

  实现保利威视频教学直播、ppt 在线演示同步播放、教学连麦、在线聊天功能，以及直播回放功能。

• 直播带货场景：

  实现视频直播、在线聊天、打赏、商品等功能，非常适合直播带货的应用场景。

• 手机开播场景：

  三分屏和纯视频开播推流、在线聊天、连麦、PPT文档和白板等功能，非常适合直播视频教学的应用场景。

快速使用

1. 注册账号，即可获取开发者配置参数。注册的时候，记得填写邀请人dcloud。

注册链接：https://my.polyv.net/v3/register/?sales=show&f=dcloud_uniapp

2. 获取参数。在注册完成后，登录后台，找到开发者信息，得到appId、userId、appSecret三个关键参数。（实际场景请务必进行加密处理）

技术支持

如有不明白的地方，建议扫码添加我们技术支持，协助接入和测试

技术支持	开发者

API说明

观看端

引入插件

var playModule = uni.requireNativePlugin("PLV-LiveUniPlugin-WatchPlayModule")
var configModule = uni.requireNativePlugin("PLV-LiveUniPlugin-WatchConfigModule")

配置模块 - ConfigModule

ConfigModule 封装了账号信息、用户信息、SDK配置功能。 开发者要播放保利威视频，需先到 保利威官网 注册账号，登录账号后，进入云直播 - 开发设置 获取 userId、 AppID、 AppSecret，并将加密得到加密串放到自己的服务器，再在移动端通过网络获取加密串，app 本地解密，并设置给 setConfig 方法。配置模块信息如果没有特殊说明都需要在进入直播间前配置。

1. setViewerInfo

配置直播间用户信息。（直播间用户的属性在初始化后不允许修改） 方法：setViewerInfo()

示例：

configModule.setViewerInfo({
    viewerId:"",
    viewerName: "",
    viewerAvatar: "",
}, (result) => {
})

参数：

2. setConfig

设置多场景的账号属性。为防止APP端被嗅探和反编译到开发者配置信息，强烈建议开发者设计自己的加密方式在服务端对 userId、 AppID、 AppSecret进行加密，并通过https协议的接口获取后重新解密，再将参数传递给SDK。 方法：setConfig()

示例：

configModule.setConfig({
    appId: "",
    userId: "",
    appSecret: ""
}, (result) => {
});

参数：

3. setMarqueeConfig

设置自定义跑马灯的配置属性 方法：setMarqueeConfig()

示例

configModule.setMarqueeConfig({
        code: "",
}, (result) => {
})

参数：

播放模块 - PlayModule

playModule 封装了云课堂、直播带货的直播和回放功能。

4. showFullScreenButtonOnIPad

是否在iPad上显示全屏按钮（仅在iPad云课堂场景），需要在进入房间前调用

方法：showFullScreenButtonOnIPad()

示例：

playModule.showFullScreenButtonOnIPad({show:true});

参数：

5. loginLiveRoom

直播登录（云课堂场景，带货直播场景登录）

方法：loginLiveRoom()

示例：

// 直播
playModule.loginLiveRoom(1, {
    channelId: "",
    liveParam4: "",
    liveParam5: ""
}, (result) => {
});

参数：

6. loginPlaybackRoom

登录回放直播间（云课堂，带货直播回放登录）

方法：loginPlaybackRoom()

示例：

playModule.loginPlaybackRoom(0, {
    channlId: "",
    liveParam4: "",
    liveParam5: "",
    videoId: "",
    vodType: 0
}, (result) => {
});

参数：

开播端

引入插件

var liveModule = uni.requireNativePlugin("PLV-LiveUniPlugin-StreamerLiveModule")
var configModule = uni.requireNativePlugin("PLV-LiveUniPlugin-StreamerConfigModule")

配置模块 - ConfigModule

1. setAppGroup【仅iOS有效】

屏幕共享帐号配置的App Group 方法：setAppGroup()

示例：

configModule.setAppGroup({
    appGroup:""
}, (result) => {
})

参数：

直播模块 - LiveModule

登录开播推流

方法：loginStreamer()

示例：

playModule.loginStreamer({
    channelId: "",
    password: "",
    nickname: ""
}, (result) => {
});

参数：

注意事项

• 观看端请务必通过 ConfigModule 的 setViewerInfo 设置观众ID，观众ID是后台区分用户的唯一标识别。

• 如果云打包遇到问题可以移步到离线工程插件工程，进行离线打包。

  • 离线工程：polyv-uniapp-live-plugin

• 插件集成依赖模块说明

  iOS 
  ｜- [Polyv UTDID 插件-iOS]/集成了支付模块的支付宝支付
  ｜- [Polyv播放器插件](https://ext.dcloud.net.cn/plugin?id=4798)
  ｜- [Polyv云直播依赖插件](https://ext.dcloud.net.cn/plugin?id=18966)
  ｜_ [Polyv云直播插件（全功能版）](https://ext.dcloud.net.cn/plugin?id=18970)
  Android
  ｜- [Polyv播放器插件](https://ext.dcloud.net.cn/plugin?id=4798)
  ｜- [Polyv云直播依赖插件](https://ext.dcloud.net.cn/plugin?id=18966)
  ｜_ [Polyv云直播插件（全功能版）](https://ext.dcloud.net.cn/plugin?id=18970)

• iOS 端使用到了后台音频播放和画中画的功能，因此打包时需要在 manifest.json 中进行权限配置，可通过 manifest.json 中最下面的源码视图添加权限配置

  {  
  "app-plus" : {  
        /* 应用发布信息 */  
        "distribute" : {  
            /* ios打包配置 */  
            "ios" : {  
                "UIBackgroundModes" : [ "audio"] // 数组，支持多个  
            },  
        }  
    }  
  }

  详细可以参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/course/package?id=background-modes 和 https://ask.dcloud.net.cn/article/36430

• 为防止APP端被嗅探和反编译到开发者配置信息，强烈建议开发者设计自己的加密方式在服务端对 userId、 AppID、 AppSecret进行加密，并通过https协议的接口获取后重新解密，再将参数传递给SDK。