WebRTC作为被叫方调用setLocalDescription未触发ICE收集事件求助

核心排查与修复步骤 #

1. 放弃手动调用setLocalDescription，改用jsSIP内置应答流程 #

jsSIP会自动封装WebRTC的PeerConnection创建、本地描述设置、ICE候选收集等全流程逻辑，手动调用setLocalDescription会打乱内部状态，直接导致ICE流程异常。正确的应答方式是使用jsSIP Session对象的answer()方法：

ua.on('invite', (session) => {
  const answerOptions = {
    mediaConstraints: { audio: true, video: false }, // 根据业务需求调整媒体权限
    pcConfig: {
      iceServers: [
        { urls: 'stun:stun.l.google.com:19302' },
        // 如需穿透复杂NAT，添加对应TURN服务器配置
      ]
    }
  };

  session.answer(answerOptions);

  // 通过jsSIP暴露的PeerConnection对象监听ICE候选事件
  session.connection.onicecandidate = (event) => {
    if (event.candidate) {
      console.log('获取到ICE候选:', event.candidate);
    } else {
      console.log('ICE候选收集完成');
    }
  };
});

2. 确保配置有效的ICE服务器 #

未配置ICE服务器（STUN/TURN）会导致浏览器无法收集可用网络候选，甚至直接跳过ICE收集流程。初始化jsSIP UA时必须指定ICE服务器：

const ua = new JsSIP.UA({
  uri: 'sip:your-account@your-domain.com',
  password: 'your-password',
  iceServers: [
    { urls: 'stun:stun.l.google.com:19302' },
    // TURN服务器配置示例（根据实际服务参数调整）
    {
      urls: 'turn:your-turn-server.com:3478',
      username: 'turn-username',
      credential: 'turn-password'
    }
  ]
});

3. 检查媒体约束与权限 #

如果媒体约束设置为audio: false且video: false，PeerConnection因无媒体传输需求会跳过ICE收集。同时需确认用户已授予麦克风/摄像头权限，权限被拒绝会直接终止ICE流程。

4. 确认ICE事件监听时机 #

需在jsSIP创建PeerConnection后再绑定onicecandidate事件，可通过监听Session的connecting事件确保时机正确：

session.on('connecting', () => {
  session.connection.onicecandidate = (event) => {
    // 处理ICE候选逻辑
  };
});

5. 查看浏览器控制台错误 #

打开浏览器开发者工具控制台，检查是否存在ICE服务器连接失败、媒体权限错误、SDP解析失败等异常信息，这些都是ICE收集中断的常见诱因。

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