抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JavaScript API
  • API 概览
  • 基础
  • 界面
  • 渲染
  • 数据缓存
  • 文件
  • 位置
  • 设备
  • 网络
  • 媒体
  • 图片
  • 音频
  • 录屏
  • 麦克风
  • 实时语音
  • 相机
  • 录音
  • RecorderManager
  • tt.getRecorderManager
  • tt.setInnerAudioOption
  • tt.getInnerAudioOption
  • tt.onAudioRouteChange
  • tt.offAudioRouteChange
  • 视频
  • AI
  • Worker
  • 数据分析
  • 支付
  • 广告
  • 开放能力
  • C# API
  • tt.onAudioRouteChange

    收藏
    我的收藏

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

    监听小游戏音频播放路由或音频设备变化事件。

    前提条件无
    业务背景无
    使用限制无
    注意事项

    仅在录音RecorderManager期间返回route变化事件。

    Android onAudioRouteChange 仅保留设备变化 reason,不承诺真实 route。

    该能力不要与 RTC 路由能力混用;RTC 房间内如需切换扬声器/听筒,请使用 RtcRoomContext.setAudioPlaybackDevice。

    相关教程无

    语法

    tt.onAudioRouteChange(callback)

    参数说明

    callback

    类型默认值必填说明最低支持版本
    function是

    音频路由或设备变化事件的回调函数;

    iOS 返回真实 route/speakerOn/reason;

    Android route 固定 unknown、speakerOn 固定 false,仅 reason 表示设备变化原因。

    4.26.0

    callback 是一个回调函数,接收 object 类型的参数,属性如下:

    属性名类型说明最低支持版本
    routestring
    iOS 当前真实物理路由;Android 固定为 unknown。
    4.26.0
    speakerOnboolean
    iOS 当前是否外放;Android 固定为 false。
    4.26.0
    reasonstring
    路由或设备变化原因。
    4.26.0

    返回值

    无

    代码示例

    const onAudioRouteChange = (res) => { console.log(res.route, res.speakerOn, res.reason); }; tt.onAudioRouteChange(onAudioRouteChange);