文档中心

集成微信小程序观播 SDK（历史版本）

最近更新时间：2024.01.09 19:34:34

首次发布时间：2022.10.31 19:05:30

本文介绍微信小程序观播 SDK 的功能支持情况以及集成方法。

适用版本

此文档适用于 0.0.6 之前的版本。

功能支持

微信小程序观播 SDK 支持以下功能：

竖屏直播间
展示直播封面、背景和主题
播放暖场预告片
点播回放
发送评论
高亮主持人发言
观众连麦

前提条件

您已开通定制版套餐。详见计费说明。
如需使用直播功能，您需要开通微信直播组件 live-player 的权限，详见申请开通 live-player。

登录小程序开发者后台，在开发管理 > 开发设置 > 服务器域名中配置以下服务器域名白名单。

request合法域名：添加以下以 https 开头的域名。

https://live.byteoc.com;
https://mon.zijieapi.com;
https://vod.bytedanceapi.com;
https://common.rtc.volcvideo.com;
https://common-hl.rtc.volcvideo.com;
https://log.snssdk.com;

socket合法域名：添加以下以 wss 开头的域名。

wss://frontier.snssdk.com;
wss://ws.rtc.volcvideo.com;
wss://ws-hl.rtc.volcvideo.com;
wss://ws-ag-agsxxa.rtc.volcvideo.com;
wss://ws-ag-aghbwh.rtc.volcvideo.com;
wss://ws-ag-agsdqd.rtc.volcvideo.com;
wss://ws-ag-agjsnj.rtc.volcvideo.com;
wss://ws-ag-aggdsz.rtc.volcvideo.com;

集成方法

参考以下步骤将观播 SDK 集成到您的微信小程序中。

下载 SDK 压缩包，解压缩至您自己的项目目录下。

volc-mini-sdk-v0.0.5.zip

未知大小

SDK 文件夹的结构如下：

|volc-mini-sdk
|---lib/         SDK 依赖文件
|---assets/      静态文件索引
|---components/  组件文件夹
|---|---chat/    聊天组件
|---|---player/  播放器组件
|---|---volc-live-portrait  竖屏直播间整体组件
|---index.js     初始化模块
|---store/       数据缓存目录

SDK 组件内部使用了微信官方提供的 UI 库 WeUI，因此您需要在项目的 app.json 文件中添加以下代码引入 WeUI 组件库：
```
"useExtendedLib": {
    "weui": true
}
```

参考以下步骤在项目的 page 页面实现竖屏直播间：

在项目的 app.json 文件中引入竖屏直播间整体组件，示例代码如下：

"usingComponents": {
  "volc-live-portrait": "./volc-mini-sdk/components/volc-live-portrait/volc-live-portrait"
 }

在 wxml 文件中使用竖屏直播间组件，示例代码如下：
```
<view>
  <volc-live-portrait bind:commentCheck="commentCheck" /> 
</view>
```
组件的 commentCheck 属性说明：
如果初始化直播间时 mode 为 1，用户无法发送评论。当用户点击评论输入框时， SDK 会触发 commentCheck。您可在 commentCheck 里处理登录逻辑并调用 GetSDKTokenAPI 获取用户 token。获取到用户 token 后，再调用 reSetLiveInfo 方法，将 mode 设为 2 并传入用户 token，重置直播间信息。重置成功后用户即可发送评论。详情可查看步骤 3-c 中的示例代码。

在 js 文件中的 onLoad 方法中初始化直播间，示例代码如下：

import volc from './volc-mini-sdk/index';
Page({
  data: {},
  async [onLoad](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html#onLoad-Object-query)() {
    // 页面加载时，调用 init 方法初始化直播间
    const res = await volc.init({
      'activityId': activityId,
      'token': token,
      'mode': 1 or 2,
    });
    if (!res) {
      wx.showToast({
        title: '直播间信息错误',
        icon: 'error'
      });
    }
  },
  onUnload() {
    // 页面卸载时，调用 destroy 方法销毁直播间
    volc.destroy();
  }
  
  // 当用户点击评论输入框时，如果 mode 为 1，会触发 commentCheck，校验用户信息
  async commentCheck() {
    // 此处您需调用 GetSDKTokenAPI 获取用户 token
    // 调用 reSetLiveInfo 方法重置直播间信息
    volc.reSetLiveInfo({
      'activityId': activityId,
      'token': token,
      'mode': 2,
    })
  },
})

init 和 reSetLiveInfo 方法的参数说明：

名称	类型	是否必选	默认值	说明
activityId	Integer	是	无	直播间的活动 ID。调用 CreateActivityAPIV2 后返回。您也可以在企业直播控制台的直播间左上角获取活动 ID。一个直播间对应一个 activityId。
mode	Integer	是	无	鉴权模式。 `1`：公开模式。用户无需登录即可观看直播。 `2`：自定义模式。您需调用 GetSDKTokenAPI 获取用户 token，用户昵称随接口提交。
token	String	是	无	用户 token。 `mode` 为 `1` 时，可在企业直播控制台上直播间内的观看页管理 > 页面嵌入 > Web SDK嵌入中获取用户 token。 `mode` 为 `2` 时，需调用 GetSDKTokenAPI 获取用户 token。

名称

类型

是否必选

默认值

说明

activityId

Integer

是

无

直播间的活动 ID。调用 CreateActivityAPIV2 后返回。您也可以在企业直播控制台的直播间左上角获取活动 ID。一个直播间对应一个 activityId。

mode

Integer

是

无

鉴权模式。

1：公开模式。用户无需登录即可观看直播。
2：自定义模式。您需调用 GetSDKTokenAPI 获取用户 token，用户昵称随接口提交。

token

String

是

无

用户 token。

mode 为 1 时，可在企业直播控制台上直播间内的观看页管理 > 页面嵌入 > Web SDK嵌入中获取用户 token。
mode 为 2 时，需调用 GetSDKTokenAPI 获取用户 token。

适用版本

功能支持

前提条件

集成方法