shengwang-electron-sdk 4.6.2-rc.1

package/ts/Private/IAgoraSpatialAudio.ts

@@ -0,0 +1,248 @@
+import './extension/IAgoraSpatialAudioExtension';
+import { RtcConnection } from './IAgoraRtcEngineEx';
+
+/**
+ * 远端用户或媒体播放器的空间位置信息。
+ */
+export class RemoteVoicePositionInfo {
+  /**
+   * 在世界坐标系中的坐标。该参数是长度为 3 的数组，三个值依次表示前、右、上的坐标值。
+   */
+  position?: number[];
+  /**
+   * 在世界坐标系前轴的单位向量。该参数是长度为 3 的数组，三个值依次表示前、右、上的坐标值。
+   */
+  forward?: number[];
+}
+
+/**
+ * 隔声区域的设置。
+ */
+export class SpatialAudioZone {
+  /**
+   * 隔声区域的 ID。
+   */
+  zoneSetId?: number;
+  /**
+   * 隔声区域的空间中心点。该参数是长度为 3 的数组，三个值依次表示前、右、上的坐标值。
+   */
+  position?: number[];
+  /**
+   * 以 position 为起点，向前的单位向量。该参数是长度为 3 的数组，三个值依次表示前、右、上的坐标值。
+   */
+  forward?: number[];
+  /**
+   * 以 position 为起点，向右的单位向量。该参数是长度为 3 的数组，三个值依次表示前、右、上的坐标值。
+   */
+  right?: number[];
+  /**
+   * 以 position 为起点，向上的单位向量。该参数是长度为 3 的数组，三个值依次表示前、右、上的坐标值。
+   */
+  up?: number[];
+  /**
+   * 将整个隔声区域看做一个立方体，表示向前的边长，单位为游戏引擎的单位长度。
+   */
+  forwardLength?: number;
+  /**
+   * 将整个隔声区域看做一个立方体，表示向右的边长，单位为游戏引擎的单位长度。
+   */
+  rightLength?: number;
+  /**
+   * 将整个隔声区域看做一个立方体，表示向上的边长，单位为游戏引擎的单位长度。
+   */
+  upLength?: number;
+  /**
+   * 隔声区域以内的用户和外部用户互通时的声音衰减系数，取值范围为 [0,1]。其中：
+   *  0：广播模式，即音量和音色均不随距离衰减，无论距离远近，本地用户听到的音量和音色都无变化。
+   *  (0,0.5)：弱衰减模式，即音量和音色在传播过程中仅发生微弱衰减，跟真实环境相比，声音可以传播得更远。
+   *  0.5：模拟音量在真实环境下的衰减，效果等同于不设置 audioAttenuation 参数。
+   *  (0.5,1]：强衰减模式 (默认值为 1) ，即音量和音色在传播过程中发生迅速衰减。
+   */
+  audioAttenuation?: number;
+}
+
+/**
+ * 该类通过 SDK 计算用户坐标，实现空间音频。
+ *
+ * 该类继承自 IBaseSpatialAudioEngine 。调用该类下其他 API 前，你需要调用 initialize 方法初始化该类。
+ */
+export abstract class ILocalSpatialAudioEngine {
+  /**
+   * @ignore
+   */
+  abstract release(): void;
+
+  /**
+   * 初始化 ILocalSpatialAudioEngine 。
+   *
+   * 在调用 ILocalSpatialAudioEngine 类的其他方法前，你需要先调用该方法初始化 ILocalSpatialAudioEngine 。
+   *  SDK 只支持每个 App 创建一个 ILocalSpatialAudioEngine 实例。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract initialize(): number;
+
+  /**
+   * 更新远端用户的空间位置信息。
+   *
+   * 成功调用该方法后，SDK 会根据本地和远端用户的相对位置计算空间音频参数。 该方法需要在 joinChannel 后调用。
+   *
+   * @param uid 用户 ID。需与用户加入频道时填写的用户 ID 一致。
+   * @param posInfo 远端用户的空间位置信息。详见 RemoteVoicePositionInfo 。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract updateRemotePosition(
+    uid: number,
+    posInfo: RemoteVoicePositionInfo
+  ): number;
+
+  /**
+   * @ignore
+   */
+  abstract updateRemotePositionEx(
+    uid: number,
+    posInfo: RemoteVoicePositionInfo,
+    connection: RtcConnection
+  ): number;
+
+  /**
+   * 删除指定远端用户的空间位置信息。
+   *
+   * 成功调用该方法后，本地用户将听不到指定的远端用户。
+   * 离开频道后，为避免计算资源的浪费，你需要调用该方法删除指定远端用户的空间位置信息。否则，该用户的空间位置信息会一直被保存。当远端用户人数大于 setMaxAudioRecvCount 中设定的可接收音频流数时，会按照相对距离依次自动取消订阅距离最远的用户的音频流。
+   *
+   * @param uid 用户 ID。需与用户加入频道时填写的用户 ID 一致。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract removeRemotePosition(uid: number): number;
+
+  /**
+   * @ignore
+   */
+  abstract removeRemotePositionEx(
+    uid: number,
+    connection: RtcConnection
+  ): number;
+
+  /**
+   * @ignore
+   */
+  abstract clearRemotePositionsEx(connection: RtcConnection): number;
+
+  /**
+   * @ignore
+   */
+  abstract updateSelfPositionEx(
+    position: number[],
+    axisForward: number[],
+    axisRight: number[],
+    axisUp: number[],
+    connection: RtcConnection
+  ): number;
+
+  /**
+   * @ignore
+   */
+  abstract setMaxAudioRecvCount(maxCount: number): number;
+
+  /**
+   * @ignore
+   */
+  abstract setAudioRecvRange(range: number): number;
+
+  /**
+   * @ignore
+   */
+  abstract setDistanceUnit(unit: number): number;
+
+  /**
+   * @ignore
+   */
+  abstract updateSelfPosition(
+    position: number[],
+    axisForward: number[],
+    axisRight: number[],
+    axisUp: number[]
+  ): number;
+
+  /**
+   * @ignore
+   */
+  abstract updatePlayerPositionInfo(
+    playerId: number,
+    positionInfo: RemoteVoicePositionInfo
+  ): number;
+
+  /**
+   * @ignore
+   */
+  abstract setParameters(params: string): number;
+
+  /**
+   * @ignore
+   */
+  abstract muteLocalAudioStream(mute: boolean): number;
+
+  /**
+   * @ignore
+   */
+  abstract muteAllRemoteAudioStreams(mute: boolean): number;
+
+  /**
+   * @ignore
+   */
+  abstract muteRemoteAudioStream(uid: number, mute: boolean): number;
+
+  /**
+   * 设置指定用户的声音衰减效果。
+   *
+   * @param uid 用户 ID。需与用户加入频道时填写的用户 ID 一致。
+   * @param attenuation 针对该用户的声音衰减系数，取值范围为[0,1]。其中：
+   * @param forceSet 是否强制设定该用户的声音衰减效果： true ：强制使用 attenuation 设置该用户的声音衰减效果，此时 SpatialAudioZone 中的 audioAttenuation 中设置的隔声区域衰减系数对该用户不生效。 false ：不强制使用 attenuation 设置用户的声音衰减效果，分为以下两种情况。
+   *  如果音源和听声者分属于隔声区域内部和外部，则声音衰减效果由 SpatialAudioZone 中的 audioAttenuation 决定。
+   *  如果音源和听声者在同一个隔声区域内或同在隔声区域外，则声音衰减效果由该方法中的 attenuation 决定。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract setRemoteAudioAttenuation(
+    uid: number,
+    attenuation: number,
+    forceSet: boolean
+  ): number;
+
+  /**
+   * @ignore
+   */
+  abstract setZones(zones: SpatialAudioZone[], zoneCount: number): number;
+
+  /**
+   * @ignore
+   */
+  abstract setPlayerAttenuation(
+    playerId: number,
+    attenuation: number,
+    forceSet: boolean
+  ): number;
+
+  /**
+   * 删除所有远端用户的空间位置信息。
+   *
+   * 成功调用该方法后，本地用户将听不到所有远端用户。
+   * 离开频道后，为避免计算资源的浪费，你也可以调用该方法删除所有远端用户的空间位置信息。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract clearRemotePositions(): number;
+}

package/ts/Private/IAudioDeviceManager.ts

@@ -0,0 +1,351 @@
+import './extension/IAudioDeviceManagerExtension';
+import { AudioDeviceInfo } from './IAgoraRtcEngine';
+
+/**
+ * 设备 ID 的最大长度。
+ */
+export enum MaxDeviceIdLengthType {
+  /**
+   * 设备 ID 的最大长度为 512 个字符。
+   */
+  MaxDeviceIdLength = 512,
+}
+
+/**
+ * 音频设备管理方法。
+ */
+export abstract class IAudioDeviceManager {
+  /**
+   * 获取系统中所有的播放设备列表。
+   *
+   * @returns
+   * 方法调用成功，返回 AudioDeviceInfo 数组，包含所有音频播放设备的设备 ID 和设备名称。
+   *  方法调用失败: 返回空列表。
+   */
+  abstract enumeratePlaybackDevices(): AudioDeviceInfo[];
+
+  /**
+   * 获取系统中所有的音频采集设备列表。
+   *
+   * @returns
+   * 方法调用成功，返回一个 AudioDeviceInfo 数组，包含所有音频采集设备的设备 ID 和设备名称。
+   *  方法调用失败: 返回空列表。
+   */
+  abstract enumerateRecordingDevices(): AudioDeviceInfo[];
+
+  /**
+   * 指定播放设备。
+   *
+   * 该方法可以更改当前的音频路由，但不会改变系统默认的音频路由。假设系统默认的音频路由是扬声器 1，你在加入频道前调用该方法设置当前的音频路由为扬声器 2，如果在此时进行设备检测，SDK 会对扬声器 2 进行检测。检测结束后，当你加入频道时 SDK 依然会选择使用系统默认的音频路由，即扬声器 1。
+   *
+   * @param deviceId 指定播放设备。由 enumeratePlaybackDevices 获取。插拔设备不会影响 deviceId 。
+   * 最大长度为 MaxDeviceIdLengthType 。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract setPlaybackDevice(deviceId: string): number;
+
+  /**
+   * 获取当前音频播放设备。
+   *
+   * @returns
+   * 当前音频播放设备。
+   */
+  abstract getPlaybackDevice(): string;
+
+  /**
+   * 获取音频播放设备信息。
+   *
+   * @returns
+   * AudioDeviceInfo 对象，包含音频播放设备的设备 ID 和设备名称。
+   */
+  abstract getPlaybackDeviceInfo(): AudioDeviceInfo;
+
+  /**
+   * 设置播放设备音量。
+   *
+   * 该方法仅适用于 Windows 平台。
+   *
+   * @param volume 播放设备音量。取值范围为 [0,255]。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract setPlaybackDeviceVolume(volume: number): number;
+
+  /**
+   * 获取播放设备音量。
+   *
+   * @returns
+   * 播放设备音量。取值范围 [0,255]。
+   */
+  abstract getPlaybackDeviceVolume(): number;
+
+  /**
+   * 指定音频采集设备。
+   *
+   * 该方法可以更改当前的音频采集设备，但不改变系统默认的音频采集设备。假设系统默认的音频采集设备是麦克风 1，你在加入频道前调用该方法设置当前的音频路由为蓝牙耳机 1，如果在此时进行设备检测，SDK 会对蓝牙耳机 1 进行检测。检测结束后，当你加入频道时 SDK 依然会选择使用系统默认的音频采集设备，即麦克风 1。
+   *
+   * @param deviceId 音频采集设备的 Device ID。可通过 enumerateRecordingDevices 获取。插拔设备不会影响 deviceId 。
+   * 最大长度为 MaxDeviceIdLengthType 。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract setRecordingDevice(deviceId: string): number;
+
+  /**
+   * 获取当前音频采集设备。
+   *
+   * @returns
+   * 当前音频采集设备。
+   */
+  abstract getRecordingDevice(): string;
+
+  /**
+   * 获取音频采集设备信息。
+   *
+   * @returns
+   * AudioDeviceInfo 对象，包含音频采集设备的设备 ID 和设备名称。
+   */
+  abstract getRecordingDeviceInfo(): AudioDeviceInfo;
+
+  /**
+   * 设置音频采集设备音量。
+   *
+   * 该方法仅适用于 Windows 和 macOS。
+   *
+   * @param volume 音频采集设备音量。取值范围 [0,255]。0 代表无声，255 代表最大音量。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract setRecordingDeviceVolume(volume: number): number;
+
+  /**
+   * 获取音频采集设备音量。
+   *
+   * 该方法仅适用于 Windows 平台。
+   *
+   * @returns
+   * 音频采集设备音量。取值范围 [0,255]。
+   */
+  abstract getRecordingDeviceVolume(): number;
+
+  /**
+   * 指定声卡采集设备。
+   *
+   * SDK 默认采用当前的播放设备作为声卡采集设备，如果想要指定其他音频设备作为声卡采集设备，则调用该方法并设置 deviceId 为你想要指定的声卡采集设备。
+   * 该方法可以更改当前的音频采集设备，但不改变系统默认的音频采集设备。假设系统默认的音频采集设备是麦克风 1，你在加入频道前调用该方法设置当前的音频路由为声卡 1，如果在此时进行设备检测，SDK 会对声卡 1 做设备检测。检测结束后，当你加入频道时 SDK 依然会选择使用系统默认的音频采集设备，即麦克风 1。 该方法仅适用于 Windows 和 macOS。
+   * 该方法适用的场景如下：
+   * 使用 App A 播放音乐，通过蓝牙耳机播放；同时使用 App B 进行视频会议，通过扬声器播放。
+   *  如果设置声卡采集设备为蓝牙耳机，则 SDK 会将 App A 中的音乐发布到远端。
+   *  如果设置声卡采集设备设置为扬声器，则 SDK 不会将 App A 中的音乐发布到远端。
+   *  如果设置声卡采集设备为蓝牙耳机后，又改用有线耳机播放 App A 中的音乐，则需要重新调用该方法，设置声卡采集设备为有线耳机，则 SDK 会继续将 App A 中的音乐发布到远端。
+   *
+   * @param deviceId 指定 SDK 的声卡采集设备。由 enumeratePlaybackDevices 获取。插拔设备不会影响 deviceId 。
+   * 最大长度为 MaxDeviceIdLengthType 。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract setLoopbackDevice(deviceId: string): number;
+
+  /**
+   * 获取当前的声卡采集设备。
+   *
+   * 该方法仅适用于 Windows 和 macOS。
+   *
+   * @returns
+   * 当前声卡采集设备的 ID。
+   */
+  abstract getLoopbackDevice(): string;
+
+  /**
+   * 设置播放设备静音。
+   *
+   * @param mute 是否设置播放设备为静音： true : 播放设备设为静音。 false : 播放设备不设为静音。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract setPlaybackDeviceMute(mute: boolean): number;
+
+  /**
+   * 获取当前播放设备静音状态。
+   *
+   * @returns
+   * true : 播放设备为静音状态。 false : 播放设备为非静音状态。
+   */
+  abstract getPlaybackDeviceMute(): boolean;
+
+  /**
+   * 设置当前音频采集设备静音。
+   *
+   * @param mute 是否设置音频采集设备静音： true : 采集设备静音。 false : 采集设备为非静音。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract setRecordingDeviceMute(mute: boolean): number;
+
+  /**
+   * 获取当前音频采集设备静音状态。
+   *
+   * @returns
+   * true : 采集设备为静音状态。 false : 采集设备为非静音状态。
+   */
+  abstract getRecordingDeviceMute(): boolean;
+
+  /**
+   * 启动音频播放设备测试。
+   *
+   * 该方法用于测试本地音频播放设备是否能正常工作。启动测试后，SDK 播放指定的音频文件，测试者如果能听到声音，说明播放设备能正常工作。
+   * 调用该方法后，SDK 会每隔 100 毫秒触发一次 onAudioVolumeIndication 回调，报告 uid = 1 及播放设备的音量信息。
+   * 该方法和 startEchoTest 的区别在于该方法检测本地的音频播放设备能否正常工作，后者可以检测音视频设备及网络是否正常。 该方法需要在加入频道前调用。测试完成后，如需加入频道，请确保先调用 stopPlaybackDeviceTest 停止设备测试。
+   *
+   * @param testAudioFilePath 音频文件的绝对路径，路径字符串使用 UTF-8 编码格式。
+   *  支持文件格式: wav、mp3、m4a、aac。
+   *  支持文件采样率: 8000、16000、32000、44100、48000。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract startPlaybackDeviceTest(testAudioFilePath: string): number;
+
+  /**
+   * 停止音频播放设备测试。
+   *
+   * 该方法用于停止音频播放设备测试。调用 startPlaybackDeviceTest 后，必须调用该方法停止测试。 该方法需要在加入频道前调用。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract stopPlaybackDeviceTest(): number;
+
+  /**
+   * 启动音频采集设备测试。
+   *
+   * 该方法用于测试本地音频采集设备是否能正常工作。调用该方法后，SDK 会按设置的时间间隔触发 onAudioVolumeIndication 回调，报告 uid = 0 及采集设备的音量信息。
+   * 该方法和 startEchoTest 的区别在于该方法检测本地的音频采集设备能否正常工作，后者可以检测音视频设备及网络是否正常。 该方法需要在加入频道前调用。测试完成后，如需加入频道，请确保先调用 stopRecordingDeviceTest 停止设备测试。
+   *
+   * @param indicationInterval SDK 触发 onAudioVolumeIndication 回调的时间间隔，单位为毫秒，最小取值为 10，否则会收不到 onAudioVolumeIndication 回调，SDK 会返回错误码 -2 。声网推荐你将该值设为 100。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   *  -2: 参数设置错误，请重新设置参数。
+   */
+  abstract startRecordingDeviceTest(indicationInterval: number): number;
+
+  /**
+   * 停止音频采集设备测试。
+   *
+   * 该方法用于停止音频采集设备测试。调用 startRecordingDeviceTest 后，必须调用该方法停止测试。 该方法需要在加入频道前调用。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract stopRecordingDeviceTest(): number;
+
+  /**
+   * 开始音频设备回路测试。
+   *
+   * 该方法测试音频采集和播放设备是否能正常工作。一旦测试开始，音频采集设备会采集本地音频，然后使用音频播放设备播放出来。SDK 会按设置的时间间隔触发两个 onAudioVolumeIndication 回调，分别报告音频采集设备（ uid = 0）和音频播放设置（ uid = 1）的音量信息。
+   *  该方法在加入频道前后都可调用。
+   *  该方法仅支持主播角色调用。
+   *  该方法仅在本地进行音频设备测试，不涉及网络连接。
+   *  完成测试后，必须调用 stopAudioDeviceLoopbackTest 停止音频设备回路测试。
+   *
+   * @param indicationInterval SDK 触发 onAudioVolumeIndication 回调的时间间隔，单位为毫秒。建议设置到大于 200 毫秒。不得少于 10 毫秒，否则会收不到 onAudioVolumeIndication 回调。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract startAudioDeviceLoopbackTest(indicationInterval: number): number;
+
+  /**
+   * 停止音频设备回路测试。
+   *
+   * 该方法在加入频道前后都可调用。
+   *  该方法仅支持主播角色调用。
+   *  在调用 startAudioDeviceLoopbackTest 后，必须调用该方法停止音频设备回路测试。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract stopAudioDeviceLoopbackTest(): number;
+
+  /**
+   * 设置 SDK 使用的音频播放设备跟随系统默认的音频播放设备。
+   *
+   * @param enable 是否跟随系统默认的音频播放设备： true ：跟随。当系统默认音频播放设备发生改变时，SDK 立即切换音频播放设备。 false ：不跟随。只有当 SDK 使用的音频播放设备被移除后，SDK 才切换至系统默认的音频播放设备。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract followSystemPlaybackDevice(enable: boolean): number;
+
+  /**
+   * 设置 SDK 使用的音频采集设备跟随系统默认的音频采集设备。
+   *
+   * @param enable 是否跟随系统默认的音频采集设备： true ：跟随。当系统默认的音频采集设备改变时，SDK 立即切换音频采集设备。 false ：不跟随。只有当 SDK 使用的音频采集设备被移除后，SDK 才切换至系统默认的音频采集设备。
+   *
+   * @returns
+   * 0：方法调用成功。
+   *  < 0：方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract followSystemRecordingDevice(enable: boolean): number;
+
+  /**
+   * 设置声卡采集设备是否跟随系统默认的播放设备。
+   *
+   * 方法仅适用于 Windows 和 macOS。
+   *
+   * @param enable 是否跟随系统默认的播放设备： true ：跟随。当系统默认播放设备发生改变时，SDK 立即跟随切换声卡采集设备。 false ：不跟随。只有当 SDK 使用的声卡采集设备被移除后，SDK 才切换至系统默认的音频播放设备。
+   *
+   * @returns
+   * 0: 方法调用成功。
+   *  < 0: 方法调用失败。详见[错误码](https://doc.shengwang.cn/api-ref/rtc/electron/error-code)了解详情和解决建议。
+   */
+  abstract followSystemLoopbackDevice(enable: boolean): number;
+
+  /**
+   * 释放 IAudioDeviceManager 对象占用的所有资源。
+   */
+  abstract release(): void;
+
+  /**
+   * 获取系统默认的音频播放设备。
+   *
+   * 该方法仅适用于 Windows 和 macOS。
+   *
+   * @returns
+   * 默认音频播放设备的信息。详见 AudioDeviceInfo 。
+   */
+  abstract getPlaybackDefaultDevice(): AudioDeviceInfo;
+
+  /**
+   * 获取系统默认的音频采集设备。
+   *
+   * 该方法仅适用于 Windows 和 macOS。
+   *
+   * @returns
+   * 默认音频采集设备的信息。详见 AudioDeviceInfo 。
+   */
+  abstract getRecordingDefaultDevice(): AudioDeviceInfo;
+}

package/ts/Private/extension/AgoraBaseExtension.ts

@@ -0,0 +1,14 @@
+import '../AgoraBase';
+
+declare module '../AgoraBase' {
+  interface VideoCanvas {
+    /**
+     * @ignore
+     */
+    useWebCodecsDecoder?: boolean;
+    /**
+     * @ignore
+     */
+    enableFps?: boolean;
+  }
+}

package/ts/Private/extension/AgoraMediaBaseExtension.ts

@@ -0,0 +1 @@
+export {};

package/ts/Private/extension/AgoraMediaPlayerTypesExtension.ts

@@ -0,0 +1 @@
+export {};

package/ts/Private/extension/IAgoraH265TranscoderExtension.ts

@@ -0,0 +1,39 @@
+import { IH265TranscoderObserver } from '../IAgoraH265Transcoder';
+
+export type IH265TranscoderEvent = IH265TranscoderObserver;
+
+declare module '../IAgoraH265Transcoder' {
+  interface IH265Transcoder {
+    _addListenerPreCheck<EventType extends keyof IH265TranscoderEvent>(
+      eventType: EventType
+    ): boolean;
+
+    /**
+     * @ignore
+     */
+    addListener<EventType extends keyof IH265TranscoderEvent>(
+      eventType: EventType,
+      listener: IH265TranscoderEvent[EventType]
+    ): void;
+
+    /**
+     * @ignore
+     */
+    removeListener<EventType extends keyof IH265TranscoderEvent>(
+      eventType: EventType,
+      listener?: IH265TranscoderEvent[EventType]
+    ): void;
+
+    /**
+     * @ignore
+     */
+    removeAllListeners<EventType extends keyof IH265TranscoderEvent>(
+      eventType?: EventType
+    ): void;
+
+    /**
+     * @ignore
+     */
+    release(): void;
+  }
+}

package/ts/Private/extension/IAgoraLogExtension.ts

@@ -0,0 +1 @@
+export {};