【鸿蒙优选三方库】@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,硬件加速自动启用
音频 3AAEC / ANS / AGC 内置
数据通道RTCDataChannel 低延迟任意数据传输
屏幕共享getDisplayMedia
Stats APIRTT / 丢包率 / 码率等完整指标

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 是目前唯一完整的选择。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐