You need to enable JavaScript to run this app.
导航
Web 观播 SDK 常见问题
最近更新时间:2025.11.14 16:40:22首次发布时间:2022.09.16 15:20:50
复制全文
我的收藏
有用
有用
无用
无用

是否支持邀请码观看直播、在进入直播时发送问卷等 Preload 相关功能?

仅支持在进入直播时发送问卷,不支持其他 Preload 相关功能。

我应该如何获取授权 Token?

  • mode=1 (公开模式)时,调用 GetActivityLoginSecret 接口,返回值即为 Web 观播 SDK 初始化参数 signToken 的值。
  • mode=2(自定义模式)时,调用 GetActivityLoginSecret 接口,获取直播间或点播间维度的登录秘钥,再自行生成 JWT(JSON Web Token)作为 SDK 初始化参数 signToken 的值。详情参考该接口使用说明。示例代码如下所示。
    var webSDK = new window.ByteLiveWebSDK({
        activityId: 172291833994****,
        signToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJOaWNrTmFtZSI6IlRvbSIsIlVzZXJJZFN0ciI6Ijk4MDc2NzkiLCJJbnZpdGVyVG9rZW4iOiJhYmNkIiwiQ3VzdG9tQ29tbWVudCI6IuWMl-S6rCIsIkxldmVsSWQiOiIxMDA4NiIsIlRpbWVTdGFtcCI6MTY5NDUwMjQwMH0.97BgHXLsa_bRZB7EIavEbR2d4Wq***********',
        service: 'liveDemo',
        mode: 2, 
        ...
    

授权 Token 的有效期是多久?

永久有效。

为什么我在本地无法播放点播视频?

将您的域名加入企业直播白名单后才可以播放点播视频(即预告和回放)。如果您使用的是本地调试域名 localhost,则无法播放点播视频。如果您想在开发阶段快速体验点播能力,您可以:

  1. 将前端服务的端口设置为 80 或 8000;
  2. 在当前设备 hosts 文件中,添加以下配置:
    127.0.0.1 dev-live.bytedance.com
    

Web 应用部署上线后,SDK 初始化失败,apiservice/sdkinit 接口报错怎么办?

Web 观播 SDK 的 API 不支持跨域调用,请联系火山引擎技术支持将您的域名加入企业直播白名单。

我在移动端进入直播间后或切换菜单栏时,菜单宽高比例显示异常怎么办?

菜单的宽高继承自父元素,即您提供的容器。容器应为固定宽高,不要将容器宽高设置为 autounset 等非固定值。

为什么直播或点播视频无法自动播放或者只能静音自动播放?