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

package/src/core/rtc/WebRTCClient.ts

@@ -1,862 +0,0 @@
-import {EventEmitter} from 'eventemitter3';
-
-import 'webrtc-adapter';
-
-import {
-  addIceCandidate,
-  configPeerConnection,
-  createOffer,
-  createPeerConnection,
-  setRemoteDescriptionWithHandleAnswer,
-  setRemoteDescriptionWithHandleOffer
-} from './WebRtcNegotiate';
-import type {WebRTCConfig} from "./WebRTCConfig";
-import {CameraFailCode, createCameraError, createWebRtcError, EmitType, FailCode} from "../data/WebRtcError";
-import {
-  ChannelData,
-  ChannelDataType,
-  type CloudStatusPayload,
-  ContainerDirection,
-  type ScreenStats,
-  StreamRotation,
-} from "../data/WebrtcDataType";
-import {FileTypeUtils} from "../util/FileTypeUtils";
-import {Logger} from "../util/Logger";
-
-
-export class WebRTCClient extends EventEmitter {
-  private readonly config: WebRTCConfig;
-  private peerConnection: RTCPeerConnection | null = null;
-  private localStream: MediaStream | null = null;
-  private rotatedStream: MediaStream | null = null;
-  private isPushingStream = false;
-  private isPushingLocalStream = false;
-  private dataChannel: RTCDataChannel | null = null;
-  private videoDataChannel: RTCDataChannel | null = null;
-  private statsTimer: number | undefined = undefined;
-  private lastReportTime = 0;
-  private lastBytesReceived = 0;
-  private lastPacketsLost = 0;
-  private lastPacketsReceived = 0;
-  private lostPacketCount = 0;
-  private maxLostRate = 0;
-  private lastSecondDecodedCount = 0;
-  private fileVideo?: HTMLVideoElement;
-
-  private canvas?: HTMLCanvasElement;
-  private canvasStream: MediaStream | null = null;
-  private rafId: number = 0;
-  private currentMedia: HTMLVideoElement | HTMLImageElement | null = null;
-  private fileImage?: HTMLImageElement;
-
-
-  private isFirst = true;
-
-  constructor(config: WebRTCConfig) {
-    super();
-    this.config = config;
-
-  }
-
-  public async startPush(useBackCamera: boolean = true) {
-    if(this.isPushingLocalStream) {
-      this.stopLocal()
-    }
-    try {
-      this.isPushingStream = true;
-      await this.readyCapture(useBackCamera);
-    } catch (err) {
-      this.isPushingStream = false;
-      let errorMessage: string;
-      if (err instanceof Error) {
-        errorMessage = err.message; // ✅ 只取 message
-      } else {
-        errorMessage = String(err); // 兜底，防止 err 不是 Error 类型
-      }
-      this.emit(
-          EmitType.cameraError,
-          createCameraError(CameraFailCode.CAMERA_STREAM_FAIL, errorMessage)
-      );
-    }
-  }
-
-  public handleOffer(offerSdp: string) {
-    this.resetPeerConnection();
-    setRemoteDescriptionWithHandleOffer(this.peerConnection!, offerSdp, (sdp: string) => {
-      this.emit(EmitType.sendAnswer, sdp)
-    }, err => this.emit(EmitType.webrtcError, err));
-  }
-
-  public handleAnswer(answerSdp: string) {
-    setRemoteDescriptionWithHandleAnswer(this.peerConnection!, answerSdp ?? '', err => this.emit(EmitType.webrtcError, err));
-  }
-
-  public handleIceCandidate(candidate: RTCIceCandidateInit) {
-    addIceCandidate(this.peerConnection!, candidate, err => this.emit(EmitType.webrtcError, err));
-  }
-
-  public sendChannelData(type: ChannelDataType, data: any) {
-    try{
-      let channelData:ChannelData | null = null;
-      switch (type) {
-        case ChannelDataType.ClickData:
-          channelData = ChannelData.click(data);
-          break;
-        case ChannelDataType.ClipboardData:
-          channelData = ChannelData.clipboard(data);
-          break;
-        case ChannelDataType.ActionInput:
-          channelData = ChannelData.input(data, this.config.myId);
-          break;
-        case ChannelDataType.ActionChinese:
-          channelData = ChannelData.chinese(data);
-          break;
-        case ChannelDataType.ActionRequestCloudDeviceInfo:
-          channelData = ChannelData.requestCloudDeviceInfo();
-          break;
-        case ChannelDataType.ActionClarity:
-          channelData = ChannelData.clarity(data);
-          break;
-        case ChannelDataType.ActionWheel:
-          channelData = ChannelData.wheel(data);
-          break;
-        case ChannelDataType.ActionGesture:
-          channelData = ChannelData.gesture(data);
-          break
-        case ChannelDataType.ActionCommand:
-          channelData = ChannelData.action(data);
-          break
-        case ChannelDataType.ActionCommandEvent:
-          channelData = ChannelData.switchAudio(data)
-          break
-        case ChannelDataType.ActionTrack:
-          channelData = ChannelData.changeSender(data);
-          break
-        case ChannelDataType.RequestKeyFrame:
-          channelData = ChannelData.requestKeyFrame(data);
-          break
-      }
-      if(channelData){
-        const jsonString = JSON.stringify(channelData)
-        const buffer = new TextEncoder().encode(jsonString).buffer;
-        this.dataChannel?.send(buffer);
-        channelData = null
-      }
-    } catch (err) {
-      this.emit(EmitType.webrtcError, createWebRtcError(FailCode.DATACHANNEL_ERR, err))
-    }
-  }
-
-
-  public closeConnection() {
-    Logger.info('信息日志：', '关闭webrtc连接=======>')
-    if (this.statsTimer) {
-      clearInterval(this.statsTimer);
-      this.statsTimer = undefined;
-    }
-    this.stopPush()
-    this.stopLocal()
-    // if(this.decoder && this.decoder.state === "configured"){
-    //   this.decoder.flush();
-    // }
-    if(this.peerConnection){
-      // 1. 停止所有发送轨道（释放摄像头/麦克风）
-      if(typeof this.peerConnection.getSenders === 'function' && this.peerConnection.getSenders){
-        this.peerConnection.getSenders().forEach(sender => {
-          if (sender.track) {
-            sender.track.stop?.();
-          }
-        });
-      }
-      // 2. 停止所有接收轨道
-      if(typeof this.peerConnection.getReceivers === 'function' && this.peerConnection.getReceivers){
-        this.peerConnection.getReceivers().forEach(receiver => {
-          if (receiver.track) {
-            receiver.track.stop?.();
-          }
-        });
-      }
-      // 3. 关闭所有 transceivers（彻底清除资源）
-      if (this.peerConnection.getTransceivers) {
-        this.peerConnection.getTransceivers().forEach(transceiver => {
-          transceiver.stop?.();
-        });
-      }
-      // 4. 关闭连接
-      this.removeAllListeners()
-      this.videoDataChannel?.close()
-      this.videoDataChannel = null
-      this.dataChannel?.close()
-      this.dataChannel = null
-      // 5. 清除事件监听器（如果你手动添加了）
-      this.peerConnection.onicecandidate = null;
-      this.peerConnection.ontrack = null;
-      this.peerConnection.ondatachannel = null;
-      this.peerConnection.onconnectionstatechange = null;
-      this.peerConnection.oniceconnectionstatechange = null;
-      this.peerConnection.onsignalingstatechange = null;
-      this.peerConnection.onnegotiationneeded = null;
-      this.peerConnection.onicegatheringstatechange = null;
-      this.peerConnection.close();
-      this.peerConnection = null;
-    }
-
-  }
-
-  async readyCapture(useBackCamera: boolean) {
-    this.resetPeerConnection();
-    this.stopPush()
-    Logger.info('信息日志：', '启用摄像头推流到云机=======>', useBackCamera)
-    try {
-      this.localStream = await navigator.mediaDevices.getUserMedia({
-        video: { width: { ideal: 1280 }, height: { ideal: 720 },
-          facingMode: useBackCamera ? { ideal: 'user' } : { ideal: 'user' }, frameRate: { ideal: 20, max: 30 }},
-        audio: true
-      });
-      const senders: RTCRtpSender[] = [];
-      const rotatedStream = await this.getRotatedStream(this.localStream, useBackCamera);
-      // const rotatedStream = this.localStream
-      this.rotatedStream = rotatedStream;
-
-      rotatedStream.getTracks().forEach(track => {
-        track.contentHint = 'motion';
-        const sender = this.peerConnection!.addTrack(track, rotatedStream);
-        senders.push(sender);
-      });
-      await createOffer(this.peerConnection!, (sdp: string) => {
-        this.emit(EmitType.sendOffer, sdp);
-      });
-      senders.forEach(sender => this.setVideoParams(sender));
-
-    } catch (err) {
-      if (err instanceof DOMException) {
-        switch (err.name) {
-          case 'NotAllowedError':
-            throw new Error("用户拒绝了摄像头或麦克风权限");
-          case 'NotFoundError':
-            throw new Error("未找到摄像头或麦克风设备");
-          case 'OverconstrainedError':
-            throw new Error("设备无法满足指定约束");
-          case 'NotReadableError':
-            throw new Error("设备忙或无法访问");
-          default:
-            throw new Error(`其他错误: ${err.message}`);
-        }
-      }
-      throw new Error(`mediaDevices 异常: ${err}`);
-    }
-  }
-
-  /**
-   * ✅ 切换前后摄像头（无缝）
-   */
-  async switchCamera(useBackCamera: boolean) {
-    try {
-      Logger.info('信息日志：', `切换摄像头 => ${useBackCamera ? '后置' : '前置'}`);
-      this.isPushingStream = true;
-      // 1️⃣ 获取新的摄像头流
-      this.localStream = await navigator.mediaDevices.getUserMedia({
-        video: {
-          width: { ideal: 1280 },
-          height: { ideal: 720 },
-          facingMode: useBackCamera ? { ideal: 'environment' } : { ideal: 'user' },
-          frameRate: { ideal: 20, max: 30 },
-        },
-        audio: false // 音频不需要重新采集
-      });
-      const rotatedStream = await this.getRotatedStream(this.localStream, useBackCamera);
-      // 3️⃣ 释放旧的摄像头资源
-      // 4️⃣ 更新本地流引用
-      this.rotatedStream = rotatedStream;
-      const newTrack = this.rotatedStream.getVideoTracks()[0];
-
-      // 2️⃣ 找到原 video sender
-      const sender = this.peerConnection?.getSenders()
-          .find(s => s.track && s.track.kind === 'video');
-
-      if (sender) {
-        // ✅ 无缝替换视频 track
-        await sender.replaceTrack(newTrack);
-      }
-
-      // Logger.info('信息日志：', `摄像头切换完成 => ${useBack ? '后置' : '前置'}`);
-    } catch (err) {
-      this.isPushingStream = false;
-      if (err instanceof DOMException) {
-        switch (err.name) {
-          case 'NotAllowedError':
-            throw new Error("用户拒绝了摄像头或麦克风权限");
-          case 'NotFoundError':
-            throw new Error("未找到摄像头或麦克风设备");
-          case 'OverconstrainedError':
-            throw new Error("设备无法满足指定约束");
-          case 'NotReadableError':
-            throw new Error("设备忙或无法访问");
-          default:
-            throw new Error(`其他错误: ${err.message}`);
-        }
-      }
-      throw new Error(`mediaDevices 异常: ${err}`);
-    }
-  }
-
-  private async getRotatedStream(localStream: MediaStream, useBackCamera: boolean): Promise<MediaStream> {
-    // ✅ 创建 canvas，不插入 DOM（或插入但隐藏）
-    const canvas = document.createElement('canvas');
-    canvas.width = 1280;
-    canvas.height = 720;
-
-    // ✅ 可选安全隐藏法（Safari 不会暂停绘制）
-    canvas.style.position = 'absolute';
-    canvas.style.top = '-9999px';
-    canvas.style.left = '-9999px';
-    canvas.style.width = '1px';
-    canvas.style.height = '1px';
-    canvas.style.opacity = '0';
-    document.body.appendChild(canvas);
-
-    const ctx = canvas.getContext('2d')!;
-
-    const video = document.createElement('video');
-    video.srcObject = localStream;
-    video.muted = true; // 避免回声
-    video.playsInline = true;
-    video.autoplay = true;
-    video.setAttribute('playsinline', 'true');
-    video.setAttribute('webkit-playsinline', 'true');
-    await video.play();
-
-    const width = video.videoWidth;
-    const height = video.videoHeight;
-
-    // 旋转逻辑
-    const drawFrame = () => {
-      ctx.clearRect(0, 0, canvas.width, canvas.height);
-      ctx.save();
-      ctx.translate(canvas.width / 2, canvas.height / 2);
-      const angle = useBackCamera ? -Math.PI / 2 : Math.PI / 2;
-      ctx.rotate(angle);
-      ctx.drawImage(video, -width / 2, -height / 2, width, height);
-      ctx.restore();
-    };
-
-    const fps = 25;
-    const frameInterval = 1000 / fps;
-    let lastTime = 0;
-    let rafId: number;
-
-    const drawLoop = (time: number) => {
-      if (time - lastTime >= frameInterval) {
-        drawFrame();
-        lastTime = time;
-      }
-      rafId = requestAnimationFrame(drawLoop);
-    };
-    rafId = requestAnimationFrame(drawLoop);
-
-    const stream = canvas.captureStream(fps);
-
-    // 清理逻辑
-    stream.getTracks().forEach(track => {
-      const stopLoop = () => {
-        cancelAnimationFrame(rafId);
-        // 可选：移除 canvas
-        canvas.remove();
-      };
-      track.addEventListener('ended', stopLoop);
-      track.addEventListener('stop', stopLoop);
-    });
-
-    return stream;
-  }
-
-
-  // private async setVideoParams(sender: RTCRtpSender) {
-  //   Logger.info('信息日志：', '设置推流视频参数=======>')
-  //   const params = sender.getParameters();
-  //   params.degradationPreference = 'balanced';
-  //   const isMobile = /Android|iPhone|iPad/i.test(navigator.userAgent);
-  //   params.encodings.forEach(encoding => {
-  //     encoding.maxBitrate = isMobile ? 800000 : 1000000;
-  //     encoding.priority = 'high';
-  //     encoding.scaleResolutionDownBy = 1.0;
-  //   });
-  //   await sender.setParameters(params);
-  // }
-
-  private async setVideoParams(sender: RTCRtpSender) {
-    const params = sender.getParameters();
-    // ✅ 根据设备动态设定目标参数
-    const isMobile = /Android|iPhone|iPad/i.test(navigator.userAgent);
-    const targetBitrate = isMobile ? 600_000 : 1_800_000;  // 移动端 0.6Mbps，PC 1.8Mbps
-    const targetFramerate = 30;            // 移动端 24fps，PC 30fps
-
-    // ✅ degradationPreference 告诉浏览器“掉帧还是降分辨率”
-    // maintain-framerate：优先维持帧率（视频通话常用）
-    // maintain-resolution：优先保持清晰度（静态画面）
-    // balanced：自动平衡（推荐）
-    params.degradationPreference = 'maintain-resolution';
-
-    // ✅ 如果 encodings 为空则初始化
-    if (!params.encodings || params.encodings.length === 0) {
-      params.encodings = [{}];
-    }
-
-    params.encodings.forEach(encoding => {
-      encoding.maxBitrate = targetBitrate;
-      encoding.maxFramerate = targetFramerate;
-      encoding.scaleResolutionDownBy = 1.0;
-      encoding.priority = 'high';
-    });
-
-    try {
-      await sender.setParameters(params);
-      Logger.info('信息日志：', `设置推流视频参数成功：${targetBitrate / 1000}kbps / ${targetFramerate}fps`);
-    } catch (e) {
-      Logger.error('设置推流参数失败：', e);
-    }
-  }
-
-  public stopPush() {
-    if (!this.isPushingStream) return;
-    this.isPushingStream = false;
-    Logger.info('信息日志：', '停止推流到云机=======>')
-    // 1. 停止本地原始流
-    this.localStream?.getTracks().forEach(track => track.stop());
-    this.localStream = null;
-
-    // 2. 停止旋转后的流
-    this.rotatedStream?.getTracks().forEach(track => track.stop());
-    this.rotatedStream = null;
-
-    // 3. 移除 PeerConnection 中的 sender
-    this.peerConnection?.getSenders().forEach(sender => {
-      try {
-        this.peerConnection?.removeTrack(sender);
-      } catch (e) {
-        console.warn("removeTrack error:", e);
-      }
-    });
-    // createOffer(this.peerConnection!, (sdp: string) => {
-    //   this.emit(EmitType.sendOffer, sdp)
-    // }, err => this.emit(EmitType.webrtcError, err));
-  }
-
-  private resetPeerConnection() {
-    if (!this.peerConnection) {
-      this.peerConnection = createPeerConnection(this.config);
-      configPeerConnection(this.peerConnection,(candidate: string) => {
-        this.emit(EmitType.sendICEMessage, candidate)
-      }, (track: MediaStreamTrack) => {
-        this.emit(EmitType.streamTrack, track)
-      }, (state: RTCIceConnectionState) => {
-        this.emit(EmitType.iceConnectionState, state)
-        if(state === "connected"){
-          this.checkStats()
-        }
-      }, err => this.emit(EmitType.webrtcError, err));
-      this.configDataChannel();
-    }
-  }
-
-  private configDataChannel() {
-    this.peerConnection!.ondatachannel = event => {
-      const channel = event.channel;
-
-      // 根据 label 区分不同通道
-      switch (channel.label) {
-        case `dataChannel${this.config.myId}`:
-          this.dataChannel = channel;
-          this.dataChannel.onmessage = ev => this.handleDataChannelMessage(ev);
-          this.dataChannel.onerror = err => this.emit(EmitType.webrtcError, createWebRtcError(FailCode.DATACHANNEL_ERR, err));
-          this.sendChannelData(ChannelDataType.ActionRequestCloudDeviceInfo, '');
-          break;
-
-        case `video${this.config.myId}`:
-          this.videoDataChannel = channel;
-          this.videoDataChannel.onmessage = ev => this.handleVideoChannelMessage(ev);
-          this.videoDataChannel.onerror = err => this.emit(EmitType.webrtcError, createWebRtcError(FailCode.DATACHANNEL_ERR, err));
-          break;
-
-        default:
-          console.warn('Unknown data channel:', channel.label);
-          break;
-      }
-    };
-  }
-
-  private async handleVideoChannelMessage(event: MessageEvent){
-    const databuffer = event.data;
-    if (databuffer instanceof ArrayBuffer || databuffer instanceof Blob) {
-      // -----------------------
-      // 二进制数据处理
-      // -----------------------
-      // if(this.isFirst){
-      //   this.sendChannelData(ChannelDataType.RequestKeyFrame, 'requestKeyFrame')
-      //   this.isFirst = false
-      // }
-      const arrayBuffer = databuffer instanceof Blob
-          ? await databuffer.arrayBuffer()
-          : databuffer;
-
-      this.emit(EmitType.arrayBuffer, arrayBuffer)
-    }
-  }
-
-  private async handleDataChannelMessage(event: MessageEvent) {
-
-    const data = JSON.parse(event.data);
-    if (data.type === ChannelDataType.ActionCommandEvent) {
-      const { action, value, cameraId } = JSON.parse(data.data);
-      if (action === 'ACTION_CONTROL_VIDEO') {
-        if(value === 'ENABLE'){
-          if(this.isPushingStream){
-            this.switchCamera(Number(cameraId) === 0)
-          }else {
-            this.startPush(Number(cameraId) === 0)
-          }
-        }else{
-          this.stopPush()
-          this.stopLocal()
-        }
-      }
-    } else if (data.type === ChannelDataType.ActionUpdateCloudStatus) {
-      const { rotation, screenWidth, screenHeight, gestureMode, level, isClarity } = JSON.parse(data.data);
-      const direction = [StreamRotation.ROTATION_0, StreamRotation.ROTATION_180].includes(rotation)
-          ? ContainerDirection.Vertical
-          : ContainerDirection.Horizontal;
-      const cloudStatus:CloudStatusPayload = {
-        direction, screenWidth, screenHeight, gestureMode, clarityLevel: level, isClarity
-      }
-      this.emit(EmitType.cloudStatusChanged, cloudStatus);
-    }else if(data.type === ChannelDataType.CloudClipData){
-      this.emit(EmitType.cloudClipData, data.data)
-    }
-  }
-
-  private checkStats() {
-    this.statsTimer = setInterval(() => this.processStatsOptimized(), 1000);
-  }
-
-  private async processStatsOptimized() {
-    const pc = this.peerConnection;
-    if (!pc) return;
-
-    // ---- 浏览器检测（Safari 兼容处理）----
-    const ua = navigator.userAgent;
-    const isSafari = /Safari/.test(ua) && !/Chrome/.test(ua);
-    const isMobile = /iPhone|iPad|Android/i.test(ua);
-
-    // Safari 上 getStats 性能较差，延长采样周期
-    const minInterval = isSafari || isMobile ? 3000 : 1000;
-    const now = Date.now();
-    if (this.lastReportTime && now - this.lastReportTime < minInterval) return; // 自动限频
-
-    try {
-      const statsReport = await pc.getStats(null);
-
-      // ---- 初始化变量 ----
-      let videoFps = 0;
-      let totalDecodeTime = 0;
-      let roundTripTime = 0;
-      let packetsLost = 0;
-      let packetsReceived = 0;
-      let bytesReceived = 0;
-      let framesDecoded = 0;
-      let framesReceived = 0;
-      let pliCount = 0;
-      let connectionType = "";
-
-      // ---- 遍历关键项（仅 inbound-rtp / candidate-pair）----
-      for (const report of statsReport.values()) {
-        if (report.type === "inbound-rtp" && report.kind === "video") {
-          bytesReceived += report.bytesReceived || 0;
-          packetsLost += report.packetsLost || 0;
-          packetsReceived += report.packetsReceived || 0;
-
-          // Safari 下 framesPerSecond 常缺失，用差值代替
-          videoFps = report.framesPerSecond || 0;
-          totalDecodeTime = report.totalDecodeTime || 0;
-          framesDecoded = report.framesDecoded || 0;
-          framesReceived = report.framesReceived || 0;
-          pliCount = (report.pliCount || 0) + (report.firCount || 0);
-        }
-
-        if (report.type === "candidate-pair" && report.state === "succeeded") {
-          roundTripTime = typeof report.currentRoundTripTime !== "undefined"
-              ? report.currentRoundTripTime
-              : report.responsesReceived > 0
-                  ? report.totalRoundTripTime / report.responsesReceived
-                  : 0;
-
-          const local = statsReport.get(report.localCandidateId);
-          const remote = statsReport.get(report.remoteCandidateId);
-          if (local && remote) {
-            connectionType = this.getConnectionType(local, remote);
-          }
-        }
-      }
-
-      // ---- RTT 单位转换 ----
-      if (roundTripTime > 1000) {
-        roundTripTime = Math.floor(roundTripTime / 1000);
-      } else if (roundTripTime < 1) {
-        roundTripTime = Math.floor(roundTripTime * 1000);
-      }
-
-      // ---- 带宽计算 ----
-      const deltaTime = now - (this.lastReportTime || now);
-      const bytesDiff = bytesReceived - (this.lastBytesReceived || 0);
-      const bytesPerSecond = deltaTime > 0 ? (bytesDiff * 1000) / deltaTime : 0;
-      const kilobytesPerSecond = bytesPerSecond / 1024;
-      const megabytesPerSecond = kilobytesPerSecond / 1024;
-
-      this.lastBytesReceived = bytesReceived;
-      this.lastReportTime = now;
-
-      // ---- 丢包率 ----
-      const lostPackets = packetsLost - (this.lastPacketsLost || 0);
-      const receivedPackets = packetsReceived - (this.lastPacketsReceived || 0);
-      let lossRate = 0;
-      if (lostPackets > 0 && receivedPackets > 0) {
-        lossRate = lostPackets / (lostPackets + receivedPackets);
-        this.maxLostRate = Math.max(this.maxLostRate || 0, lossRate);
-        this.lostPacketCount = (this.lostPacketCount || 0) + 1;
-      }
-
-      this.lastPacketsLost = packetsLost;
-      this.lastPacketsReceived = packetsReceived;
-
-      // ---- FPS 计算 ----
-      const fps = videoFps || (framesDecoded - (this.lastSecondDecodedCount || 0));
-      this.lastSecondDecodedCount = framesDecoded;
-
-      // ---- 码率与解码耗时 ----
-      const bitrate = kilobytesPerSecond < 1024
-          ? `${Math.floor(kilobytesPerSecond)} KB/s`
-          : `${Math.floor(megabytesPerSecond)} MB/s`;
-
-      const averageDecodeTime = framesDecoded > 0
-          ? Math.floor((10000 * totalDecodeTime) / framesDecoded)
-          : 0;
-
-      // ---- 汇总结果 ----
-      const screenInfo: ScreenStats = {
-        connectionType,
-        framesPerSecond: fps,
-        currentRoundTripTime: roundTripTime,
-        lostRate: Math.floor(lossRate * 100),
-        bitrate,
-        pliCount,
-        averageDecodeTime,
-        framesDecoded,
-        framesReceived,
-      };
-
-      this.emit(EmitType.statisticInfo, screenInfo);
-    } catch (error) {
-      this.emit(EmitType.webrtcError, createWebRtcError(FailCode.STREAM_STATE, error));
-    }
-  }
-
-
-  private getConnectionType(local: any, remote: any): string {
-    if (local.candidateType === 'host' && remote.candidateType === 'host') return '直连';
-    if (local.candidateType === 'relay' || remote.candidateType === 'relay') return '中继';
-    return 'NAT';
-  }
-
-  /** 获取或创建 video 元素（懒初始化） */
-  private getFileVideo(): HTMLVideoElement {
-    if (!this.fileVideo) {
-      this.fileVideo = document.createElement('video');
-      this.fileVideo.muted = true; // 避免回声
-      this.fileVideo.playsInline = true;
-    }
-    return this.fileVideo;
-  }
-
-  /** 获取或创建 canvas 元素（懒初始化） */
-  private getCanvas(): HTMLCanvasElement {
-    if (!this.canvas) {
-      this.canvas = document.createElement('canvas');
-      this.canvas.width = 640;
-      this.canvas.height = 480;
-    }
-    return this.canvas;
-  }
-
-  public async loadMedia(file: File) {
-    const video = this.getFileVideo();
-    const img = this.getFileImage();
-    const type = file.type.toLowerCase();
-    const ext = file.name.split('.').pop()?.toLowerCase();
-
-    const videoExts = ['mp4', 'webm', 'ogg', 'mov', 'mkv'];
-    const imageExts = ['jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp'];
-
-    // 1. MIME + 扩展名初步判断
-    let kind: 'video' | 'image' | 'unknown' = 'unknown';
-    if (type.startsWith('video/') || (ext && videoExts.includes(ext))) {
-      kind = 'video';
-    } else if (type.startsWith('image/') || (ext && imageExts.includes(ext))) {
-      kind = 'image';
-    }
-
-    // 2. 如果 MIME/扩展名都不可靠，再用魔数嗅探
-    if (kind === 'unknown') {
-      kind = await FileTypeUtils.detectFileType(file);
-    }
-
-    if (kind === 'video') {
-      return new Promise<void>((resolve, reject) => {
-        video.src = URL.createObjectURL(file);
-        video.onloadedmetadata = () => resolve();
-        video.onerror = () => reject(new Error(`视频文件加载失败: ${file.name}`));
-        video.play().catch(err => reject(new Error(`视频播放失败: ${err}`)));
-        this.currentMedia = video;
-      });
-    } else if (kind === 'image') {
-      return new Promise<void>((resolve, reject) => {
-        img.src = URL.createObjectURL(file);
-        img.onload = () => resolve();
-        img.onerror = () => reject(new Error(`图片文件加载失败: ${file.name}`));
-        this.currentMedia = img;
-      });
-    } else {
-      throw new Error(`不支持的文件类型: ${type || ext}`);
-    }
-  }
-
-
-  public startPushLocal = async (file: File) => {
-    if (this.isPushingLocalStream || !file) return;
-    try {
-      await this.loadMedia(file);       // 视频或图片
-      this.startCanvasStream();         // 转成 640x480 canvas 流
-      const senders: RTCRtpSender[] = [];
-      this.canvasStream?.getTracks().forEach(track => {
-        track.contentHint = 'detail';
-        const sender = this.peerConnection!.addTrack(track, this.canvasStream!);
-        senders.push(sender);
-      });
-      senders.forEach(sender => this.setVideoParams(sender));
-
-      await createOffer(this.peerConnection!, (sdp: string) => {
-        this.emit(EmitType.sendOffer, sdp);
-      });
-      this.isPushingLocalStream = true;
-    } catch (err) {
-      this.isPushingLocalStream = false;
-      let errorMessage: string;
-      if (err instanceof Error) {
-        errorMessage = err.message; // ✅ 只取 message
-      } else {
-        errorMessage = String(err); // 兜底，防止 err 不是 Error 类型
-      }
-      this.emit(
-          EmitType.cameraError,
-          createCameraError(CameraFailCode.LOCAL_STREAM_FAIL, errorMessage)
-      );
-    }
-  }
-
-  public startCanvasStream(fps = 30): MediaStream {
-    Logger.info('信息日志：', '初始化，使用本地文件推流到云机=======>')
-    const canvas = this.getCanvas();
-    const ctx = canvas.getContext('2d')!;
-    const media = this.currentMedia;
-    if (!media) throw new Error('请先加载媒体文件');
-
-    let lastTime = 0;
-    const frameInterval = 1000 / fps;
-    let rafId: number = 1;
-
-    const drawFrame = (time: number) => {
-      if (time - lastTime >= frameInterval) {
-        ctx.clearRect(0, 0, canvas.width, canvas.height);
-        ctx.save();
-
-        // 旋转 + 水平翻转
-        ctx.translate(canvas.width / 2, canvas.height / 2);
-        ctx.rotate(Math.PI / 2);
-        ctx.scale(-1, 1);
-
-        // 获取媒体宽高
-        let mediaWidth: number;
-        let mediaHeight: number;
-        if (media instanceof HTMLVideoElement) {
-          mediaWidth = media.videoWidth;
-          mediaHeight = media.videoHeight;
-        } else if (media instanceof HTMLImageElement) {
-          mediaWidth = media.width;
-          mediaHeight = media.height;
-        } else {
-          throw new Error('不支持的媒体类型');
-        }
-
-        // 等比例缩放
-        const scale = Math.min(canvas.height / mediaWidth, canvas.width / mediaHeight);
-        const w = mediaWidth * scale;
-        const h = mediaHeight * scale;
-
-        ctx.drawImage(media, -w / 2, -h / 2, w, h);
-        ctx.restore();
-
-        lastTime = time;
-      }
-
-      // 视频模式继续刷新，图片模式只刷新一次
-      rafId = requestAnimationFrame(drawFrame);
-    };
-
-    // 首次绘制
-    drawFrame(0);
-    this.rafId = requestAnimationFrame(drawFrame);
-
-    // 生成 MediaStream
-    this.canvasStream = canvas.captureStream(fps);
-
-    // 停止流时清理 RAF
-    this.canvasStream.getTracks().forEach(track => {
-      const stopLoop = () => cancelAnimationFrame(rafId);
-      track.addEventListener('ended', stopLoop);
-      track.addEventListener('stop', stopLoop);
-    });
-
-    return this.canvasStream;
-  }
-
-
-  public getFileImage(): HTMLImageElement {
-    if (!this.fileImage) {
-      const img = document.createElement('img');
-      img.style.display = 'none'; // 隐藏
-      document.body.appendChild(img);
-      this.fileImage = img;
-    }
-    return this.fileImage;
-  }
-
-
-  /** 停止推流并释放资源 */
-  public stopLocal() {
-    if (!this.isPushingLocalStream) return;
-    this.isPushingLocalStream = false;
-    cancelAnimationFrame(this.rafId);
-    this.canvasStream?.getTracks().forEach(track => track.stop());
-    this.canvasStream = null;
-    // 3. 移除 PeerConnection 中的 sender
-    this.peerConnection?.getSenders().forEach(sender => {
-      try {
-        this.peerConnection?.removeTrack(sender);
-      } catch (e) {
-        Logger.error('错误日志：', `移除音视频轨道失败=====>`, e);
-      }
-    });
-    if (this.fileVideo) {
-      this.fileVideo.pause();
-      this.fileVideo.src = '';
-    }
-  }
-}