类型:class
小程序 SDK 实例。提供事件监听、实例方法等能力。
初始化小程序 SDK 实例,用于开启直播间观播功能。
类型
constructor(config: SdkInitParams)
参数
名称 | 类型 | 是否必选 | 默认值 | 说明 |
|---|---|---|---|---|
config | 是 | 无 | SDK 初始化参数。 |
请求示例
import VolcMiniSdk, { EVENTS } from './volc-mini-sdk/index'; const sdk = new VolcMiniSdk({ 'activityId': 17229****9941234, 'token': 'ps****', 'mode': 1, 'options' : { // 在此处自定义配置参数 origin: "https://live.byteoc.com", mediaComponentsAttr: {} } });
监听事件。
类型
<EventKey extends keyof SDKEventsExternal>(action: EventKey, func: SDKEventsExternal[EventKey]) => void
参数
名称 | 类型 | 是否必选 | 默认值 | 说明 |
|---|---|---|---|---|
action | EventKey | 是 | 无 | 事件名称。 |
func | SDKEventsExternal[EventKey] | 是 | 无 | 事件回调函数。 |
监听 SDK 对外抛出的事件,但该事件仅会触发一次。触发后,监听器会自动移除。
类型
<EventKey extends keyof SDKEventsExternal>(action: EventKey, func: SDKEventsExternal[EventKey]) => void
参数
名称 | 类型 | 是否必选 | 默认值 | 说明 |
|---|---|---|---|---|
action | EventKey | 是 | 无 | 事件名称。 |
func | SDKEventsExternal[EventKey] | 是 | 无 | 事件回调函数。 |
移除已绑定的事件监听器。
类型
<EventKey extends keyof SDKEventsExternal>(action: EventKey, func: SDKEventsExternal[EventKey]) => void
参数
名称 | 类型 | 是否必选 | 默认值 | 说明 |
|---|---|---|---|---|
action | EventKey | 是 | 无 | 事件名称。 |
func | SDKEventsExternal[EventKey] | 是 | 无 | 绑定时传入的回调函数实例。 |
更新直播间初始化信息。通常用于处理用户登录态变更等场景,无需重新销毁并初始化 SDK。
类型
(params: SdkInitParams) => void
参数
名称 | 类型 | 是否必选 | 默认值 | 说明 |
|---|---|---|---|---|
params | 是 | 无 | SDK 初始化参数。 |
主动退出当前正在运行的视频画中画(小窗)模式。
类型
() => void
销毁 SDK 实例并释放占用的资源。
说明
如果当前观看页不再需要使用 SDK,可调用该方法销毁 SDK 释放资源,但不建议在销毁 SDK 后再对 SDK 进行重建。如果需要再次使用 SDK,建议在新的观看页集成 SDK 而不是销毁并重建 SDK。
类型
() => void
获取 SDK 的调试信息,可用于在线上环境或开发调试过程中排查问题。
类型
() => { debug: boolean; mini_uuid: string; device_id: string; user_unique_id: string; sdk_version: string; systemInfo: SdkSystemInfo;}
返回值
{ debug: boolean; mini_uuid: string; device_id: string; user_unique_id: string; sdk_version: string; systemInfo: SdkSystemInfo; }
debug:是否开启调试模式。取值如下:
true:开启。false:关闭。mini_uuid:SDK 实例在当前小程序生命周期内的唯一标识(UUID)。device_id:设备的唯一标识符。user_unique_id:用户的唯一标识符。sdk_version:当前集成的 SDK 版本号。systemInfo:小程序原生的系统信息。包含了设备型号、操作系统版本等。