如何使用simple-peer添加、移除通话视频轨道并解决报错

动态轨道的增删操作规范 #

动态调整轨道的核心操作要匹配WebRTC的RTCRtpSender接口逻辑，不要混淆addTrack/removeTrack和replaceTrack的适用场景：

• 动态新增视频轨道
  1. 通过navigator.mediaDevices.getUserMedia({ video: true })获取本地摄像头权限，拿到独立的视频轨道
  2. 调用Peer实例的addTrack(视频轨道对象, 绑定的本地媒体流)方法，将视频轨道挂载到现有通话连接上，simple-peer会自动触发SDP重新协商流程，无需手动处理信令交换
• 动态移除、关闭已添加的视频轨道
  1. 先调用已获取的视频轨道实例的stop()方法，主动释放摄像头硬件资源，避免设备占用
  2. 调用Peer实例的removeTrack(视频轨道对象)方法，将对应轨道从通话连接的发送端移除，后续同样会自动完成重新协商流程

replaceTrack触发RTCError报错的根因 #

你遇到的堆栈为error Error: [object RTCErrorEvent]的报错，本质是对replaceTrack的适用场景存在误用，simple-peer只是把底层WebRTC PeerConnection抛出的原生错误直接透传到了回调中：

replaceTrack的设计目标，是对已经存在的同类型轨道做无缝替换（比如从内置摄像头切到外接摄像头、切换视频分辨率），它无法实现"从0新增一个原本不存在的视频轨道"或者"把存在的视频轨道删掉"这类操作。

常见的报错触发场景包括：

• 通话初始为纯音频状态，发送端没有任何已存在的视频轨道，强行调用replaceTrack尝试添加视频时，底层PeerConnection找不到对应的视频发送器，直接抛出异常
• 调用replaceTrack时传入的轨道类型和原有轨道不匹配，比如用视频轨道替换原有音频轨道
• 本地视频轨道还未完成初始化、未采集到有效帧时就调用replaceTrack，导致轨道处于无效状态

头像/实时视频流的交互切换实现 #

针对"未开视频显示头像、开视频后替换为实时流"的需求，可按分层逻辑实现：

• 本地交互层：维护全局的视频状态标记，切换视频开关时按照上述增删轨道的流程操作，同时在本地预览区域，根据开关状态切换显示默认头像/本地实时视频预览
• 远端响应层：依赖Peer实例的track事件接收对端传来的媒体轨道：
  1. 当事件回调中检测到有效、激活状态的视频轨道时，将对端展示位的头像隐藏，把轨道对应的MediaStream绑定到对应<video>标签上播放
  2. 当检测不到有效视频轨道、或者已绑定的视频轨道触发ended事件时，隐藏视频播放标签，切换回对端的默认头像展示

实现注意事项：

• 动态调整轨道时不要手动重建整个Peer连接，避免出现通话中断、重连延迟的体验问题
• 视频轨道移除时必须主动调用stop()方法，否则摄像头会持续被系统占用，即使已经从通话连接中移除了轨道
• 远端处理track事件时，要先判断轨道的kind属性，区分音频、视频轨道，避免将音频流错误绑定到视频播放标签上

内容的提问来源于stack exchange，提问作者yoonus