yjz-web-sdk 1.0.10 → 1.0.11-beta.1

package/src/core/WebRTCSdk.ts

@@ -1,561 +0,0 @@
-import {EventEmitter} from 'eventemitter3'
-import {SignalingClient} from './signal/SignalingClient'
-import {WebRTCClient} from './rtc/WebRTCClient'
-import type {WebRTCConfigOptions} from './rtc/WebRTCConfig'
-import {WebRTCConfig} from './rtc/WebRTCConfig'
-import {ConnectorType, MessageType, SendType} from './data/MessageType'
-import {
-  ChannelData,
-  ChannelDataType,
-  type CloudStatusPayload,
-  KeyEventData,
-  type ScreenStats,
-} from './data/WebrtcDataType'
-import {
-  type CameraError,
-  CameraFailCode,
-  createCameraError,
-  createWebRtcError,
-  EmitType,
-  FailCode,
-  type WebRtcError,
-} from './data/WebRtcError'
-import {areTurnListsEmpty, selectBestTurnServer} from './util/TurnTestUtil'
-// import {MapCache} from "./util/MapCache.ts";
-import {enableLog, Logger, setLogLevel} from "./util/Logger";
-import {formattedTime} from "./util/FileTypeUtils";
-
-export class WebRTCSdk extends EventEmitter {
-  public config: WebRTCConfig | null = null
-  public signalingClient: SignalingClient | null = null
-  public webRTCClient: WebRTCClient | null = null
-  public options: WebRTCConfigOptions
-  public isConnected: boolean = false
-  public isConnecting: boolean = false
-  private connectCount: number = 0
-  private MAX_COUNT: number = 1
-  private timeout: ReturnType<typeof setTimeout> | null = null
-
-  constructor(options: WebRTCConfigOptions) {
-    super()
-    // 初始化配置
-    this.options = options
-    if(this.options.connectorType !== ConnectorType.LanForwarding) {
-      enableLog(!!this.options.enableLogger);
-      if(this.options.enableLogger !== undefined && this.options.enableLogger){
-        if(this.options.loggerLevel !== undefined) {
-          setLogLevel(this.options.loggerLevel);
-        }
-      }
-    }
-
-    if(this.options.maxRecount){
-      this.MAX_COUNT = this.options.maxRecount;
-    }
-  }
-
-  async initConfig(): Promise<void> {
-    if (!this.options || Object.keys(this.options).length === 0) {
-      throw createWebRtcError(FailCode.OPTION_ERR, 'option null');
-    }
-
-    if (areTurnListsEmpty(this.options)) {
-      throw createWebRtcError(FailCode.OPTION_ERR, '中继配置为空');
-    }
-
-    const tryTurnList = async (list: string[], isHost: boolean): Promise<boolean> => {
-      if (list.length === 0) return false;
-      try {
-        const result = await selectBestTurnServer(list)
-        if (result.url && typeof result.rtt === 'number') {
-          if(isHost && result.rtt > 150) {
-            return false;
-          }
-          this.options.turnServerUri = result.url;
-          this.options.turnKey = [result.url];
-          return true;
-        } else {
-          return false;
-        }
-      } catch (e) {
-        return false;
-      }
-    };
-
-    const triedHost = this.options.hostTurn?.length
-        ? await tryTurnList(this.options.hostTurn, true)
-        : false;
-    if (!triedHost && this.options.spareTurn?.length) {
-      const allTurns = (this.options.hostTurn ?? []).concat(this.options.spareTurn ?? []);
-      const triedSpare = await tryTurnList(allTurns, false);
-      if (!triedSpare) {
-        if (this.options.turnServerUri) {
-          this.options.turnKey = [this.options.turnServerUri];
-        }else {
-          throw createWebRtcError(FailCode.OPTION_ERR, '暂无可用TURN服务器');
-        }
-      }
-    } else if (!triedHost) {
-      const triedSpare = await tryTurnList(this.options.hostTurn?? [], false);
-      if (!triedSpare) {
-        if (this.options.turnServerUri) {
-          this.options.turnKey = [this.options.turnServerUri];
-        }else {
-          throw createWebRtcError(FailCode.OPTION_ERR, '暂无可用TURN服务器');
-        }
-      }
-    }
-  }
-
-  /** 开始连接 signal 服务 */
-  public startConnection(): void {
-    this.prepareConnection().catch((err) => {
-      Logger.error('错误信息：', `sdk调试错误日志======>`, err)
-      this.emit(EmitType.webrtcError, err)
-    })
-  }
-
-  private async prepareConnection(): Promise<void> {
-    if (this.isConnecting) return
-    this.isConnecting = true
-    try {
-      if (areTurnListsEmpty(this.options)) {
-        if (!this.options.turnServerUri) {
-          Logger.error('错误信息：', `sdk调试错误日志======> 暂无可用TURN服务器`)
-          this.emit(EmitType.webrtcError, createWebRtcError(FailCode.OPTION_ERR, '暂无可用TURN服务器'))
-          return
-        }
-      } else {
-        await this.initConfig()
-      }
-      this.initConnectConfig()
-      this.initSignalingClient()
-      this.signalingClient?.start()
-    }
-    catch (e) {
-      this.isConnected = false
-      throw e
-    }
-    finally {
-      this.isConnecting = false
-    }
-  }
-
-  public async reconnect(): Promise<void> {
-    this.resetConfig() // 停止当前连接
-    try {
-      await this.prepareConnection() // 重新连接
-    }
-    catch (e) {
-      Logger.error('错误信息：', `sdk调试错误日志======>`, e)
-      this.emit(EmitType.webrtcError, e)
-    }
-  }
-
-  initConnectConfig(initConfig: boolean = true): void {
-    if (initConfig) {
-      this.config = new WebRTCConfig(this.options)
-    }
-    // 初始化 signal 客户端与 WebRTC 客户端
-    if (this.config) {
-      this.webRTCClient = new WebRTCClient(this.config)
-    }
-
-    // 绑定 webRTCClient 事件
-    this.webRTCClient?.on(EmitType.sendOffer, (sdp: string) => this.sendOffer(sdp))
-    this.webRTCClient?.on(EmitType.sendAnswer, (sdp: string) => this.sendAnswer(sdp))
-    this.webRTCClient?.on(EmitType.sendICEMessage, (candidate: string) => this.sendICEMessage(candidate))
-    this.webRTCClient?.on(EmitType.arrayBuffer, (buffer: ArrayBuffer) => this.emit(EmitType.arrayBuffer, buffer))
-    // 绑定 webRTCClient 事件并转发至 SDK 级别
-    this.webRTCClient?.on(EmitType.streamTrack, (track: MediaStreamTrack) => {
-      Logger.debug("调试信息:", '=========> EmitType.streamTrack callback');
-      this.emit(EmitType.streamTrack, track)
-    })
-    this.webRTCClient?.on(EmitType.iceConnectionState, (state: RTCIceConnectionState) => {
-      this.emit(EmitType.iceConnectionState, state)
-      if (state === 'connected') {
-        this.isConnected = true
-      }
-    })
-    this.webRTCClient?.on(EmitType.cloudStatusChanged, (info: CloudStatusPayload) =>
-      this.emit(EmitType.cloudStatusChanged, info),
-    )
-    this.webRTCClient?.on(EmitType.cloudClipData, (clipData: string) =>
-      this.emit(EmitType.cloudClipData, clipData),
-    )
-    this.webRTCClient?.on(EmitType.webrtcError, (err: WebRtcError) => {
-      if (err.code === FailCode.ICE_STATE && this.connectCount < this.MAX_COUNT && this.isConnected) {
-        this.connectCount++
-        this.emit(EmitType.reconnect)
-        this.reconnect()
-      }
-      else {
-        Logger.error('错误信息：', `sdk调试错误日志======>`, err)
-        this.emit(EmitType.webrtcError, err)
-      }
-    })
-    this.webRTCClient?.on(EmitType.cameraError, (err: CameraError) => {
-      this.emit(EmitType.cameraError, err)
-    })
-    this.webRTCClient?.on(EmitType.statisticInfo, (info: ScreenStats) => {
-      this.emit(EmitType.statisticInfo, info)
-    })
-  }
-
-  initSignalingClient(): void {
-    if (this.config) {
-      this.signalingClient = new SignalingClient(this.config)
-
-      // 绑定 signalingClient 事件
-      this.signalingClient.on(EmitType.signalMessage, (message: any) => this.handleSignaling(message))
-      this.signalingClient.on(EmitType.webrtcError, (err: WebRtcError) => {
-        Logger.error('错误信息：', `sdk 信令调试错误日志======>`, err)
-        this.emit(EmitType.webrtcError, err)
-      })
-    }
-  }
-
-  public switchControl(roomId: string, connectorType: ConnectorType): void {
-    this.signalingClient?.sendSwitchControlMessage(roomId, connectorType)
-  }
-
-  public updateConfig(options: WebRTCConfigOptions) {
-    if (this.config) {
-      this.config.roomId = options.roomId
-      this.config.mainRoomIdOfGroup = options.mainRoomIdOfGroup
-      this.config.subRoomIdsOfGroup = options.subRoomIdsOfGroup
-    }
-  }
-
-  public switchControlToMain(roomId: string): void {
-    this.webRTCClient?.closeConnection()
-    this.webRTCClient = null
-    this.initConnectConfig(false)
-    this.signalingClient?.sendSwitchControlToMainMessage(roomId)
-  }
-
-  public resetConfig(): void {
-    this.sendSignOut()
-    this.signalingClient?.close()
-    this.webRTCClient?.closeConnection()
-    this.signalingClient = null
-    this.webRTCClient = null
-    this.config = null
-    this.isConnected = false
-    this.isConnecting = false
-  }
-
-  /** 停止连接，并发送退出信令 */
-  public stop(): void {
-    this.sendSignOut()
-    this.signalingClient?.close()
-    this.webRTCClient?.closeConnection()
-    this.removeAllListeners()
-    this.signalingClient = null
-    this.webRTCClient = null
-    this.config = null
-    this.connectCount = 0
-    this.isConnected = false
-    this.isConnecting = false
-  }
-
-  /** 开始推流：触发媒体采集与轨道添加 */
-  public async startPush(): Promise<void> {
-    try {
-      await this.webRTCClient?.startPush()
-    }
-    catch (error) {
-      let errorMessage: string
-      if (error instanceof Error) {
-        errorMessage = error.message // ✅ 只取 message
-      }
-      else {
-        errorMessage = String(error) // 兜底，防止 err 不是 Error 类型
-      }
-      this.emit(
-        EmitType.cameraError,
-        createCameraError(CameraFailCode.CAMERA_STREAM_FAIL, errorMessage),
-      )
-    }
-  }
-
-  public async startPushLocal(file: File): Promise<void> {
-    try {
-      await this.webRTCClient?.startPushLocal(file)
-    }
-    catch (error) {
-      let errorMessage: string
-      if (error instanceof Error) {
-        errorMessage = error.message // ✅ 只取 message
-      }
-      else {
-        errorMessage = String(error) // 兜底，防止 err 不是 Error 类型
-      }
-      this.emit(
-        EmitType.cameraError,
-        createCameraError(CameraFailCode.LOCAL_STREAM_FAIL, errorMessage),
-      )
-    }
-  }
-
-  public stopPush() {
-    this.webRTCClient?.stopPush()
-  }
-
-  public stopPushLocal() {
-    this.webRTCClient?.stopLocal()
-  }
-
-  /** 发送信道数据 */
-  public sendChannelData(type: ChannelDataType, data: any): void {
-    this.webRTCClient?.sendChannelData(type, data)
-  }
-
-  public sendControlEvent(key: number) {
-    const keyEvent = new KeyEventData(key, 0)
-    this.webRTCClient?.sendChannelData(ChannelDataType.ActionInput, keyEvent)
-  }
-
-  public sendGroupAcceptControl(roomIds: string[], acceptControl: boolean) {
-    this.signalingClient?.sendGroupAcceptControl(roomIds, acceptControl)
-  }
-
-  /**
-     * 处理 signal 消息，根据不同消息类型分发到 webRTCClient 或直接触发 SDK 事件
-     * @param message 信令消息
-     */
-  private handleSignaling = (message: any): void => {
-    if (!this.config) return
-    Logger.debug("调试信息:", `信令消息=========>`, message);
-    switch (message.type) {
-      case MessageType.Peers:
-        this.config.myId = message.myId
-        break
-      case MessageType.Offer:
-        if (message.senderId && message.sdp) {
-          this.config.targetId = message.senderId
-          this.webRTCClient?.handleOffer(message.sdp)
-        }
-        break
-      case MessageType.Answer:
-        if (message.sdp) {
-          this.webRTCClient?.handleAnswer(message.sdp)
-        }
-        break
-      case MessageType.IceCandidates:
-        if (message.ice) {
-          try {
-            const candidateObj = JSON.parse(message.ice)
-            // 将 sdp 字段赋值给 candidate
-            candidateObj.candidate = candidateObj.sdp
-            this.webRTCClient?.handleIceCandidate(new RTCIceCandidate(candidateObj))
-          }
-          catch (error) {
-            this.emit('error', { type: 'iceCandidate', error })
-          }
-        }
-        break
-      case MessageType.SignOut:
-        if (message.myId === this.config.myId) {
-          this.webRTCClient?.closeConnection()
-          this.signalingClient?.close()
-          this.removeAllListeners()
-        }
-        break
-      case MessageType.NotAvailable:
-        this.emit(EmitType.webrtcError, createWebRtcError(FailCode.NOT_AVAILABLE, ''))
-        break
-      case MessageType.Ping:
-        this.sendPong()
-        break
-      case MessageType.SendScreenshot: {
-        const base64Str: string = message.screenshot
-        const roomId: string = message.roomId
-        this.emit(EmitType.screenshot, { roomId: roomId, base64: base64Str })
-        break
-      }
-      case MessageType.KickOut:
-        this.emit(EmitType.webrtcError, createWebRtcError(FailCode.KICK_OUT_ERR, ''))
-        break
-      case MessageType.Error:
-        if (message.error.includes('云手机没有就绪')) {
-          if (this.options.signAgain) {
-            this.signalingClient?.close()
-            this.signalingClient = null
-            this.initSignalingClient()
-            this.clearTimer()
-            this.timeout = setTimeout(() => {
-              this.signalingClient?.start()
-            }, 3000)
-            this.options.signAgain = false
-          }
-          else {
-            this.emit(EmitType.webrtcError, createWebRtcError(FailCode.NOT_AVAILABLE, ''))
-          }
-        }
-        else if (message.error.includes('token 验证失败')) {
-          this.emit(EmitType.webrtcError, createWebRtcError(FailCode.AUTH_FAILED, ''))
-        }
-        break
-      case MessageType.GroupPeersMessage:
-        this.config.roomId = message.mainRoomIdOfGroup
-        this.config.mainCloudMyId = message.mainCloudMyId
-        this.config.myId = message.myId
-        this.config.groupId = message.groupId
-        this.config.connectorAndRoomId = new Map(Object.entries(message.connectorAndRoomId))
-        this.config.connectorAndRoomId?.set(this.config.roomId, this.config.mainCloudMyId ?? '')
-        break
-      default:
-
-        break
-    }
-  }
-
-  clearTimer = () => {
-    if (this.timeout) {
-      clearTimeout(this.timeout)
-      this.timeout = null
-    }
-  }
-
-  /** 发送 Offer 信令 */
-  sendOffer = (offerSdp: string): void => {
-    if (!this.config) return
-    if (offerSdp && offerSdp.length > 0) {
-      const groupModeTargetId = this.config.connectorAndRoomId?.get(this.config.roomId) ?? ''
-      let targetId = this.config.targetId
-      if (groupModeTargetId) {
-        targetId = groupModeTargetId
-      }
-      const message = {
-        type: SendType.Offer,
-        identity: SendType.Identity,
-        roomId: this.config.roomId,
-        senderId: this.config.myId,
-        targetId: targetId,
-        sdp: offerSdp,
-      }
-      this.signalingClient?.sendMessage(JSON.stringify(message))
-    }
-  }
-
-  /** 发送 Answer 信令 */
-  sendAnswer = (answerSdp: string): void => {
-    if (!this.config) return
-    if (answerSdp && answerSdp.length > 0) {
-      const groupModeTargetId = this.config.connectorAndRoomId?.get(this.config.roomId) ?? ''
-      let targetId = this.config.targetId
-      if (groupModeTargetId) {
-        targetId = groupModeTargetId
-      }
-      const message = {
-        traceId: this.config.traceId,
-        type: SendType.Answer,
-        identity: SendType.Identity,
-        roomId: this.config.roomId,
-        senderId: this.config.myId,
-        targetId: targetId,
-        sdp: answerSdp,
-      }
-      this.signalingClient?.sendMessage(JSON.stringify(message))
-    }
-  }
-
-  /** 发送 ICE 候选信息 */
-  sendICEMessage = (ice: string): void => {
-    if (!this.config) return
-    const groupModeTargetId = this.config.connectorAndRoomId?.get(this.config.roomId) ?? ''
-    let targetId = this.config.targetId
-    if (groupModeTargetId) {
-      targetId = groupModeTargetId
-    }
-    if (ice && ice.length > 0) {
-      const message = {
-        traceId: this.config.traceId,
-        type: SendType.IceCandidates,
-        identity: SendType.Identity,
-        roomId: this.config.roomId,
-        senderId: this.config.myId,
-        targetId: targetId,
-        ice,
-      }
-      this.signalingClient?.sendMessage(JSON.stringify(message))
-    }
-  }
-
-  sendPong() {
-    const message = {
-      type: SendType.Pong,
-    }
-    const jsonMessage = JSON.stringify(message)
-    this.signalingClient?.sendMessage(jsonMessage)
-  }
-
-  sendSignOut() {
-    if (!this.config) return
-    if (this.config.connectorType === ConnectorType.LanForwarding) {
-      const message = {
-        type: SendType.GroupSignOut,
-        identity: SendType.Identity,
-        token: this.config.token,
-        groupId: this.config.groupId,
-      }
-      this.signalingClient?.sendMessage(JSON.stringify(message))
-    }
-    else {
-      const message = {
-        type: SendType.SignOut,
-        identity: SendType.Identity,
-        roomId: this.config.roomId,
-        myId: this.config.myId,
-      }
-      this.signalingClient?.sendMessage(JSON.stringify(message))
-    }
-  }
-
-  public groupSendAction(type: ChannelDataType, data: any): void {
-    try {
-      let actionData: ChannelData | null = null
-      switch (type) {
-        case ChannelDataType.ClickData:
-          actionData = ChannelData.click(data)
-          Logger.debug('群控控制事件===>', `Grp=${data.groupIndex}, Idx=${data.index}, action=${data.action}, time=${formattedTime(Date.now())}`)
-          break
-        case ChannelDataType.ClipboardData:
-          actionData = ChannelData.clipboard(data)
-          break
-        case ChannelDataType.ActionInput:
-          actionData = ChannelData.input(data, this.config?.myId ?? '')
-          break
-        case ChannelDataType.ActionChinese:
-          actionData = ChannelData.chinese(data)
-          break
-        case ChannelDataType.ActionRequestCloudDeviceInfo:
-          actionData = ChannelData.requestCloudDeviceInfo()
-          break
-        case ChannelDataType.ActionClarity:
-          actionData = ChannelData.clarity(data)
-          break
-        case ChannelDataType.ActionWheel:
-          actionData = ChannelData.wheel(data)
-          break
-        case ChannelDataType.ActionGesture:
-          actionData = ChannelData.gesture(data)
-          break
-        case ChannelDataType.ActionCommand:
-          actionData = ChannelData.action(data)
-          break
-        case ChannelDataType.ActionCommandEvent:
-          actionData = ChannelData.switchAudio(data)
-          break
-      }
-      if (actionData) {
-        const jsonString = JSON.stringify(actionData)
-        this.signalingClient?.sendGroupAction(jsonString)
-      }
-    }
-    catch (err) {
-      this.emit(EmitType.webrtcError, createWebRtcError(FailCode.DATACHANNEL_ERR, err))
-    }
-  }
-}

package/src/core/data/MessageType.ts

@@ -1,70 +0,0 @@
-export enum MessageType {
-  Peers = 'Peers',
-  Offer = 'Offer',
-  Answer = 'Answer',
-  IceCandidates = 'IceCandidates',
-  SignOut = 'SignOut',
-  NotAvailable = 'NotAvailable',
-  Ping = 'Ping',
-  Pong = 'Pong',
-  SendScreenshot = 'SendScreenshot',
-  KickOut = 'KickOut',
-  GroupPeersMessage = 'GroupPeer',
-  Error = 'Error',
-}
-
-export enum SendType {
-  SignIn = 'SignIn',
-  SignOut = 'SignOut',
-  Answer = 'Answer',
-  Offer = 'Offer',
-  IceCandidates = 'IceCandidates',
-  Pong = 'Pong',
-  Identity = 'Web',
-  SwitchControl = 'SwitchControl',
-  GroupSignIn = 'GroupSignIn',
-  GroupSignOut = 'GroupSignOut',
-  GroupSendAction = 'GroupSendAction',
-  SwitchControlToMain = 'SwitchControlToMain',
-  GroupAcceptControl = 'GroupAcceptControl',
-}
-
-/**
- * 标识自己以什么类型连接云机
- * 内网转发类型中，主从切换由config中mainRoomIdOfGroup, subRoomIdsOfGroup控制
- * 非内网转发类型中，主从切换由config中connectorType控制
- */
-export enum ConnectorType {
-  /**
-   * 主控类型
-   * 页面展示: WebRTC
-   * 数据通道: WebRTC dataChannel
-   */
-  WebRTC = 'webrtc',
-  /**
-   * 内网转发类型
-   * 主控
-   * 页面展示: WebRTC
-   * 数据通道: WebRTC dataChannel
-   * 从控
-   * 页面展示: Websocket
-   * 数据通道: Websocket
-   */
-  LanForwarding = 'lanForwarding',
-  /**
-   * 混合-从控类型
-   * 页面展示: Websocket
-   * 数据通道: WebRTC dataChannel
-   */
-  Hybrid = 'hybrid',
-}
-
-export enum IceConnectionState {
-  NEW = 'new',
-  CHECKING = 'checking',
-  CONNECTED = 'connected',
-  COMPLETED = 'completed',
-  DISCONNECTED = 'disconnected',
-  FAILED = 'failed',
-  CLOSED = 'closed',
-}

package/src/core/data/TurnType.ts

@@ -1,25 +0,0 @@
-export type TurnServerConfig = {
-  urls: string
-  username?: string
-  credential?: string
-}
-
-export interface TurnTestResult extends TurnServerConfig {
-  rtt: number // Infinity 表示失败
-}
-
-export type PublicTurnTestResult = {
-  urls: string
-  rtt: number
-}
-
-export type TurnTestSummary = {
-  best?: PublicTurnTestResult
-  all: PublicTurnTestResult[]
-}
-
-export interface TurnSelectionResult {
-  url?: string
-  rtt?: number
-  error?: string
-}