yjz-web-sdk 1.0.7-beta.2 → 1.0.8-beta.10

package/lib/core/WebRTCSdk.d.ts

@@ -5,17 +5,33 @@ import { WebRTCConfig } from "./rtc/WebRTCConfig.ts";
 import type { WebRTCConfigOptions } from './rtc/WebRTCConfig';
 import { ChannelDataType } from "./data/WebrtcDataType.ts";
 export declare class WebRTCSdk extends EventEmitter {
-    config: WebRTCConfig;
-    signalingClient: SignalingClient;
-    webRTCClient: WebRTCClient;
+    config: WebRTCConfig | null;
+    signalingClient: SignalingClient | null;
+    webRTCClient: WebRTCClient | null;
+    options: WebRTCConfigOptions;
+    isConnected: boolean;
+    isConnecting: boolean;
+    private connectCount;
+    private MAX_COUNT;
+    private timeout;
+    private cache;
     constructor(options: WebRTCConfigOptions);
+    initConfig(): Promise<void>;
     /** 开始连接 signal 服务 */
     startConnection(): void;
+    private prepareConnection;
+    reconnect(): Promise<void>;
+    initConnectConfig(): void;
+    initSignalingClient(): void;
     switchControl(isControl: boolean): void;
+    resetConfig(): void;
     /** 停止连接，并发送退出信令 */
     stop(): void;
     /** 开始推流：触发媒体采集与轨道添加 */
     startPush(): Promise<void>;
+    startPushLocal(file: File): Promise<void>;
+    stopPush(): void;
+    stopPushLocal(): void;
     /** 发送信道数据 */
     sendChannelData(type: ChannelDataType, data: any): void;
     sendControlEvent(key: number): void;
@@ -25,6 +41,7 @@ export declare class WebRTCSdk extends EventEmitter {
      * @param message 信令消息
      */
     private handleSignaling;
+    clearTimer: () => void;
     /** 发送 Offer 信令 */
     sendOffer: (offerSdp: string) => void;
     /** 发送 Answer 信令 */

package/lib/core/data/TurnType.d.ts

@@ -0,0 +1,21 @@
+export type TurnServerConfig = {
+    urls: string;
+    username?: string;
+    credential?: string;
+};
+export interface TurnTestResult extends TurnServerConfig {
+    rtt: number;
+}
+export type PublicTurnTestResult = {
+    urls: string;
+    rtt: number;
+};
+export type TurnTestSummary = {
+    best?: PublicTurnTestResult;
+    all: PublicTurnTestResult[];
+};
+export interface TurnSelectionResult {
+    url?: string;
+    rtt?: number;
+    error?: string;
+}

package/lib/core/data/WebRtcError.d.ts

@@ -14,7 +14,9 @@ export declare enum FailCode {
     DATACHANNEL_ERR = 10013,
     STREAM_STATE = 10014,
     AUTH_FAILED = 10015,
-    KICK_OUT_ERR = 10016
+    KICK_OUT_ERR = 10016,
+    STATE_ERR = 10017,
+    OPTION_ERR = 10018
 }
 export declare const FailInfoMap: Record<FailCode, {
     type: string;
@@ -26,10 +28,20 @@ export interface WebRtcError {
     message: string;
     rawError?: any;
 }
+export declare enum CameraFailCode {
+    LOCAL_STREAM_FAIL = 20001,
+    CAMERA_STREAM_FAIL = 20002
+}
 export declare function createWebRtcError(code: FailCode, rawError?: any): WebRtcError;
+export declare function createCameraError(code: CameraFailCode, message: string): CameraError;
+export interface CameraError {
+    code: CameraFailCode;
+    message: string;
+}
 export declare enum EmitType {
     signalMessage = "signalMessage",
     webrtcError = "webrtcError",
+    cameraError = "cameraError",
     sendAnswer = "sendAnswer",
     sendOffer = "sendOffer",
     sendICEMessage = "sendICEMessage",
@@ -39,5 +51,6 @@ export declare enum EmitType {
     statisticInfo = "statisticInfo",
     cloudClipData = "cloudClipData",
     screenshot = "screenshot",
-    groupError = "groupError"
+    groupError = "groupError",
+    reconnect = "reconnect"
 }

package/lib/core/data/WebrtcDataType.d.ts

@@ -120,7 +120,8 @@ export declare class ClarityData {
 export declare class ChannelData {
     type: ChannelDataType;
     data: string | null;
-    constructor(type: ChannelDataType, data?: string | null);
+    myId: string | null;
+    constructor(type: ChannelDataType, data?: string | null, myId?: string | null);
     toString(): string;
     /**
      * 格式化数据
@@ -144,7 +145,7 @@ export declare class ChannelData {
      * 生成输入数据
      * @param data 输入数据对象
      */
-    static input(data: any): ChannelData;
+    static input(data: any, myId: string): ChannelData;
     /**
      * 生成鼠标滚动数据
      * @param data 输入数据对象

package/lib/core/groupctrl/GroupControllerManager.d.ts

@@ -1,14 +1,11 @@
 import { EventEmitter } from "eventemitter3";
 import type { WebRTCConfigOptions } from "../rtc/WebRTCConfig.ts";
-import { VisibilityManager } from "./VisibilityManager.ts";
 import { SdkController } from "./SdkController.ts";
 import { type ChannelDataType } from "../data/WebrtcDataType.ts";
 export declare class GroupControllerManager extends EventEmitter {
     private configs;
     private controllers;
-    private visibility;
-    private loopManager;
-    constructor(interval?: number, visibility?: VisibilityManager);
+    constructor();
     startControl(configMap: Map<string, WebRTCConfigOptions>): void;
     switchToMain(newRoomId: string, oldRoomId: string): void;
     switchControl(roomId: string, isControl: boolean): void;
@@ -27,9 +24,6 @@ export declare class GroupControllerManager extends EventEmitter {
     getController(roomId: string): SdkController | undefined;
     refreshController(roomId: string): void;
     updateProperty<K extends keyof WebRTCConfigOptions>(roomId: string, key: K, value: WebRTCConfigOptions[K]): void;
-    setVisibility(viewId: string, visible: boolean): void;
-    setViewIds(viewIds: string[], visible: boolean): void;
     sendData(type: ChannelDataType, data: any): void;
     sendControlEvent(key: number): void;
-    private handleLoop;
 }

package/lib/core/rtc/WebRTCClient.d.ts

@@ -5,7 +5,9 @@ export declare class WebRTCClient extends EventEmitter {
     private readonly config;
     private peerConnection;
     private localStream;
+    private rotatedStream;
     private isPushingStream;
+    private isPushingLocalStream;
     private dataChannel;
     private statsTimer;
     private lastReportTime;
@@ -15,6 +17,13 @@ export declare class WebRTCClient extends EventEmitter {
     private lostPacketCount;
     private maxLostRate;
     private lastSecondDecodedCount;
+    private fileVideo?;
+    private canvas?;
+    private canvasStream;
+    private rafId;
+    private currentMedia;
+    private fileImage?;
+    private ua;
     constructor(config: WebRTCConfig);
     startPush(): Promise<void>;
     handleOffer(offerSdp: string): void;
@@ -32,4 +41,14 @@ export declare class WebRTCClient extends EventEmitter {
     private checkStats;
     private processStats;
     private getConnectionType;
+    /** 获取或创建 video 元素（懒初始化） */
+    private getFileVideo;
+    /** 获取或创建 canvas 元素（懒初始化） */
+    private getCanvas;
+    loadMedia(file: File): Promise<void>;
+    startPushLocal: (file: File) => Promise<void>;
+    startCanvasStream(fps?: number): MediaStream;
+    getFileImage(): HTMLImageElement;
+    /** 停止推流并释放资源 */
+    stopLocal(): void;
 }

package/lib/core/rtc/WebRTCConfig.d.ts

@@ -6,7 +6,7 @@ export interface WebRTCConfigOptions {
     stunServerUri?: string;
     stunServerUriAli?: string;
     stunServerUriTel?: string;
-    turnServerUri: string;
+    turnServerUri?: string;
     turnServerUserName?: string;
     turnServerPassword?: string;
     isControl: boolean;
@@ -19,6 +19,13 @@ export interface WebRTCConfigOptions {
     cloudName?: string;
     token: string;
     isGroup: boolean;
+    turnKey?: Array<string>;
+    hostTurn?: Array<string>;
+    spareTurn?: Array<string>;
+    maxRecount?: number;
+    isCalculate?: boolean;
+    traceId?: string;
+    signAgain?: boolean;
 }
 export declare class WebRTCConfig {
     signalServerUrl: string;
@@ -37,5 +44,7 @@ export declare class WebRTCConfig {
     screenshotQuality: number;
     token: string;
     isGroup: boolean;
+    turnKey: Array<string>;
+    traceId: string;
     constructor(options: WebRTCConfigOptions);
 }

package/lib/core/rtc/WebRtcNegotiate.d.ts

@@ -4,5 +4,6 @@ export declare const setRemoteDescriptionWithHandleOffer: (peerConnection: RTCPe
 export declare const createPeerConnection: (config: WebRTCConfig) => RTCPeerConnection;
 export declare const configPeerConnection: (peerConnection: RTCPeerConnection, onICEMessage: (candidate: string) => void, onTrack?: (track: MediaStreamTrack) => void, onConnectState?: (state: RTCIceConnectionState) => void, onError?: (error: WebRtcError) => void) => void;
 export declare const setRemoteDescriptionWithHandleAnswer: (peerConnection: RTCPeerConnection, sdp: string, onError?: (error: WebRtcError) => void) => void;
-export declare const createOffer: (peerConnection: RTCPeerConnection, sendOfferMessage: (sdp: string) => void, onError?: (error: WebRtcError) => void) => void;
+export declare const createOffer: (peerConnection: RTCPeerConnection, sendOfferMessage: (sdp: string) => void) => Promise<void>;
+export declare const setLocalDescriptionWithCreateOffer: (peerConnection: RTCPeerConnection, offer: RTCSessionDescriptionInit, sendOfferMessage: (sdp: string) => void) => Promise<void>;
 export declare const addIceCandidate: (peerConnection: RTCPeerConnection, candidate: RTCIceCandidateInit, onError?: (error: WebRtcError) => void) => void;

package/lib/core/signal/SignalingClient.d.ts

@@ -3,11 +3,14 @@ import type { WebRTCConfig } from "../rtc/WebRTCConfig.ts";
 export declare class SignalingClient extends EventEmitter {
     private config;
     private webSocket;
+    private timeout;
     constructor(config: WebRTCConfig);
     /**
      * 启动 WebSocket 连接，并注册各事件处理
      */
     start(): void;
+    timeStart(): void;
+    clearTime(): void;
     /**
      * 关闭 WebSocket 连接，并通知外部
      */

package/lib/core/util/FileTypeUtils.d.ts

@@ -0,0 +1,5 @@
+export type FileKind = 'video' | 'image' | 'unknown';
+export declare class FileTypeUtils {
+    /** 读取文件头并判断类型 */
+    static detectFileType(file: File): Promise<FileKind>;
+}

package/lib/core/util/KeyCodeUtil.d.ts

@@ -1,13 +1,10 @@
+import { KeyEventData } from "../data/WebrtcDataType.ts";
 /**
  * 根据浏览器 KeyboardEvent 计算 Android 平台的 meta 状态值
  * @param event - 浏览器的 KeyboardEvent
  * @returns 计算后的 meta 状态
  */
 export declare const computeAndroidMetaState: (event: KeyboardEvent) => number;
-export interface KeyEventData {
-    keyCode: number;
-    meta: number;
-}
 /**
  * 根据 KeyboardEvent 生成 Android 平台下的按键数据
  * @param event - 浏览器的 KeyboardEvent 对象

package/lib/core/util/MapCache.d.ts

@@ -0,0 +1,18 @@
+export declare class MapCache {
+    private key;
+    private maxSize;
+    private expire;
+    constructor(key: string, maxSize?: number, expireMs?: number);
+    /** 读取 Map（自动清理过期） */
+    getMap(): Map<string, any>;
+    /** 保存 Map（附带时间戳） */
+    private saveMap;
+    /** 设置值（超出 maxSize 删除最早的） */
+    set(key: string, value: any): void;
+    /** 获取值（过期自动清空） */
+    get(key: string): any;
+    /** 删除 */
+    delete(key: string): void;
+    /** 清空 */
+    clear(): void;
+}

package/lib/core/util/TurnTestUtil.d.ts

@@ -0,0 +1,6 @@
+import type { TurnSelectionResult, TurnServerConfig, TurnTestResult, TurnTestSummary } from "../data/TurnType.ts";
+import type { WebRTCConfigOptions } from "../rtc/WebRTCConfig.ts";
+export declare const testTurnServer: (turnConfig: TurnServerConfig, timeoutMs?: number) => Promise<TurnTestResult>;
+export declare const testMultipleTurnServers: (servers: string[], timeoutMs?: number) => Promise<TurnTestSummary>;
+export declare const areTurnListsEmpty: (options: WebRTCConfigOptions) => boolean;
+export declare const selectBestTurnServer: (turnList: string[]) => Promise<TurnSelectionResult>;

package/lib/index.d.ts

@@ -1,9 +1,11 @@
 import { WebRTCSdk } from './core/WebRTCSdk';
 import { getKeyEventData } from "./core/util/KeyCodeUtil";
+import { testMultipleTurnServers } from './core/util/TurnTestUtil';
 import { transformCoordinate, valueToPercentage } from "./core/util/ScreenControlUtil";
 import { ActionType, ChannelDataType, ContainerDirection, InputData, KeyEventData, TouchData, WheelData, GestureData, type ActionCommand, ActionCommandType, ActionCommandEventType, ActionCommandEventValue, TrackEventData, ClarityData } from "./core/data/WebrtcDataType";
+import { type TurnServerConfig, type TurnTestResult, type TurnTestSummary } from "./core/data/TurnType";
 import type { WebRTCConfigOptions } from './core/rtc/WebRTCConfig';
-import { GroupControllerManager } from "./core/groupctrl/GroupControllerManager.ts";
-import { EmitType } from "./core/data/WebRtcError";
+import { GroupControllerManager } from "./core/groupctrl/GroupControllerManager";
+import { EmitType, type CameraError, type WebRtcError } from "./core/data/WebRtcError";
 import RemotePlayer from './components/RemotePlayer/index.vue';
-export { WebRTCSdk, getKeyEventData, transformCoordinate, valueToPercentage, ActionType, ChannelDataType, InputData, KeyEventData, TouchData, ContainerDirection, EmitType, WheelData, GestureData, ClarityData, type ActionCommand, ActionCommandType, GroupControllerManager, type WebRTCConfigOptions, ActionCommandEventType, ActionCommandEventValue, RemotePlayer, TrackEventData };
+export { WebRTCSdk, getKeyEventData, transformCoordinate, valueToPercentage, ActionType, ChannelDataType, InputData, KeyEventData, TouchData, ContainerDirection, EmitType, WheelData, GestureData, ClarityData, type ActionCommand, ActionCommandType, GroupControllerManager, type WebRTCConfigOptions, ActionCommandEventType, ActionCommandEventValue, RemotePlayer, TrackEventData, type TurnServerConfig, type TurnTestResult, type TurnTestSummary, testMultipleTurnServers, type CameraError, type WebRtcError };