音频路由

import { AudioRouteSession, AudioRouteTarget } from 'srtc';

const session = AudioRouteSession.shared;
session.start();

// 持久：视频会议默认外放
session.defaultAudioRoute = AudioRouteTarget.speaker;

// 临时：用户点了听筒
session.setAudioRoute(AudioRouteTarget.earpiece);

// 撤销临时设置，回到持久设置
session.clearAudioRouteOverride();

AudioRoute       speaker / earpiece / bluetooth / wired / other   ← 只读，五态
AudioRouteTarget speaker / earpiece                               ← 可切换，两态

if (session.isExternalRouteActive) {
  // 蓝牙或有线耳机在用，此时切扬声器/听筒的请求会被系统覆盖
}
session.isSpeakerActive;        // 当前是否外放
session.isHeadsetAvailable;     // 有线耳机是否可用
session.isBluetoothAvailable;   // 蓝牙是否可用
session.availableRoutes();      // AudioRouteInfo[]，可用路由清单

import { AudioRouteSessionDelegate, AudioRoute, AudioCallState, audioRouteName } from 'srtc';

const observer: AudioRouteSessionDelegate = {
  onAudioRouteChange: (route: AudioRoute, previous: AudioRoute) => {
    console.info(`路由: ${audioRouteName(previous)} → ${audioRouteName(route)}`);
    // 刷新 UI 上的"免提"按钮状态
  },
  onCallStateChange: (state: AudioCallState, previous: AudioCallState) => {
    // 系统通话（来电等）状态变化
  }
};

AudioRouteSession.shared.delegates.add(observer);
AudioRouteSession.shared.start();

// 页面退出时
AudioRouteSession.shared.stop();
AudioRouteSession.shared.delegates.remove(observer);

session.callState;                     // 主动查询
audioCallStateName(session.callState); // 可读名字

// 入会前：视频会议默认外放，语音通话默认听筒
session.defaultAudioRoute = isVideoCall
  ? AudioRouteTarget.speaker
  : AudioRouteTarget.earpiece;
session.start();

// 通话中的"免提"按钮
function toggleSpeaker(): void {
  const on = session.effectiveRouteTarget === AudioRouteTarget.speaker;
  session.setAudioRoute(on ? AudioRouteTarget.earpiece : AudioRouteTarget.speaker);
}