抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 登录
  • 社交转发裂变
  • 用户信息及授权
  • 小游戏收藏
  • 群聊
  • 关注
  • 游戏互推组件
  • 添加到桌面
  • 游戏排行榜
  • 数据分析
  • 视频拍摄器
  • 订阅消息
  • 关系链
  • 客服能力
  • 直播能力
  • LiveManager
  • LiveManager.getLiveStatus
  • LiveManager.checkRoomIsValid
  • LiveManager.navigateToLive
  • LiveManager.onXScreenSizeChange
  • LiveManager.offXScreenSizeChange
  • Unity小游戏
  • 侧边栏能力
  • 推荐流直出游戏能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • Worker
  • LiveManager.navigateToLive
    收藏
    我的收藏

    基础库 3.60.0 开始支持本方法,这是一个异步方法。

    跳转到指定直播间。

    前提条件
    在使用前需前往直播玩法后台,在能力 - 进阶互动能力中申请【玩法扩展组件能力】。申请后,需选择对应小游戏关联。
    业务背景
    使用限制
    注意事项
    相关教程

    语法

    LiveManager.navigateToLive(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    roomIDstring
    直播间 ID。可以从 LiveManager.getLiveStatus 中获取主播直播间 id。
    3.60.0
    successfunction
    接口调用成功的回调函数
    3.60.0
    failfunction
    接口调用失败的回调函数
    3.60.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    3.60.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "LiveManager.navigateToLive:ok"
    3.60.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "LiveManager.navigateToLive:fail" + 详细错误信息
    3.60.0

    错误码

    errNoerrMsg说明最低支持版本
    20001invalid param
    参数校验错误
    3.60.0
    21001live room is closed
    直播间已关闭
    3.60.0
    21003live room does not exist
    直播间不存在
    3.60.0
    21004interact game in the live room is unmount
    直播间未挂载绑定小玩法
    3.60.0
    10401system error, please retry
    网络 / 系统错误
    3.60.0
    10101platform auth deny
    不在白名单列表中,请先申请能力
    3.60.0

    代码示例

    const liveManager = tt.getLiveManager(); liveManager.navigateToLive({ roomID: 'xxxx', // 直播间ID success: (res) => { console.log('跳转直播间成功', res) }, fail: (res) => { console.log('跳转直播间失败', res) } })