pion的peerconnection仅实现单个端到端连接协议栈，不提供信令、房间管理或媒体路由；必须自行搭建websocket信令通道、显式配置stun/turn、隔离实例、注册编解码器，任一缺失均导致黑屏静音。

直接说结论：Pion webrtc.PeerConnection 本身不提供信令、房间管理或媒体路由能力，只负责单个端到端连接的协议栈实现；想跑通音视频流，必须自己搭 WebSocket 信令通道、显式配置 STUN/TURN、隔离每个连接的 PeerConnection 实例，并正确注册编解码器——漏掉任一环，浏览器就黑屏静音。

为什么 OnTrack 回调从不触发？

这是最常被卡住的点，现象是浏览器发了 addTrack，服务端日志却完全没进 pc.OnTrack。根本原因不是网络不通，而是 SDP 协商失败导致 track 被静默丢弃。

• 浏览器 offer 带了 H.264，但 Pion 默认只注册了 VP8 和 Opus，协商时跳过该 track，不报错也不回调
• MediaEngine 必须在创建 PeerConnection 前手动注册所需 codec：m.RegisterCodec(webrtc.RTPCodecParameters{MimeType: "video/h264"}, webrtc.RTPCodecTypeVideo)
• 检查浏览器生成的 offer SDP 中是否含 a=recvonly 或 a=inactive —— 某些前端库（如 simple-peer）默认设为只收，需显式改成 a=sendrecv
• 确保 pc.OnTrack 在 pc.SetRemoteDescription 之前就已设置，否则早期 candidate 可能丢失

ICE candidate 死活不触发？

pc.OnICECandidate 不回调，通常意味着 ICE 收集根本没启动，而不是收集失败。

Alibabacloud Sdk Client Initialization For Golang

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

• SettingEngine 未启用 ICE 自动启动：需调用 se.SetAutomaticGathering(false) 后再 se.SetNAT1To1IPs 等，否则某些内网环境直接跳过收集
• ICEServers 配置为空或 URL 格式错误（比如写成 stun:// 而非 stun:），Pion 会静默忽略，不报错但 ICE 不工作
• UDP 端口被占用或防火墙拦截：net.ListenUDP 失败时 Pion 不 panic，只让 ICE 停摆；建议启动时加日志：log.Printf("listening on %v", addr)
• 测试阶段可用 Google 公共 STUN：[]webrtc.ICEServer{{URLs: []string{"stun:stun.l.google.com:19302"}}，但别用于生产

多个客户端连上来，音视频串流或崩溃？

Pion 的 PeerConnection 实例不是线程安全的共享对象，复用配置或回调会导致状态污染。

• 每个 WebSocket 连接必须绑定唯一 *webrtc.PeerConnection，不能全局复用一个实例
• MediaEngine 和 SettingEngine 也不能跨 PeerConnection 复用；每次 new 都要新建：m := &webrtc.MediaEngine{}
• OnICECandidate 回调里必须把 candidate 推给对应客户端，不能广播；否则 A 的 candidate 被 B 收到，B 会尝试连 A 的私有 IP，必然失败
• 连接关闭时务必调用 pc.Close()，否则 UDP fd 不释放，下次 NewPeerConnection 可能报 address already in use

真正麻烦的从来不是代码写几行，而是每个 PeerConnection 生命周期里，SetRemoteDescription、CreateAnswer、OnICECandidate、OnTrack 这四件事的时序和作用域必须严丝合缝——差一点，流就断在半路，还查不出错在哪。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！