抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JavaScript API
  • C# API
  • API 概览
  • 初始化
  • 基础
  • 调试工具
  • 界面
  • 渲染
  • 数据缓存
  • PlayerPrefs
  • 文件
  • 设备
  • 网络
  • 系统
  • 媒体
  • 录屏
  • 图片
  • 录音
  • GetTTRecorderManager
  • TTRecorderManager
  • SetInnerAudioOption
  • GetInnerAudioOption
  • OnAudioRouteChange
  • 支付
  • 广告
  • 位置
  • 开放能力
  • 抖音云模块
  • OnAudioRouteChange

    收藏
    我的收藏

    TT.OnAudioRouteChange

    TTSDK 6.9.0 开始支持本方法。
    监听小游戏音频播放路由或音频设备变化事件。
    前提条件
    无
    业务背景
    无
    使用限制
    无
    注意事项
    仅在录音 RecorderManager 期间返回 route 变化事件。
    Android OnAudioRouteChange 仅保留设备变化 reason,不承诺真实 route。
    相关教程
    无

    语法

    public static void OnAudioRouteChange(TTAudioRouteChangeCallback callback)

    参数说明

    callback

    类型
    默认值
    必填
    说明
    最低支持版本
    TTAudioRouteChangeCallback
    ​
    是
    音频路由或设备变化事件的回调函数;
    iOS 返回真实 route/speakerOn/reason;
    Android route 固定 unknown、speakerOn 固定 false,仅 reason 表示设备变化原因。
    TTSDK 6.9.0
    callback 接收 TTAudioRouteChangeResult 类型参数,属性如下:
    属性名
    类型
    说明
    最低支持版本
    route
    string
    iOS 当前真实物理路由;Android 固定为 unknown。
    TTSDK 6.9.0
    speakerOn
    bool
    iOS 当前是否外放;Android 固定为 false。
    TTSDK 6.9.0
    reason
    string
    路由或设备变化原因。
    TTSDK 6.9.0

    返回值

    无

    代码示例

    TTAudioRouteChangeCallback onAudioRouteChange = result => { Debug.Log($"AudioRouteChange, route={result.route}, speakerOn={result.speakerOn}, reason={result.reason}"); }; TT.OnAudioRouteChange(onAudioRouteChange);
    ​

    TT.OffAudioRouteChange

    TTSDK 6.9.0 开始支持本方法。
    取消当前 OnAudioRouteChange 监听。当前 Unity 封装仅保留最近一次注册的回调;调用 OffAudioRouteChange 时,无论是否传入 callback,都会取消当前监听。
    前提条件
    无
    业务背景
    无
    使用限制
    无
    注意事项
    Recorder stop 不会自动清除 Unity callback;不再需要监听时应显式调用 OffAudioRouteChange。
    Android OnAudioRouteChange 仅保留设备变化 reason,不承诺真实 route。
    相关教程
    无

    语法

    public static void OffAudioRouteChange(TTAudioRouteChangeCallback callback = null)

    参数说明

    callback

    类型
    默认值
    必填
    说明
    最低支持版本
    TTAudioRouteChangeCallback
    ​
    否
    当前 Unity 封装仅保留最近一次注册的回调;调用 OffAudioRouteChange 时,无论是否传入 callback,都会取消当前监听。
    TTSDK 6.9.0
    callback 接收 TTAudioRouteChangeResult 类型参数,属性如下:
    属性名
    类型
    说明
    最低支持版本
    route
    string
    iOS 当前真实物理路由;Android 固定为 unknown。
    TTSDK 6.9.0
    speakerOn
    bool
    iOS 当前是否外放;Android 固定为 false。
    TTSDK 6.9.0
    reason
    string
    路由或设备变化原因。
    TTSDK 6.9.0

    返回值

    无

    代码示例

    TT.OffAudioRouteChange(onAudioRouteChange); // 取消当前监听 TT.OffAudioRouteChange(); // 取消当前监听