Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
扬声器与听筒切换、持久设置与临时设置的优先级、蓝牙与有线耳机、系统来电
AudioRouteSession。
| 接口 | 生效范围 | 典型用法 | |
|---|---|---|---|
| 持久设置 | defaultAudioRoute（读写属性） | 长期有效，外设拔出后按它回落 | 入会前定默认走扬声器还是听筒 |
| 临时设置 | setAudioRoute(target) | 本次通话，优先级更高 | 用户在通话中点了”免提” |
import { AudioRouteTarget } from 'srtc';
// 入会前：视频会议默认外放，纯语音默认听筒
meeting.defaultAudioRoute = isVideoMeeting
? AudioRouteTarget.speaker
: AudioRouteTarget.earpiece;
// 通话中的免提按钮
function toggleSpeaker(): void {
const on = meeting.effectiveAudioRouteTarget === AudioRouteTarget.speaker;
meeting.setAudioRoute(on ? AudioRouteTarget.earpiece : AudioRouteTarget.speaker);
}
// 撤销临时设置
meeting.clearAudioRouteOverride();
effectiveAudioRouteTarget，不是 defaultAudioRoute。后者是持久设置，在有临时设置时不代表当前状态 —— 用它会导致按钮显示与实际不符。meeting.setSpeakerOutputEnabled(true); // 等价于切到 speaker
| 属性 / 方法 | 类型 | 说明 |
|---|---|---|
currentAudioRoute | AudioRoute | 实际在用的路由（五态） |
effectiveAudioRouteTarget | AudioRouteTarget | 当前生效的目标（两态） |
audioRouteOverride | AudioRouteTarget | undefined | 有临时设置时非空 |
isExternalAudioRouteActive | boolean | 蓝牙 / 有线是否在用 |
availableAudioRoutes() | AudioRouteInfo[] | 可用路由清单 |
AudioRoute speaker / earpiece / bluetooth / wired / other ← 只读，五态
AudioRouteTarget speaker / earpiece ← 可切换，两态
if (meeting.isExternalAudioRouteActive) {
// 蓝牙或有线在用，此时切扬声器/听筒的请求会被系统覆盖
// UI 上应该把免提按钮置灰，并提示"正在使用耳机"
}
onAudioRouteChange: (m, data) => {
// data.route / data.previousRoute，类型 AudioRoute
this.speakerOn = m.effectiveAudioRouteTarget === AudioRouteTarget.speaker;
this.usingHeadset = m.isExternalAudioRouteActive;
}
wired → 你的回调里又 setAudioRoute(speaker) →
系统再切回 wired……声音会在两个设备间反复跳。正确做法是更新 UI，把选择权交给用户。audioRouteName(route) 可以拿到可读名字，直接用于 UI 展示。
onCallStateChange: (m, data) => {
// data.state / data.previousState，类型 AudioCallState
switch (data.state) {
case AudioCallState.incoming:
case AudioCallState.connected:
this.banner = '系统通话中，会议音频已暂停';
break;
case AudioCallState.disconnected:
this.banner = undefined;
break;
}
}
AudioCallState：unknown / dialing / incoming / connected / disconnected。
aboutToAppear(): void {
this.meeting.delegates.add(this.delegate);
// 视频会议默认外放
this.meeting.defaultAudioRoute = AudioRouteTarget.speaker;
this.syncAudioUi();
}
private syncAudioUi(): void {
this.speakerOn = this.meeting.effectiveAudioRouteTarget === AudioRouteTarget.speaker;
this.usingHeadset = this.meeting.isExternalAudioRouteActive;
}
onAudioRouteChange 更新 ——
只依赖事件的话进会瞬间的按钮状态是错的。