SDK 2.0.0。Web 没有原生那种统一的「GL 纹理前处理回调」。推荐管线是:
取帧 → processImage → 画到 canvas → captureStream / 取出 MediaStreamTrack → 交给第三方 SDK(replaceTrack 或自定义视频轨)。
鉴权必须用 Web 三选一(licenseToken / authProxyUrl / fetchAuthResponse),禁止把 appKey 打进前端。详见 授权与许可、实现美颜。
推荐管线(与厂商无关)
优先 processImage。processTexture 面向已有 GPU 纹理句柄、且不应用镜像,一般实时预览 / 推流用上面的 canvas 管线即可。
页面卸载时:beautyTrack.stop()、停掉 requestAnimationFrame,并 engine.destroy()。
接到第三方 SDK
各家 Web API 名称随版本变化。下面只写把 beautyTrack 塞进去的常见方式;进房、Token、设备枚举仍看对方文档。
TRTC(腾讯云 Web)
常见两种思路(以你使用的 trtc-js-sdk / TUI 版本为准):
- 用美颜轨创建本地流再发布(自定义视频源 / 传入
MediaStreamTrack)
- 先按官方创建摄像头流,再
replaceTrack(beautyTrack) 替换视频轨
不要假设存在与原生一致的 onProcessVideoFrame(textureId)。
声网 Agora Web
使用 自定义视频轨 或对已有轨 replaceTrack:
LiveKit Web
把处理后的轨交给 LiveKit 的本地视频轨工厂,或对已发布轨换轨:
相关文档