go2rtc 接入 Wyze 摄像头基于原生 P2P 与 DTLS 协议的流媒体集成指南【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc导读本文以 go2rtc 仓库中 internal/wyze/README.md 为骨架系统讲解如何在 go2rtc 中接入 Wyze 摄像头无需 Wyze App 与官方 SDK仅凭 Wyze 账号与 P2P 协议即可实现本地直连拉流并支持 H.264/H.265 视频、AAC/G.711/PCM/Opus 音频、双向对讲Intercom以及 HD/SD 分辨率切换。文章将覆盖账号配置、WebUI 添加流程、wyze://流地址格式、配置参数详解与设备兼容性矩阵并结合 internal/wyze/wyze.go 与 pkg/wyze 下的源码实现深入解析其云端鉴权、DTLS 加密连接、TUTK 信令与码流探测等底层原理让读者既能在 WebUI 上快速上手也能理解整条链路的运转机制。功能特性总览该 sourcego2rtc 中把流来源抽象为 source允许直接以原生 P2P 方式从 Wyze 摄像头拉流全程不依赖 Wyze App 或官方 SDK。核心特性如下视频编码支持 H.264 与 H.265音频编码支持 AAC、G.711PCMU/PCMA、PCM 与 Opus双向对讲支持向摄像头扬声器回传音频Intercom分辨率切换支持 HD/SD 两档分辨率甚至更多档位本地直连流媒体全程走局域网 P2P 直连仅账号加载阶段需要访问公网。前提条件与重要限制在开始之前请先确认以下四点均来自 README 的 Important 说明必须拥有 Wyze 账号需要通过 WebUI 登录一次以拉取账号下的摄像头列表固件必须支持 DTLS只有启用了 DTLS 的固件才能被支持协议层直接要求dtlstrue公网仅用于加载设备列表从账号加载摄像头之后所有流媒体传输都是本地 P2P不再需要互联网连接仅限本地P2P 连接是直接指向摄像头局域网 IP 的直连并非云端中转。从源码看这些限制与实现严格一致pkg/wyze/client.go 的Dial函数在dtls参数不为true时直接返回wyze: only DTLS cameras are supported即非 DTLS 摄像头根本无法建立连接。快速上手WebUI 添加 Wyze 摄像头第一步获取 API Key前往 Wyze 开发者门户申请你的 API Key获取 API ID 与 API Key 两个凭证这一步需要 Wyze 账号本身。WebUI 的添加页面www/add.html也内置了该说明链接。第二步WebUI Add Wyze 登录在 go2rtc WebUI 的 Add 页面点击 Wyze 按钮会展开一个登录表单www/add.html需要填写四个字段API ID开发者门户申请到的 API IDAPI Key开发者门户申请到的 API KeyemailWyze 账号邮箱passwordWyze 账号密码。提交后前端通过POST api/wyze调用后端接口完成登录www/add.html后端处理逻辑位于 internal/wyze/wyze.go 的apiAuth先调用 Wyze 云端Login成功后把账号凭证通过app.PatchConfig写入wyze.email配置节随后立即拉取摄像头列表返回给前端表格。第三步选择摄像头生成流地址登录成功后页面会展示账号下的摄像头列表名称、型号、MAC、IP 以及自动生成的wyze://流 URL。你也可以在已保存账号下拉框中切换账号通过GET api/wyze?idemail重新加载设备列表www/add.html后端对应 apiDeviceList。后端在返回设备列表时会调用buildStreamURLinternal/wyze/wyze.go为每台摄像头拼接流地址以摄像头局域网 IP 为主机附带uidP2P ID、enrDTLS 加密密钥、mac、model等参数并在设备支持 DTLScam.DTLS 1时自动追加dtlstrue。配置示例与账号说明账号配置wyze 配置节在 go2rtc 配置文件中wyze节按邮箱组织账号wyze: useremail.com: api_id: your-api-id api_key: your-api-key password: yourpassword # or MD5 triple-hash with md5: prefix对应源码中的结构体 AccountConfigYAML 字段说明api_idWyze 开发者门户申请的 API IDapi_keyWyze 开发者门户申请的 API KeypasswordWyze 账号密码也支持md5:前缀传入三重 MD5 哈希后的值密码的两种写法对应 pkg/wyze/cloud.go 的hashPassword实现若密码以md5:前缀开头则直接截取前缀后的十六进制串使用否则对明文连续做 3 次 MD5 哈希。也就是说md5:后应填写对明文密码做 3 次 MD5得到的值避免在配置文件中出现明文。从 Init 可以看到该配置节在启动时通过app.LoadConfig加载并注册了wyze流协议处理器任何wyze://开头的流地址都会交给wyze.NewProducer创建流。getCloudinternal/wyze/wyze.go则按邮箱取出账号配置并要求api_key与api_id均非空否则报错。流配置streams 配置节streams: wyze_cam: wyze://192.168.1.123?uidWYZEUID1234567890ABenrxxxmacAABBCCDDEEFFmodelHL_CAM4dtlstruewyze:// 流地址格式详解在 WebUI 添加摄像头时流 URL 会自动生成。其完整格式为wyze://[IP]?uid[P2P_ID]enr[ENR]mac[MAC]model[MODEL]subtype[hd|sd]dtlstrue各参数含义如下表参数说明IP摄像头局域网 IP 地址uidP2P 标识符20 字符enrDTLS 使用的加密密钥mac设备 MAC 地址model摄像头型号如HL_CAM4dtls是否启用 DTLS 加密默认truesubtype摄像头分辨率hd或sd默认hd在 pkg/wyze/client.go 的Dial中uid、enr、mac、model分别用于建立连接与鉴权enr与mac共同派生出 DTLS 认证密钥CalculateAuthKey见 pkg/tutk/dtls/auth.gouid是 IOTC 会话标识model则决定分辨率档位与门铃类设备的信令格式。另外verbosetrue参数可开启调试输出源码在Dial中解析排查问题时可临时追加。分辨率切换通过subtype参数可以切换摄像头的分辨率streams: wyze_hd: wyze://...subtypehd wyze_sd: wyze://...subtypesd虽然 README 只描述了hd/sd两档但 pkg/wyze/client.go 与 pkg/wyze/producer.go 展示了更细的分档实现实际支持 5 种档位值含义0 /hd默认自动高清按型号取最佳档位1080P / 2K / Floodlight1 /sdSD / 360P2720P32K仅 2K 型号生效否则回退 HD4Floodlight 专用档位SetResolutionpkg/wyze/client.go在内部把档位映射为frameSize与bitrate两元组HD 与 2K 使用最大码率BitrateMax0xF0SD 使用BitrateSD0x3C。部分门铃/特定型号WYZEDB3、WVOD1、HL_WCO2、WYZEC1走 K10052 指令格式其余型号走 K10056 指令格式。hd档位最终落到哪个 frame size取决于hdFrameSize()/is2K()/isFloodlight()对model的判断例如HL_CAM3P、HL_PANP、HL_CAM4、HL_DB2、HL_CFL2视为 2K 设备。双向对讲Intercom双向对讲在 README 中被描述为自动支持当有消费者向该流发送音频时音频会被传输到摄像头扬声器。从源码看这一自动建立在探测阶段的能力发现上。pkg/wyze/producer.go 的probe在检测到音频编码且client.SupportsIntercom()为真时会额外追加一路DirectionSendonly的音频 Media使用与下行相同的编码参数并调用SetBackchannelCodec记录回传编码。hasIntercom由 pkg/wyze/client.go 的c.conn.HasTwoWayStreaming()在 K 鉴权完成后确定。真正的对讲链路在 pkg/wyze/backchannel.go 的AddTrack中启用对讲后通过 K10010 指令打开MediaTypeReturnAudio3通道并等待AVServStart随后把消费者发来的 RTP 音频转换为摄像头期望的编码AAC 会转封装为 ADTS并维护一个从 0 开始、按帧时长微秒递增的时间戳通过AVSendAudioData发送到摄像头扬声器。兼容性矩阵README 给出了官方设备兼容性列表其中Gwell 协议标注*的设备目前尚未支持名称型号固件协议加密编码Wyze Cam v4HL_CAM44.52.9.4188TUTKTransCodeh264, aac4.52.9.5332TUTKHMAC-SHA1h264, aacWyze Cam v3 ProTUTKWyze Cam v3WYZE_CAKP2JFUS4.36.14.3497TUTKTransCodeh264, pcmWyze Cam v2WYZEC1-JZ4.9.9.3006TUTKTransCodeh264, pcmuWyze Cam v1TUTKWyze Cam Pan v4Gwell*Wyze Cam Pan v3TUTKWyze Cam Pan v2TUTKWyze Cam Pan v1TUTKWyze Cam OGGwell*Wyze Cam OG TelephotoGwell*Wyze Cam OG (2025)Gwell*Wyze Cam Outdoor v2TUTKWyze Cam Outdoor v1TUTKWyze Cam Floodlight Pro?Wyze Cam Floodlight v2TUTKWyze Cam FloodlightTUTKWyze Video Doorbell v2HL_DB24.51.3.4992TUTKTransCodeh264, pcmWyze Video Doorbell v1TUTKWyze Video Doorbell Pro?Wyze Battery Video Doorbell?Wyze Duo Cam Doorbell?Wyze Battery Cam Pro?Wyze Solar Cam Pan?Wyze Duo Cam Pan?Wyze Window Cam?Wyze Bulb Cam?Gwell 协议尚未支持README 原注_* Gwell based protocols are not yet supported._。这一点在源码中同样有体现云端设备列表解析pkg/wyze/cloud.go会跳过ProductType ! Camera以及DeviceParams.IP 注释明确写着 skip cameras without IP (gwell protocol)的设备即 Gwell 协议摄像头不会被列入可添加列表。底层工作原理从云端鉴权到本地 P2P 拉流为了让读者对为什么能不经 App/SDK 直接拉流有完整认知这里结合源码梳理整条链路的四个阶段。1. 云端账号鉴权与设备发现pkg/wyze/cloud.go 的Login使用API Key/Key ID作为请求头把邮箱与三重 MD5 后的密码 POST 到 Wyze 认证服务auth-prod.api.wyze.com/api/user/login。若返回MFAOptions非空则抛出AuthErrorNeedsMFA前端会收到 401 与 MFA 提示成功则保存access_token。随后GetCameraListpkg/wyze/cloud.go携带 access_token、phone_id 等字段调用api.wyzecam.com/app/v2/home_page/get_object_list从响应中提取每台设备的 MAC、ENR、P2P ID、IP、型号、固件版本与 DTLS 能力等字段构成 Camera 结构——这正是wyze://URL 中各参数的来源。2. DTLS 加密连接与 K 系列指令鉴权与摄像头的本地连接使用 IOTC DTLS。pkg/wyze/client.go 的connect通过dtls.DialDTLS(host, port, uid, authKey, enr, verbose)建立加密通道其中authKey由enr 大写MAC的 SHA-256 哈希再经 Base64 变换而来pkg/tutk/dtls/auth.goDTLS PSK 则派生自 ENRDerivePSK注意 TUTK 会把包含0x00的 PSK 截断。连接建立后依次执行两类登录AV LoginAVClientStart完成 IOTC 层的 AV 会话登录pkg/wyze/client.goK 指令鉴权doKAuthpkg/wyze/client.go通过 K10000→K10001 获取挑战值再以 K10002→K10003 提交基于 ENR 与状态码生成的挑战响应完成鉴权并从 K10003 响应中解析出音频能力hasAudio与双向流能力hasIntercom。3. 码流探测与编解码协商鉴权完成后pkg/wyze/producer.go 的probe开始读取设备上报的码流识别视频编码H.264 取 SPS、H.265 取 VPS 生成 codec 描述与音频编码PCMU/PCMA/AAC/Opus/PCM/MP3/MJPEG 等据此构建 go2rtc 的core.Media列表。若支持对讲则额外附加一路 sendonly 音频 Media。SetResolution的分辨率指令也在探测前下发pkg/wyze/producer.go。4. 流传输与编码转换Producer.Start 持续从 DTLS 连接读取 TUTK 数据帧按pkt.Codec映射为 go2rtc 的 RTP 包H.264/H.265 走 Annex-B → AVCC 转换AAC 去掉 ADTS 头后按 RTP 封装G.711/PCM/Opus 等直接透传。之后按接收者的编码名称分发到各消费者WebRTC/RTSP/HLS/MP4 等 go2rtc 出口实现一次拉流、多协议转发。常见问题排查报错only DTLS cameras are supported摄像头固件不支持 DTLS无法通过本 source 接入可先确认固件版本是否满足 README 兼容性列表登录返回 MFA 相关错误账号开启了双重验证云端会返回AuthErrorpkg/wyze/cloud.go需要在满足 MFA 流程后再进行配置列表缺少某台摄像头检查是否为 Gwell 协议设备Pan v4、OG 系列等这类设备目前会被云端列表接口直接跳过pkg/wyze/cloud.go需要排查连接细节可在wyze://URL 中追加verbosetrue开启客户端调试日志观察 DTLS 连接、AV Login、K 鉴权与码流探测各阶段输出。延伸阅读source 入口与配置解析internal/wyze/wyze.go云端 API 客户端登录、设备列表、P2P 信息pkg/wyze/cloud.goP2P 客户端DTLS 拨号、K 鉴权、分辨率指令pkg/wyze/client.go流生产者与编码转换pkg/wyze/producer.go对讲回传链路pkg/wyze/backchannel.go底层 TUTK 协议与 DTLS 实现pkg/tutk、pkg/tutk/dtls/auth.goWebUI 添加页面 www/add.html【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考