更新记录

1.0.0（2026-06-12）

• 首次发布，基于阿里云音视频通信 (ARTC) 原生 SDK 封装 UTS 插件。
• 支持音频通话、视频通话以及频道管理功能。
• 支持本地静音、扬声器切换、前后置摄像头切换等设备控制。
• 随插件提供音频通信与视频通信的完整 Demo，方便快速参考和集成。

平台兼容性

uni-app(4.0)

其他

阿里云 RTC UTS 插件 (wenxi-aliyunrtc)

这是基于阿里云音视频通信（ARTC）原生 SDK 封装的 UniApp UTS 插件。支持在 UniApp 及 UniApp X 项目中实现实时音视频通话功能。

功能特性

• 支持音频通话、视频通话。
• 支持频道管理（加入频道、离开频道）。
• 支持本地静音、扬声器切换。
• 支持前后置摄像头切换、视频推流/拉流管理。

环境要求

• HBuilderX 4.0+
• 支持 iOS 和 Android 端。

快速上手

1. 引入插件

将本插件放置在项目的 uni_modules/ 目录下（通常通过插件市场安装即可）。

2. 权限配置

Android 权限申请 请确保在项目的 manifest.json 中配置了必要的摄像头、麦克风及网络权限：

"android" : {
  "permissions" : [
    "<uses-permission android:name=\"android.permission.INTERNET\"/>",
    "<uses-permission android:name=\"android.permission.RECORD_AUDIO\"/>",
    "<uses-permission android:name=\"android.permission.CAMERA\"/>",
    "<uses-permission android:name=\"android.permission.MODIFY_AUDIO_SETTINGS\"/>",
    "<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
    "<uses-permission android:name=\"android.permission.ACCESS_WIFI_STATE\"/>"
  ]
}

iOS 权限申请 请确保配置了摄像头和麦克风的使用描述：

"ios" : {
  "privacyDescription" : {
    "NSCameraUsageDescription" : "需要使用摄像头用于视频通话",
    "NSMicrophoneUsageDescription" : "需要使用麦克风用于音频通话"
  }
}

3. 基本使用

在你的页面中（推荐使用 .uvue 页面或 vue3 lang="uts" 页面）：

import { createRtcEngine, UAliRtcAuthInfo, UAliRtcEventListener } from "@/uni_modules/wenxi-aliyunrtc"

const listener = {
  onJoinChannelResult: (result, channel, userId, elapsed) => {
    console.log("加入频道", result)
  },
  onRemoteUserOnLineNotify: (userId, elapsed) => {
    console.log("远端用户上线", userId)
  }
} as UAliRtcEventListener

const engine = createRtcEngine(listener)

// 加入频道
const authInfo = {
  channelId: "12345",
  userId: "user_1",
  appId: "your_app_id",
  nonce: "nonce",
  token: "token",
  timestamp: Date.now() / 1000 + 86400
} as UAliRtcAuthInfo

engine.joinChannel(authInfo, "User1")

注意事项

1. 原生视频视图渲染目前依赖传递指定的 viewId 给 setLocalViewConfig 或 setRemoteViewConfig，但在非 uniapp-x 下暂不支持原生视图绑定。
2. 页面卸载或组件销毁前，请务必调用 engine.destroy() 释放引擎资源，避免后台长期占用摄像头或麦克风。

交流反馈

如果有任何问题，欢迎提出。