【鸿蒙优选三方库】@ohos/webrtc:把 Google 的 RTC 十年积累搬进鸿蒙
【鸿蒙优选三方库】@ohos/webrtc:把 Google 的 RTC 十年积累搬进鸿蒙
实时音视频的难点从来不是"传视频",而是 NAT 穿透、回声消除、拥塞控制、丢包补偿这一堆底层工程。
@ohos/webrtc是 Google WebRTC 在鸿蒙上的完整移植——这些坑别人替你踩了十年。
📦 仓库地址 |
ohpm install @ohos/webrtc| v1.0.3-rc.1 | Apache-2.0
它解决什么问题
做视频通话,你要面对:
- NAT 穿透:双方都在各自的路由器后面,怎么建立 P2P 连接?要 ICE / STUN / TURN
- 音频 3A:扬声器声音别回灌到麦克风(AEC)、环境噪声要消(ANS)、音量要自动调(AGC)
- 视频编解码:H.264 / VP8 / VP9 / AV1,还要硬件加速
- 拥塞控制:网络差时自动降码率,别卡成 PPT
- 媒体加密:DTLS / SRTP
自己实现?按年算。WebRTC 是 Google / Mozilla / Opera 主导的开源项目,把上述全部整合进一套统一 API,是业界事实标准。
@ohos/webrtc 用 OHOS SDK 全量编译原生 WebRTC 代码,并提供 ArkTS 接口层——不是阉割版移植,音频设备和视频采集都有原生 OHOS 适配器。
核心能力
| 能力 | 说明 |
|---|---|
| 原生 WebRTC 内核 | 直接基于上游 webrtc.org 代码 |
| ArkTS 接口 | RTCPeerConnection / MediaStream / VideoTrack |
| 完整协议栈 | ICE / STUN / TURN / DTLS / SRTP / RTP / RTCP |
| 编解码 | VP8 / VP9 / H.264 / AV1,硬件加速自动启用 |
| 音频 3A | AEC / ANS / AGC 内置 |
| 数据通道 | RTCDataChannel 低延迟任意数据传输 |
| 屏幕共享 | getDisplayMedia |
| Stats API | RTT / 丢包率 / 码率等完整指标 |
30 秒上手
ohpm install @ohos/webrtc
权限:INTERNET + CAMERA + MICROPHONE。
import { RTCPeerConnection, mediaDevices } from '@ohos/webrtc'
// 1. 采集本地音视频(3A 自动开启)
const localStream = await mediaDevices.getUserMedia({
audio: true,
video: { width: 1280, height: 720 },
})
// 2. 建连
const pc = new RTCPeerConnection({
iceServers: [
{ urls: ['stun:stun.l.google.com:19302'] },
{ urls: ['turn:turn.example.com:3478'], username: 'u', credential: 'p' },
],
})
// 3. 加本地轨道
localStream.getTracks().forEach((t) => pc.addTrack(t, localStream))
// 4. 收远端流
pc.ontrack = (e) => renderRemote(e.streams[0])
// 5. ICE 候选交给信令服务器转发
pc.onicecandidate = (e) => { if (e.candidate) signaling.send({ type: 'ice', candidate: e.candidate }) }
// 6. 创建 Offer
const offer = await pc.createOffer()
await pc.setLocalDescription(offer)
signaling.send({ type: 'offer', sdp: offer.sdp })
信令服务器可以用 WebSocket / MQTT / gRPC 任意实现——WebRTC 不规定信令协议,只要能在双方之间转发 SDP 和 ICE 候选即可。
社区已解决的典型问题
前置摄像头锁定横屏时画面 180° 倒置(#200)
UpdateRotation() 的前置摄像头分支没有使用 cameraOrientation,导致发布流和本地预览都倒置。已修复。支持横屏的 App 务必在"横屏 + 前置"组合下实测——竖屏测试发现不了这个问题。
图像镜像参数不生效(#199)
设置镜像的参数没起作用。已修复。正确行为是:本地预览镜像(像照镜子),远端收到的非镜像。
Surface 创建前 setVideoTrack 导致黑屏(#192)
在 Surface 还没创建时就调 setVideoTrack,AddSink 失效,画面黑屏。已修复时序问题,并在 Surface 重建时正确重挂 sink。业务侧仍应严格遵守"Surface 就绪后再绑轨道"。
录屏 CFI 检测问题 + 抓屏不稳定(#194 / #193)
屏幕共享涉及系统级权限和安全检测,两个问题都已修复。要用屏幕共享的话升级到最新版,并覆盖测试锁屏、切应用、来电打断等场景。
摄像头方向验收清单
设备适配问题只有真机能测出来,上线前照这个表过一遍:
| 场景 | 预期 |
|---|---|
| 竖屏 + 前置 | 本地预览镜像、远端正常 |
| 竖屏 + 后置 | 本地不镜像、远端正常 |
| 横屏 + 前置 | ✅ 不倒置 |
| 横屏 + 后置 | ✅ 不倒置 |
| 通话中旋转屏幕 | 画面平滑过渡 |
| 切后台再回前台 | ✅ 不黑屏 |
适合谁用
- 一对一视频/语音通话:社交、问诊、远程协助
- 多人会议:搭配 SFU(mediasoup / Janus / SRS)
- 互动直播 / 连麦:低延迟音视频互动
- 在线教育:师生互动 + 屏幕共享
- 视频客服 / 远程柜员:金融政务的严肃场景
- IoT 实时监控:摄像头推流、移动端观看
- P2P 数据传输:用 RTCDataChannel 传非音视频数据
179 个 Issue 已关闭,其中相当一部分是鸿蒙设备特有的适配问题。做 RTC 选 WebRTC 几乎不用思考,而在鸿蒙上,@ohos/webrtc 是目前唯一完整的选择。
更多推荐




所有评论(0)