@agora-js/media 4.23.1 → 4.23.2-2

package/media.d.ts

@@ -1409,12 +1409,17 @@ declare function event_beauty_effect_overload(): void;
 /**
  * 首帧音频或视频解码时触发。
  *
+ * > 注意：
+ * > 该事件只有在本地调用了 [IRemoteTrack.play]{@link play} 后才会触发。
  * @event
  * @asMemberOf IRemoteTrack
  */
 /** @en
  * Occurs when the first remote audio or video frame is decoded.
  *
+ * > Note:
+ * > To trigger this callback, the local client needs to call [IRemoteTrack.play]{@link play}.
+ *
  * @event
  * @asMemberOf IRemoteTrack
  */
@@ -1720,6 +1725,14 @@ export declare function getElectronScreenStreamByUserSelect(config: ScreenConstr
 
 export declare function getLocalStream(config: GetUserMediaConfig, id: string): Promise<MediaStream>;
 
+/**
+ * 获取新的视频码率
+ * @param width
+ * @param height
+ * @param fps
+ */
+export declare function getNewNearestVideoProfile(width: number, height: number, frameRate: number): any;
+
 /**
  * 获取初始配置
  * 分辨率：track.getMediaStreamTrackSettings > 客户设置
@@ -2883,25 +2896,25 @@ export declare interface IMicrophoneAudioTrack extends ILocalAudioTrack {
     setEnabled(enabled: boolean): Promise<void>;
 }
 
-declare interface InterceptAudioFrameOptions {
-    enableTopn?: boolean;
-    enableMetadata?: boolean;
-    onMetadata?: (metadata: Uint8Array) => void;
-}
+export declare function interceptLocalAudioFrame(sender: RTCRtpSender, options?: InterceptLocalAudioFrameOptions): Promise<void>;
 
-declare interface InterceptAudioFrameOptions_2 {
+export declare interface InterceptLocalAudioFrameOptions {
     metadata?: () => Uint8Array | undefined;
 }
 
-export declare function interceptLocalAudioFrame(sender: RTCRtpSender, options?: InterceptAudioFrameOptions_2): Promise<void>;
-
 export declare function interceptLocalVideoFrame(sender: RTCRtpSender, localVideoTrack: LocalVideoTrack): Promise<void>;
 
-export declare function interceptRemoteAudioFrame(receiver: RTCRtpReceiver, options?: InterceptAudioFrameOptions): Promise<void>;
+export declare function interceptRemoteAudioFrame(receiver: RTCRtpReceiver, options?: InterceptRemoteAudioFrameOptions): Promise<void>;
+
+export declare interface InterceptRemoteAudioFrameOptions {
+    enableTopn?: boolean;
+    enableMetadata?: boolean;
+    onMetadata?: (metadata: Uint8Array) => void;
+}
 
 export declare function interceptRemoteVideoFrame(receiver: RTCRtpReceiver, options?: InterceptVideoFrameOptions): Promise<void>;
 
-declare interface InterceptVideoFrameOptions {
+export declare interface InterceptVideoFrameOptions {
     onSei?: (sei: Uint8Array) => void;
 }
 
@@ -3700,6 +3713,7 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     setBeautyEffect(enabled: boolean, options?: BeautyEffectOptions): Promise<void>;
     getCurrentFrameData(): ImageData;
     getCurrentFrameImage(imageType: string, quality?: number): Promise<ImageTypedData>;
+    findClosestProfile(): Promise<void>;
     setBitrateLimit(bitrateLimit: {
         max_bitrate: number;
         min_bitrate: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agora-js/media",
-	"version": "4.23.1",
+	"version": "4.23.2-2",
 	"description": "media module across @agora-js packages",
 	"main": "AgoraRTC_N-media.js",
 	"module": "AgoraRTC_N-media.esm.mjs",
@@ -23,9 +23,9 @@
 	"homepage": "https://api-ref.agora.io/en/voice-sdk/web/4.x/index.html",
 	"peerDependencies": {},
 	"dependencies": {
-		"@agora-js/shared": "4.23.1",
-		"@agora-js/report": "4.23.1",
-		"axios": "^1.7.7",
+		"@agora-js/shared": "4.23.2-2",
+		"@agora-js/report": "4.23.2-2",
+		"axios": "^1.8.3",
 		"agora-rte-extension": "^1.2.4",
 		"webrtc-adapter": "8.2.0"
 	}

package/rtc-sdk-media_en.d.ts

@@ -923,6 +923,9 @@ declare function event_beauty_effect_overload(): void;
 /**
  * Occurs when the first remote audio or video frame is decoded.
  *
+ * > Note:
+ * > To trigger this callback, the local client needs to call [IRemoteTrack.play]{@link play}.
+ *
  * @event
  * @asMemberOf IRemoteTrack
  */
@@ -1125,6 +1128,8 @@ export declare function getElectronScreenStreamByUserSelect(config: ScreenConstr
 
 export declare function getLocalStream(config: GetUserMediaConfig, id: string): Promise<MediaStream>;
 
+export declare function getNewNearestVideoProfile(width: number, height: number, frameRate: number): any;
+
 export declare const getOriginSenderConfig: (track: LocalVideoTrack) => {
     frameRate: number;
     bitrateMax: number;
@@ -1770,25 +1775,25 @@ export declare interface IMicrophoneAudioTrack extends ILocalAudioTrack {
     setEnabled(enabled: boolean): Promise<void>;
 }
 
-declare interface InterceptAudioFrameOptions {
-    enableTopn?: boolean;
-    enableMetadata?: boolean;
-    onMetadata?: (metadata: Uint8Array) => void;
-}
+export declare function interceptLocalAudioFrame(sender: RTCRtpSender, options?: InterceptLocalAudioFrameOptions): Promise<void>;
 
-declare interface InterceptAudioFrameOptions_2 {
+export declare interface InterceptLocalAudioFrameOptions {
     metadata?: () => Uint8Array | undefined;
 }
 
-export declare function interceptLocalAudioFrame(sender: RTCRtpSender, options?: InterceptAudioFrameOptions_2): Promise<void>;
-
 export declare function interceptLocalVideoFrame(sender: RTCRtpSender, localVideoTrack: LocalVideoTrack): Promise<void>;
 
-export declare function interceptRemoteAudioFrame(receiver: RTCRtpReceiver, options?: InterceptAudioFrameOptions): Promise<void>;
+export declare function interceptRemoteAudioFrame(receiver: RTCRtpReceiver, options?: InterceptRemoteAudioFrameOptions): Promise<void>;
+
+export declare interface InterceptRemoteAudioFrameOptions {
+    enableTopn?: boolean;
+    enableMetadata?: boolean;
+    onMetadata?: (metadata: Uint8Array) => void;
+}
 
 export declare function interceptRemoteVideoFrame(receiver: RTCRtpReceiver, options?: InterceptVideoFrameOptions): Promise<void>;
 
-declare interface InterceptVideoFrameOptions {
+export declare interface InterceptVideoFrameOptions {
     onSei?: (sei: Uint8Array) => void;
 }
 
@@ -2287,6 +2292,7 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     setBeautyEffect(enabled: boolean, options?: BeautyEffectOptions): Promise<void>;
     getCurrentFrameData(): ImageData;
     getCurrentFrameImage(imageType: string, quality?: number): Promise<ImageTypedData>;
+    findClosestProfile(): Promise<void>;
     setBitrateLimit(bitrateLimit: {
         max_bitrate: number;
         min_bitrate: number;