tt.offAudioRouteChange
基础库 4.26.0 开始支持本方法,这是一个同步方法。
用于取消 onAudioRouteChange 注册的 callback;不传 callback 时取消全部监听。
| 前提条件 | 无 |
| 业务背景 | 无 |
| 使用限制 | 无 |
| 注意事项 | Recorder stop 不会自动清除 callback;不再需要监听时应显式调用 offAudioRouteChange。 Android onAudioRouteChange 仅保留设备变化 reason,不承诺真实 route。 RTC 房间内如需切换扬声器/听筒,请使用 RtcRoomContext.setAudioPlaybackDevice。 |
| 相关教程 | 无 |
语法
tt.offAudioRouteChange(callback)
参数说明
callback
| 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
|---|---|---|---|---|
| function | 否 | 要取消的回调函数,如果不提供则取消所有监听。 | 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 |
返回值
无
代码示例
tt.offAudioRouteChange(onAudioRouteChange); // 不传 callback 可取消所有监听 tt.offAudioRouteChange();
