更新记录

1.0.3（2026-08-04） 下载此版本

本地视频预览真正可用 开启视频时创建原生预览容器（Android TextureView / iOS 本地 canvas），绑定 setLocalVideoCanvas，并 publish 视频流；关闭时解绑并移除视图。

修复 Android 编译参数 setLocalVideoCanvas 改为 (StreamIndex.STREAM_INDEX_MAIN, VideoCanvas)，避免之前 VideoCanvas / StreamIndex 类型不匹配导致插件编译失败。

原生层盖在 WebView 之上，并给底部留空 预览容器提到内容层前面，底部预留约 200dp，保证麦克风 / 挂断 / 切视频按钮还能点。

新增字幕浮层 API：setVolcRtcVideoOverlay 在原生视频上画 AI 气泡、用户气泡、「正在听」等状态。因为 TextureView 会挡住 Vue / cover-view，所以字幕必须走原生绘制。

Android / iOS 同步改 VolcRtcNative.kt、VolcRtcNative.swift 以及两边的 index.uts、index.d.ts、interface.uts 都补了对应桥接。

1.0.1（2026-07-13） 下载此版本

• 完善插件市场 package.json 元数据与平台声明
• 开启视频时优先使用后置摄像头（Android CameraId.CAMERA_ID_BACK / iOS .back）
• 补充 API 文档、集成指南、插件市场上传说明
• 新增打包脚本 npm run pack:volcengine-rtc

平台兼容性

uni-app(4.0)

火山引擎 RTC UTS 原生插件

按 火山引擎多端集成方案：

微信小程序

见 uni_modules/volcengine-rtc-mp/README.md，运行：

npm run install:volc-mp-sdk -- -ZipPath "C:\path\to\VolcEngineRTC_Miniapp_WeChat.zip"

并在微信公众平台配置 socket 合法域名（wss://ws.rtc.volcvideo.com 等，见官方文档）。 | Android | Android SDK | utssdk/app-android | | iOS | iOS SDK | utssdk/app-ios | | 鸿蒙 | Web SDK | 不使用本插件，经 web-view 加载 H5 |

Android 集成步骤

1. 在 火山控制台 创建应用，获取 AppId。
2. 按官方文档将 VolcEngineRTC-lite（或 Full SDK）加入 utssdk/app-android/config.json 的 dependencies。
3. 在 utssdk/app-android/VolcRtcNative.kt 中对接 3.58+ 的 RTCVideo.createRTCVideo / RTCRoom.joinRoom / startAudioCapture 等 API（旧版 RTCEngine 已废弃）。
4. 在 AndroidManifest.xml（通过 uni-app 权限配置）声明 RECORD_AUDIO、可选 CAMERA。

iOS 集成步骤

1. 通过 CocoaPods / SPM 引入 VolcEngineRTC（在 utssdk/app-ios/config.json 配置）。
2. 在 utssdk/app-ios/index.uts 中对接 ByteRTCVideo / joinRoom 等 API。
3. 在 Info.plist 添加 NSMicrophoneUsageDescription、可选 NSCameraUsageDescription。

TypeScript 调用

import {
  setVolcRtcEventHandler,
  createVolcRtcEngine,
  joinVolcRtcRoom,
  startVolcRtcAudioCapture,
} from "@/uni_modules/volcengine-rtc";

setVolcRtcEventHandler((e) => console.log(e.type, e));
createVolcRtcEngine();
joinVolcRtcRoom("appId", "roomId", "userId", "token", JSON.stringify({ call_scene: "RTC-AIGC" }));

业务层封装见 src/utils/rtcService.native.ts。