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 类型的参数,属性如下:
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| route | string | iOS 当前真实物理路由;Android 固定为 unknown。 | 4.26.0 |
| speakerOn | boolean | iOS 当前是否外放;Android 固定为 false。 | 4.26.0 |
| reason | string | 路由或设备变化原因。 | 4.26.0 |
返回值
无
代码示例
const onAudioRouteChange = (res) => { console.log(res.route, res.speakerOn, res.reason); }; tt.onAudioRouteChange(onAudioRouteChange);
