@agora-js/media 4.24.5 → 4.24.7

package/media.d.ts

@@ -264,6 +264,12 @@ declare class AudioElementPlayCenter {
     private elementStateMap;
     private elementsNeedToResume;
     private sinkIdMap;
+    /**
+     * element → 当前 trackId 的可变持有者。
+     * 事件监听闭包读它拿「当前 id」，而不是捕获创建时的 id；
+     * 这样预渲染移交后 reuseTrackId 只改一处，监听器就写到新 id 上（见 reuseTrackId）。
+     */
+    private elementIdMap;
     constructor();
     setSinkID(trackId: string, deviceID: string): Promise<void>;
     play(track: MediaStreamTrack, trackId: string, volume: number, sessionId?: string): void;
@@ -272,6 +278,12 @@ declare class AudioElementPlayCenter {
     setVolume(trackId: string, volume: number): void;
     getVolume(trackId: string): number;
     stop(trackId: string): void;
+    /**
+     * 预渲染移交：把已在播放的 <audio> 从临时 id 迁移到 track 的正式 id（getTrackId()）。
+     * 参照 RemoteVideoTrack 复用 _prePlayer 的思路——渲染层归属 track 自己的身份，
+     * 而不是让 track 长期追着一个临时 id。迁移 3 张 map + 更新事件监听读取的 id 持有者。
+     */
+    reuseTrackId(fromId: string, toId: string): void;
     private bindAudioElementEvents;
     getPlayerState(trackId: string): string;
     /**
@@ -4452,6 +4464,14 @@ export declare class RemoteAudioTrack extends RemoteTrack implements IRemoteAudi
     getStats(): RemoteAudioTrackStats;
     play(): void;
     stop(): void;
+    /**
+     * 预渲染移交：join 时（UID 未知）音频已用临时 id 起播，这里把渲染层交给正式构造出来的 track。
+     * 必须按后端分两路——预渲染恒走 <audio>，但本 track 可能配置成 WebAudio：
+     *  - <audio> 后端：把预渲染那个元素 re-key 到 getTrackId()，track 之后一律用自己的 id。
+     *  - WebAudio 后端：预渲染的 <audio> 是「错的后端」，拆掉它、改由 WebAudio source 接管
+     *    （参照 setAmplifiedVolume 的 audio-element→WebAudio 适配：stop 元素 + 启 _source）。
+     */
+    _reusePreAudioElement(tempId: string, isPlaying: boolean): void;
     _destroy(): void;
     _isFreeze(): boolean;
     protected _updatePlayerSource(updateWebAudioSource?: boolean): void;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agora-js/media",
-	"version": "4.24.5",
+	"version": "4.24.7",
 	"description": "media module across @agora-js packages",
 	"main": "AgoraRTC_N-media.js",
 	"module": "AgoraRTC_N-media.esm.mjs",
@@ -23,8 +23,8 @@
 	"homepage": "https://api-ref.agora.io/en/voice-sdk/web/4.x/index.html",
 	"peerDependencies": {},
 	"dependencies": {
-		"@agora-js/shared": "4.24.5",
-		"@agora-js/report": "4.24.5",
+		"@agora-js/shared": "4.24.7",
+		"@agora-js/report": "4.24.7",
 		"axios": "^1.16.1",
 		"agora-rte-extension": "^1.2.4",
 		"agora-rte-extension-ng": "^1.0.3",

package/rtc-sdk-media_en.d.ts

@@ -172,6 +172,7 @@ declare class AudioElementPlayCenter {
     private elementStateMap;
     private elementsNeedToResume;
     private sinkIdMap;
+    private elementIdMap;
     constructor();
     setSinkID(trackId: string, deviceID: string): Promise<void>;
     play(track: MediaStreamTrack, trackId: string, volume: number, sessionId?: string): void;
@@ -180,6 +181,7 @@ declare class AudioElementPlayCenter {
     setVolume(trackId: string, volume: number): void;
     getVolume(trackId: string): number;
     stop(trackId: string): void;
+    reuseTrackId(fromId: string, toId: string): void;
     private bindAudioElementEvents;
     getPlayerState(trackId: string): string;
     private autoResumeAudioElement;
@@ -2778,6 +2780,7 @@ export declare class RemoteAudioTrack extends RemoteTrack implements IRemoteAudi
     getStats(): RemoteAudioTrackStats;
     play(): void;
     stop(): void;
+    _reusePreAudioElement(tempId: string, isPlaying: boolean): void;
     _destroy(): void;
     _isFreeze(): boolean;
     protected _updatePlayerSource(updateWebAudioSource?: boolean): void;