aliyun-rtc-sdk 7.2.2 → 7.2.4

package/dist/plugins/audioProcessPlugin.d.ts

@@ -1027,6 +1027,11 @@ declare class AliRtcLocalStreamInfo extends EventEmitter$1<AliRtcLocalStreamList
      * @param publishStream
      */
     cloneVideoProfile(publishStream: LocalStream): Promise<void>;
+    /**
+     * 复制音频 profile 到指定 LocalStream
+     * @param publishStream
+     */
+    cloneAudioProfile(publishStream: LocalStream): Promise<void>;
     addPlugin(plugin: AliRtcPlugin): void;
     removePlugin(plugin: AliRtcPlugin): boolean;
 }

package/dist/plugins/beautyPlugin.d.ts

@@ -1028,6 +1028,11 @@ declare class AliRtcLocalStreamInfo extends EventEmitter$1<AliRtcLocalStreamList
      * @param publishStream
      */
     cloneVideoProfile(publishStream: LocalStream): Promise<void>;
+    /**
+     * 复制音频 profile 到指定 LocalStream
+     * @param publishStream
+     */
+    cloneAudioProfile(publishStream: LocalStream): Promise<void>;
     addPlugin(plugin: AliRtcPlugin): void;
     removePlugin(plugin: AliRtcPlugin): boolean;
 }

package/dist/types/index.d.ts

@@ -1022,10 +1022,17 @@ declare class AliRtcEngine_2 extends default_2<AliRtcEngineEventListener> {
      * @param dataChannelMsg 伴奏控制消息
      */
     sendDataChannelMessage(dataChannelMsg: AliRtcDataChannelMsg): void;
+    /**
+     * @brief 不依赖入会，直接订阅远程流
+     * @param config 订阅配置对象
+     * @returns RemoteStreamHandler 远端流处理器实例
+     */
+    subscribeRemoteStream(config: SubscribeRemoteStreamConfig): RemoteStreamHandler;
 }
 
 declare interface AliRtcEngineConfig {
     env?: AliRtcEnv;
+    globalEnv?: 'DEFAULT' | 'SEA';
     webTrack?: boolean | AliRtcWebTrackConfig;
     maxSignalingReconnectDuration?: number;
     parameter?: Parameter;
@@ -1918,6 +1925,11 @@ export declare class AliRtcLocalStreamInfo extends default_2<AliRtcLocalStreamLi
      * @param publishStream
      */
     cloneVideoProfile(publishStream: LocalStream): Promise<void>;
+    /**
+     * 复制音频 profile 到指定 LocalStream
+     * @param publishStream
+     */
+    cloneAudioProfile(publishStream: LocalStream): Promise<void>;
     addPlugin(plugin: AliRtcPlugin): void;
     removePlugin(plugin: AliRtcPlugin): boolean;
 }
@@ -1947,7 +1959,7 @@ export declare enum AliRtcLogLevel {
 /**
  * @brief 网络质量类型
  */
-declare enum AliRtcNetworkQuality {
+export declare enum AliRtcNetworkQuality {
     /** 网络极好 */
     AliRtcNetworkExcellent = 0,
     /** 网络好 */
@@ -3061,14 +3073,18 @@ declare class LogClient {
     protected param?: any;
     protected msgCacheArr: any[];
     protected index: number;
-    protected stsOpt?: any;
-    protected slsToken?: SLSSTSToken;
-    protected ossToken?: OSSSTSToken;
     protected ntpClock: NTPClient;
-    constructor();
+    private clientId;
+    private stsData?;
+    private stsExpiration;
+    private updateTaskTimer?;
+    private globalEnv;
+    constructor(globalEnv?: 'DEFAULT' | 'SEA');
     private createTracker;
+    private startSTSUpdateTask;
+    private refreshSTSToken;
+    private requestSTSToken;
     start(info: AliRtcAuthInfo): void;
-    updateToken(slsToken: SLSSTSToken, ossToken?: OSSSTSToken): void;
     /**
      * 断开连接
      */
@@ -3141,24 +3157,6 @@ declare class NTPClient {
     now(): number;
 }
 
-declare interface OSSSTSToken {
-    access_key_id: string;
-    access_key_secret: string;
-    security_token: string;
-    region_endpoint: string;
-    bucket_name: string;
-    expiration: number;
-}
-
-declare interface OSSToken {
-    access_key_id: string;
-    access_key_secret: string;
-    security_token: string;
-    region_endpoint: string;
-    bucket_name: string;
-    expiration: number;
-}
-
 declare interface PackageAdaptInfo {
     os_name: string;
     device_name: string;
@@ -3420,6 +3418,87 @@ declare interface RemoteMediaTrackInfo extends MediaTrackInfo {
     subscribeState?: RemoteTrackSubscribeState;
 }
 
+/**
+ * 远端流订阅失败原因
+ */
+declare enum RemoteStreamErrorReason {
+    /** 无法获取播放地址 */
+    FETCH_STREAM_URL_FAILED = "FETCH_STREAM_URL_FAILED",
+    /** 目标用户没有可用的流 */
+    NO_STREAM_AVAILABLE = "NO_STREAM_AVAILABLE",
+    /** 无效的播放元素 */
+    INVALID_VIEW_ELEMENT = "INVALID_VIEW_ELEMENT",
+    /** 订阅失败 */
+    SUBSCRIBE_FAILED = "SUBSCRIBE_FAILED"
+}
+
+declare class RemoteStreamHandler extends default_2<RemoteStreamHandlerEvents> {
+    private config;
+    private static logName;
+    private get logName();
+    private readonly roomServerUrl;
+    private readonly label;
+    private rtsInstance?;
+    private currentStatus;
+    private latestStreamInfo?;
+    private preferredL1Ip?;
+    private usePreferredL1InRetry;
+    private _remoteStream?;
+    /**
+     * 获取代理后的 remoteStream，调用方法时会打印日志
+     */
+    remoteStream?: RemoteStream;
+    private _prevDownlinkStat?;
+    private networkQualityTimer?;
+    constructor(config: SubscribeRemoteStreamConfig);
+    /**
+     * 更新连接状态，只有当状态发生变化时才触发事件
+     */
+    private updateConnectionStatus;
+    /**
+     * 处理错误，使实例进入不可恢复状态，业务侧应销毁实例
+     */
+    private handleError;
+    private fetchStreamUrlAndPlay;
+    /**
+     * 订阅时支持 prefer media server 超时降级
+     * 优先使用 window.__ali_prefer_media_server（测试用），其次使用 l1ip
+     * 如果存在 prefer media server，则设置 3 秒超时，超时后降级到 DNS 解析的 L1 节点
+     */
+    private subscribeWithPreferredL1Fallback;
+    /**
+     * 打印 candidate 协议类型
+     */
+    private logCandidateProtocol;
+    /**
+     * 创建 RemoteStream 的代理，用于拦截方法调用并打印日志
+     */
+    private createRemoteStreamProxy;
+    /**
+     * 启动网络质量检测定时器
+     */
+    private startNetworkQualityTimer;
+    /**
+     * 停止网络质量检测定时器
+     */
+    private stopNetworkQualityTimer;
+    /**
+     * 获取下行网络质量
+     */
+    private getNetworkQuality;
+    dispose(): void;
+}
+
+declare interface RemoteStreamHandlerEvents {
+    connectionStatusChange: (status: AliRtcConnectionStatus) => void;
+    networkQuality: (data: {
+        rtt: number;
+        loss: number;
+        quality: AliRtcNetworkQuality;
+    }) => void;
+    error: (reason: RemoteStreamErrorReason, detail: string) => void;
+}
+
 declare class RemoteStreamInfo extends default_2<StreamListener> {
     /**
      * @ignore
@@ -4078,6 +4157,7 @@ declare class RtsManager extends default_2<RtsManagerEventListener> {
     private dcResolve?;
     private dcReject?;
     private dcConnectingPromise?;
+    private _dcReady;
     private _prevDownlinkStat?;
     private _publishingTracks;
     private parameter;
@@ -4086,6 +4166,7 @@ declare class RtsManager extends default_2<RtsManagerEventListener> {
     private httpPublishUrlMap;
     private httpSubscribeUrlMap;
     private traceIdMap;
+    private subUrlMap;
     constructor(localStreamManager: LocalStreamManager, slsReporter: SLSReporter, parameter: Parameter);
     private createRtsInstance;
     private addRTSListener;
@@ -4136,6 +4217,16 @@ declare class RtsManager extends default_2<RtsManagerEventListener> {
     private getSubConfig;
     private handleHTTPConfig;
     private httpSubscribe;
+    /**
+     * 订阅时支持 preferredSubL1Ip 超时降级
+     * 如果存在 preferredSubL1Ip，则设置 3 秒超时，超时后清除 preferredSubL1Ip，降级到 DNS 解析的 L1 节点
+     */
+    private subscribeWithPreferredL1Fallback;
+    /**
+     * 推流时支持 preferredPubL1Ip 超时降级
+     * 如果存在 preferredPubL1Ip，则设置 3 秒超时，超时后清除 preferredPubL1Ip，降级到 DNS 解析的 L1 节点
+     */
+    private publishWithPreferredL1Fallback;
     private subscribeAdd;
     subscribeDelete(subscribeOptions: RemoteSubscribeOptions): Promise<ISubDeleteResult | undefined>;
     subscribeAddDataChannel(streamUrl: string): Promise<any>;
@@ -4154,6 +4245,10 @@ declare class RtsManager extends default_2<RtsManagerEventListener> {
         msid?: string;
     }): any;
     getPCStats(): Promise<any>;
+    /**
+     * 获取当前使用的 candidate 协议类型（udp/tcp）
+     */
+    private logCandidateProtocol;
     sendSEI(streamUrl: string, data: ArrayBuffer, repeatCount: number, payloadType: number): Promise<void>;
 }
 
@@ -4194,7 +4289,6 @@ declare class SignalingManager extends default_2<RoomServerListener> {
     protected clientRole: AliRtcSdkClientRole;
     protected env: AliRtcEnv;
     protected maxSignalingReconnectDuration?: number;
-    stsManager: StsManager;
     private slsReporter;
     constructor(channelProfile: AliRtcSdkChannelProfile, clientRole: AliRtcSdkClientRole, slsReporter: SLSReporter, env?: AliRtcEnv);
     reset(): void;
@@ -4321,10 +4415,7 @@ declare class SLSReporter {
     protected logClient: LogClient;
     protected authInfo?: AliRtcAuthInfo;
     private ntpClock;
-    private static staticClient;
-    private static getLogClient;
-    static reportOSSUpload(sessionId: string, date: string, responseCode?: number): void;
-    constructor(engine: WrappedAliRtcEngine);
+    constructor(engine: WrappedAliRtcEngine, globalEnv?: 'DEFAULT' | 'SEA');
     private customFields;
     /**
      * 设置通用字段
@@ -4344,7 +4435,6 @@ declare class SLSReporter {
      * @param authInfo
      */
     start(info: AliRtcAuthInfo): void;
-    updateToken(token: SLSSTSToken, ossToken?: OSSSTSToken): void;
     /**
      * 断开连接
      */
@@ -4498,28 +4588,6 @@ declare class SLSReporter {
     protected data2String(data: any): string;
 }
 
-declare interface SLSSTSToken {
-    access_key_id: string;
-    access_key_secret: string;
-    expiration: number;
-    log_store_debug: string;
-    log_store_stats: string;
-    project: string;
-    region_endpoint: string;
-    security_token: string;
-}
-
-declare interface SLSToken {
-    access_key_id: string;
-    access_key_secret: string;
-    security_token: string;
-    region_endpoint: string;
-    project: string;
-    log_store_stats: string;
-    log_store_debug: string;
-    expiration: number;
-}
-
 /**
  * Websocket类
  */
@@ -4628,25 +4696,6 @@ declare interface StreamOptions {
     data?: boolean;
 }
 
-declare class StsManager extends default_2<StsManagerListener> {
-    static logName: string;
-    private env;
-    private authInfo?;
-    private timer?;
-    private slsReporter;
-    private expiration;
-    private skipTime;
-    constructor(slsReporter: SLSReporter, env: AliRtcEnv);
-    refreshAuthInfo(authInfo: AliRtcAuthInfo): void;
-    private requestToken;
-    startSTSUpdate(authInfo: AliRtcAuthInfo): void;
-    clear(): void;
-}
-
-declare interface StsManagerListener {
-    onTokenUpdate: (ossToken: OSSToken, slsToken: SLSToken) => void;
-}
-
 declare interface SubConfig {
     isAudioSubscribing: boolean;
     isVideoSubscribing: boolean;
@@ -4671,6 +4720,18 @@ declare enum SubscribeReason {
     Reconnect = "reconnect"
 }
 
+declare interface SubscribeRemoteStreamConfig {
+    env?: AliRtcEnv;
+    appId: string;
+    currentUserId: string;
+    targetChannelId: string;
+    targetUserId: string;
+    token: string;
+    nonce?: string;
+    timestamp: number;
+    view?: string | HTMLVideoElement;
+}
+
 declare interface TimeRecorder {
     start: number;
     [key: string]: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aliyun-rtc-sdk",
-  "version": "7.2.2",
+  "version": "7.2.4",
   "type": "module",
   "description": "rtc web sdk of aliyun",
   "main": "dist/aliyun-rtc-sdk.umd.js",
@@ -10,7 +10,7 @@
     "@aliyun-sls/web-sts-plugin": "^0.3.5",
     "@aliyun-sls/web-track-browser": "^0.3.5",
     "aliyun-queen-engine": "^6.3.14",
-    "aliyun-rts-sdk": "2.13.8",
+    "aliyun-rts-sdk": "2.14.6",
     "crypto-js": "^4.1.1",
     "dateformat": "^5.0.3",
     "eventemitter3": "^5.0.1",