yjz-web-sdk 1.0.0

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

@@ -0,0 +1,36 @@
+import { EventEmitter } from 'eventemitter3';
+import { ChannelDataType } from '../data/WebRTCDataType';
+import type { WebRTCConfig } from "./WebRTCConfig.ts";
+export declare class WebRTCClient extends EventEmitter {
+    private config;
+    private peerConnection;
+    private localStream;
+    private isPushingStream;
+    private dataChannel;
+    private statsTimer;
+    private lastReportTime;
+    private lastBytesReceived;
+    private lastPacketsLost;
+    private lastPacketsReceived;
+    private lostPacketCount;
+    private maxLostRate;
+    private decodedCount;
+    private lastSecondDecodedCount;
+    constructor(config: WebRTCConfig);
+    startPush(): Promise<void>;
+    handleOffer(offerSdp: RTCSessionDescriptionInit): void;
+    handleAnswer(answerSdp: RTCSessionDescriptionInit): void;
+    handleIceCandidate(candidate: RTCIceCandidateInit): void;
+    sendChannelData(type: ChannelDataType, data: any): void;
+    closeConnection(): void;
+    private readyCapture;
+    private getRotatedStream;
+    private setVideoParams;
+    stopPush(): void;
+    private resetPeerConnection;
+    private configDataChannel;
+    private handleDataChannelMessage;
+    private checkStats;
+    private processStats;
+    private getConnectionType;
+}

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

@@ -0,0 +1,25 @@
+export interface WebRTCConfigOptions {
+    signalServerUrl?: string;
+    myId?: string;
+    roomId?: string;
+    targetId?: string;
+    stunServerUri?: string;
+    stunServerUriAli?: string;
+    stunServerUriTel?: string;
+    turnServerUri?: string;
+    turnServerUserName?: string;
+    turnServerPassword?: string;
+}
+export declare class WebRTCConfig {
+    signalServerUrl: string;
+    myId: string;
+    roomId: string;
+    targetId: string;
+    stunServerUri: string;
+    stunServerUriAli: string;
+    stunServerUriTel: string;
+    turnServerUri: string;
+    turnServerUserName: string;
+    turnServerPassword: string;
+    constructor(options?: WebRTCConfigOptions);
+}

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

@@ -0,0 +1,8 @@
+import { type WebRtcError } from "../data/WebRtcError.ts";
+import { WebRTCConfig } from "./WebRTCConfig.ts";
+export declare const setRemoteDescriptionWithHandleOffer: (peerConnection: RTCPeerConnection, sdp: string, sendAnswer?: (sdp: string) => void, onError?: (err: WebRtcError) => void) => void;
+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 addIceCandidate: (peerConnection: RTCPeerConnection, candidate: RTCIceCandidateInit, onError?: (error: WebRtcError) => void) => void;

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

@@ -0,0 +1,22 @@
+import { EventEmitter } from "eventemitter3";
+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;
+    /**
+     * 关闭 WebSocket 连接，并通知外部
+     */
+    close(): void;
+    /**
+     * 发送消息到服务端
+     * @param message - 消息字符串
+     */
+    sendMessage(message: string): void;
+    sendSignInMessage(): void;
+}

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

@@ -0,0 +1,16 @@
+/**
+ * 根据浏览器 KeyboardEvent 计算 Android 平台的 meta 状态值
+ * @param event - 浏览器的 KeyboardEvent
+ * @returns 计算后的 meta 状态
+ */
+export declare const computeAndroidMetaState: (event: KeyboardEvent) => number;
+export interface KeyEventData {
+    androidKeyCode: number;
+    metaState: number;
+}
+/**
+ * 根据 KeyboardEvent 生成 Android 平台下的按键数据
+ * @param event - 浏览器的 KeyboardEvent 对象
+ * @returns 包含 androidKeyCode 和 metaState 的对象
+ */
+export declare const getKeyEventData: (event: KeyboardEvent) => KeyEventData;

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

@@ -0,0 +1,26 @@
+/**
+ * 根据视图和云端流的尺寸、角度及输入坐标，转换为相应的坐标值
+ * @param viewWidth 视图宽度
+ * @param viewHeight 视图高度
+ * @param cloudWidth 云端流宽度
+ * @param cloudHeight 云端流高度
+ * @param viewAngle 视图旋转角度（0 或 -90）
+ * @param streamAngle 流旋转角度（0 或 -90）
+ * @param inputX 输入 X 坐标
+ * @param inputY 输入 Y 坐标
+ * @returns 转换后的坐标 [x, y]，若超出有效区域则返回 null
+ */
+export declare function transformCoordinate(viewWidth: number, viewHeight: number, cloudWidth: number, cloudHeight: number, viewAngle: number, streamAngle: number, inputX: number, inputY: number): [number, number] | null;
+/**
+ * 将输入坐标转换为百分比值（相对于视图尺寸），并考虑云端流的宽高比例
+ * @param viewWidth 视图宽度
+ * @param viewHeight 视图高度
+ * @param cloudWidth 云端流宽度
+ * @param cloudHeight 云端流高度
+ * @param viewAngle 视图旋转角度（0 或 -90）
+ * @param streamAngle 流旋转角度（0 或 -90）
+ * @param inputX 输入 X 坐标
+ * @param inputY 输入 Y 坐标
+ * @returns [xRatio, yRatio] 百分比比例值
+ */
+export declare function valueToPercentage(viewWidth: number, viewHeight: number, cloudWidth: number, cloudHeight: number, viewAngle: number, streamAngle: number, inputX: number, inputY: number): [number, number];

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+import { WebRTCSdk } from './core/WebRTCSdk.ts';
+import { getKeyEventData } from "./core/util/KeyCodeUtil.ts";
+import { transformCoordinate, valueToPercentage } from "./core/util/ScreenControlUtil.ts";
+import { ActionType, ChannelDataType, ContainerDirection, InputData, KeyEventData, TouchData } from "./core/data/WebrtcDataType.ts";
+import { EmitType } from "./core/data/WebRtcError.ts";
+export { WebRTCSdk, getKeyEventData, transformCoordinate, valueToPercentage, ActionType, ChannelDataType, InputData, KeyEventData, TouchData, ContainerDirection, EmitType };

package/lib/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>