
如何告别 WebRTC 协商冲突WebRTC Samples 的 Perfect Negotiation 完美协商实现指南【免费下载链接】samplesWebRTC Web demos and samples项目地址: https://gitcode.com/gh_mirrors/sa/samplesWebRTC 完美协商Perfect Negotiation是解决 WebRTC 协商冲突Glare双方同时发起 Offer 撞车的官方推荐模式。本文基于 WebRTC Samples 开源项目中的 Perfect Negotiation 示例面向新手讲解协商冲突产生的原理、有礼貌Polite与无礼Impolite双端的分工并手把手带你在本地运行这个完整可交互的示例帮助你快速掌握这一核心信令模式。一、先搞清楚WebRTC 协商冲突Glare是什么WebRTC 通话建立的第一步是Offer/Answer 协商一端创建 Offer 发给对端对端创建 Answer 回发双方再交换 ICE 候选地址连接才真正建立。问题出在如果两端同时触发了onnegotiationneeded事件比如用户双方同时点了加一路视频就各自生成了一个 Offer 互相对撞——这就是所谓的Glare眩目/协商冲突。此时setRemoteDescription()会直接抛错InvalidStateError: Failed to execute setRemoteDescription on RTCPeerConnection: In current state, the operation is not allowed.轻则信令逻辑卡死、重则通话直接掉线。传统做法是固定由 A 端发 Offer、B 端只回 Answer简单但死板——B 端永远没有主动权当 B 端先发生变化时就无能为力。二、Perfect Negotiation 完美协商的核心思想W3C 官方给出的 Perfect Negotiation 模式让两端都可以主动发起 Offer并靠一套简单的礼仪规则优雅化解冲突角色身份冲突时的行为Polite有礼貌端一方收到对方 Offer 撞车时回滚自己未完成的 Offer优先处理对方 Offer回到 stable 后自己的onnegotiationneeded会再次触发自动补发新一轮 Offer/AnswerImpolite无礼端另一方无视撞车的对端 Offer继续完成自己的 Offer/Answer 流程中途收到的 ICE 候选错误也要吞掉一句话总结冲突发生时礼貌端让步回滚无礼端坚持己见。这套规则的关键约束只有两条✅ 发起 Offer 前必须处于stable信令状态negotiationneeded保证只在 stable 时触发✅ 使用setLocalDescription()不传参的简化版 API 来自动生成 offer/answer避免手动管理描述对象。下面用两张图直观感受一下信号流向有礼貌端和无礼端各自发起 Offer撞车后礼貌端回滚、让路给无礼端随后自动补上新一轮协商。三、本地一键运行 Perfect Negotiation 示例本仓库即 WebRTC JavaScript 官方示例集README.md所有示例均可本地运行。1️⃣ 克隆仓库git clone https://gitcode.com/gh_mirrors/sa/samples2️⃣ 安装依赖并启动本地服务npm install npm start3️⃣ 打开示例页面启动后按终端提示打开浏览器定位到 Perfect Negotiation 页面对应源码位于 src/content/peerconnection/perfect-negotiation/index.html。4️⃣ 动手体验协商冲突全过程页面会并排弹出两个 iframe分别扮演Polite和Impolite双端点两边的Start按钮生成各自的本地彩条视频流点击底部的Swap Sending Track按钮让某一端切换发送轨道触发onnegotiationneeded再点页面底部两个大按钮让两端同时发起交换人为制造 glare——注意两个按钮分别控制礼貌端先发和无礼端先发打开浏览器JavaScript 控制台可以实时看到SLDsetLocalDescription、SRD(offer/answer)、glare - ignoring offer等协商步骤日志。你会发现无论谁先发 Offer连接最终都会稳定完成协商对端视频正常切换——这正是 Perfect Negotiation 的自动愈合能力。四、源码拆解60 行代码看懂完美协商实现示例的核心全部在 src/content/peerconnection/perfect-negotiation/js/peer.js 中结构非常清晰双端标识peer()函数接收polite布尔参数同一个函数既跑有礼貌端也跑无礼端peer.js#L18主动发起onnegotiationneeded回调中先断言处于stable状态再调用setLocalDescription()生成 Offer 并发送给对端peer.js#L68-L83冲突裁决收到 Offer 时无礼端若正忙makingOffer或非 stable就执行glare - ignoring offer直接忽略礼貌端则照常回滚处理peer.js#L94-L99ICE 容错撞车期间收到的候选地址会因忽略 Offer 而报InvalidStateError代码用ignoreOffer标记把这个错静默吞掉peer.js#L117-L122。演示脚手架在 src/content/peerconnection/perfect-negotiation/js/main.js用srcdoc动态生成两个 iframe 双端环境并通过postMessage做信令通道main.js#L21-L29。 新手提示不用纠结 postMessage 细节把它当成两条 WebRTC 端点之间的信令服务器即可生产环境换成 WebSocket 就是同样原理。五、举一反三项目中的相关示例Perfect Negotiation 解决的是协商层问题项目里还有多个示例可以配合学习覆盖 WebRTC 全链路示例路径学什么基础音视频通话src/content/peerconnection/pc1/PeerConnection 最小可用闭环ICE trickle 候选src/content/peerconnection/trickle-ice/ICE 候选交换时机多端连接src/content/peerconnection/multiple/三方及以上协商ICE 重启src/content/peerconnection/restart-ice/网络切换后恢复连接更多示例入口见项目首页 index.html。六、总结3 个要点带走Glare 不可怕双方同时发 Offer 是分布式信令的常态问题Perfect Negotiation 用礼貌端回滚、无礼端坚持的规则把它变成了可自愈的常态流程固定角色应用中给每个端点固定分配 polite / impolite 身份例如按用户 ID 的奇偶规则就能稳定生效跑一遍胜过读十遍在本地运行本示例盯着控制台的协商日志制造一次 glare你会对stable → have-local-offer → stable的状态机有肌肉记忆。掌握 Perfect Negotiation你的 WebRTC 应用就从能用迈向了稳定。【免费下载链接】samplesWebRTC Web demos and samples项目地址: https://gitcode.com/gh_mirrors/sa/samples创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考