activityId

number

是

不适用

直播间的活动 ID。您可通过调用 CreateActivityAPIV2 或 ListActivityAPI 接口获取活动 ID，也可以在企业直播控制台的直播间左上角获取活动 ID。一个直播间对应一个 activityId。

token

string

否

不适用

用户进入直播间时的授权 Token。token 与 signToken 至少需传入其中一个参数；当两者同时传入时，以 signToken 为准。不同鉴权模式（mode）下，token 的获取方式不同：

• mode 取值为 1 时，您可通过调用 GetSDKTokenAPI 接口获取用户 Token，也可以在企业直播控制台直播间内的观看页管理 > 页面嵌入 > Web SDK嵌入中获取用户 Token。
• mode 取值为 2 时，您可通过调用 GetSDKTokenAPI 接口获取用户 Token。

signToken

string

否

不适用

用户进入直播间或点播间的授权 Token。token 与 signToken 至少需传入其中一个参数；当两者同时传入时，以 signToken 为准。不同鉴权模式（mode）下，signToken 的获取方式不同。详情参考获取直播间登录秘钥中使用说明一节。

说明：reSetLiveInfo 方法暂不支持该参数。在使用 reSetLiveInfo 方法时，请传入 token 参数。

mode

number

是

1

鉴权模式。取值如下：

• 1：公开模式。观众以游客身份进入直播间，在点击评论输入框或参与抽奖等需要用户信息的场景下，需要先完成游客注册（即输入昵称或通过手机号登录直播间）。
• 2：自定义模式。观众在进入直播间时使用的是在您 Web 应用内的用户信息，因此可以直接发送评论、参与抽奖等。

chatFontSize

number

否

28

聊天字号。推荐取值范围：[20, 36]。

disableOfflineModal

boolean

否

false

是否禁止弹出多端登录踢出弹窗。取值如下：

• true：禁止。
• false：不禁止。

多端登录踢出弹窗如下所示：

options

SdkExtraOptions

否

——

扩展配置。

origin

string

否

"https://live.byteoc.com"

业务请求域名。如无特殊需求，无需设置。

mediaComponentsAttr

MediaComponentsAttr

否

——

媒体组件属性透传配置。

showChatInputCloseButton

boolean

否

false

在移动端横屏直播间中，是否在聊天互动输入框的输入状态下，展示关闭按钮。取值如下：

• true：展示关闭按钮，用户可点击按钮退出输入态。
• false：不展示关闭按钮。

bottomIconConfig

BottomIconConfig

否

——

观看页图标配置。用于控制横屏或竖屏直播间图标的展示、顺序和外层展示数量。

liveEngineMode

"live-player"

"video"

"auto"

否

• live-player：使用 live-player 组件播放直播流。
• video：使用 video 组件播放直播流，使用该版本 SDK 的直播功能无需开通 live-player 权限。当缺少该权限时，可以设置为该模式。
• auto：自动选择。优先使用 live-player，当 live-player 失败时，会自动切换为 video。

disableFeatureProcess

boolean

string[]

否

false

• true：阻止所有当前小程序已支持互动功能的后续执行。
• false：不阻止任何互动功能的后续执行。
• String[]：仅阻止指定互动功能的后续执行。例如设置参数值为 ['Comment','Question']，阻止评论功能和互动问答功能的后续执行。

支持阻止以下互动功能的后续执行：

• Comment：评论功能。
• Question：互动问答功能。
• Questionnaire：问卷功能。
• CheckIn：签到功能。
• Lottery：抽奖功能。
• Thumb：点赞功能。
• Luckymoney：红包功能。
• Reservation：预约功能。
• Coupon：卡券功能。

floatingInteractionIcons

FloatingInteractionIconConf[]

否

——

互动工具浮窗图标的显示配置。

jumpConfig

JumpConfig

否

——

SDK 默认外链跳转配置。

• 配置此项后，当用户在直播间内点击支持跳转的外部链接（如商品卡片、广告等）时，SDK 会自动跳转到您指定的业务 Webview 页面。
• 若未配置此项，SDK 在点击外链时将仅触发对应的点击事件（如 card.click），不会执行任何默认跳转逻辑，此时需要您自行在事件监听回调中实现跳转逻辑。详情参考自定义跳转逻辑。

video

VideoComponentAttrs

否

——

点播间视频组件属性配置。

livePlayer

LivePlayerComponentAttrs

否

——

直播间组件属性配置。

key

string

是

——

互动工具浮窗图标的唯一标识。当前支持对以下图标设置显示或隐藏：

• SYS:QUESTION：系统默认的互动问答图标。
• SYS:QUESTIONNAIRE：系统默认的问卷图标。
• SYS:CHECKIN：系统默认的签到图标。
• SYS:LOTTERY：系统默认的抽奖图标。
• SYS:LUCKYMONEY：系统默认的红包图标。
• SYS:COUPON：系统默认的卡券图标。

visible

boolean

否

true

是否显示该图标。取值如下：

• true：显示。
• false：隐藏，不占据 HTML 空间。