平台支持
- Android
更新时间不可用
了解实时消息 RTM 支持的平台、系统版本、浏览器环境和兼容性要求。
| 目标架构 | 运行环境最小版本 | 操作系统最小版本 |
|---|---|---|
| armeabi-v7、arm64-v8a、x86、x86-64 | JVM 8 | Android 7.0 |
| 平台 | 目标架构 | 操作系统最小版本 |
|---|---|---|
| iOS | armv7、arm64 | 11.0 |
| macOS | x86-64、arm64 | 10.10 |
| VisionOS | arm64 | 1.0 |
平台
平台支持如下表所示。
| 名称 | 运行平台 | 最低支持版本 |
|---|---|---|
| Chrome | macOS | 90.0.4430.72 |
| Windows | 90.0.4430.72 | |
| Android | 97.0.4692.70 | |
| iOS | 120.0.6099.199 | |
| Safari | macOS | 15.6 |
| iOS | 15.6 | |
| Microsoft Edge | macOS | 116.0.1938.81 |
| Windows | 116.0.1938.81 | |
| Firefox | macOS | 85.0.1 |
| Windows | 85.0.1 | |
| 微信内置浏览器 | macOS | 3.8.6 |
| Windows | 3.9.8.25 | |
| Android | 8.0.45 | |
| iOS | 8.0.45 | |
| 企业微信内置浏览器 | Android | 4.1.6 |
| iOS | 4.1.6 |
依赖库
RTM JavaScript SDK 的依赖库及许可证信息如下表所示。
| 名称 | 最小版本 | 许可证 | 依赖方式 |
|---|---|---|---|
@thi.ng/cache | 1.0.70 | Apache 2.0 | 传递性依赖 |
| @types/format-util | 1.0.1 | MIT | 传递性依赖 |
| @types/google-closure-compiler | 0.0.18 | MIT | 传递性依赖 |
| @types/node-forge | 1.3.1 | BSD 2-Clause | 传递性依赖 |
| abortcontroller-polyfill | 1.7.1 | MIT | 传递性依赖 |
| console-polyfill | 0.3.0 | MIT | 传递性依赖 |
| core-js | 3.9.0 | MIT | 传递性依赖 |
| debug | 4.3.4 | MIT | 传递性依赖 |
| dotenv | 8.2.0 | BSD 2-Clause | 传递性依赖 |
| events | 3.2.0 | MIT | 传递性依赖 |
| format-util | 1.0.5 | MIT | 传递性依赖 |
| gud | 1.0.0 | MIT | 传递性依赖 |
| is-mobile | 3.1.1 | MIT | 传递性依赖 |
| is-what | 3.14.1 | MIT | 传递性依赖 |
| lodash | 4.17.21 | MIT | 传递性依赖 |
| long | 4.0.0 | Apache 2.0 | 传递性依赖 |
| lru-cache | 6.0.0 | ISC | 传递性依赖 |
| neverthrow | 5.0.1 | MIT | 传递性依赖 |
| node-forge | 1.3.1 | BSD 3-Clause or GPL 2 | 传递性依赖 |
| promise-polyfill | 8.2.0 | MIT | 传递性依赖 |
| protobufjs | 6.10.2 | MIT | 传递性依赖 |
| regenerator-runtime | 0.13.9 | MIT | 传递性依赖 |
| rxjs | 6.6.3 | Apache 2.0 | 传递性依赖 |
| rxjs-etc | 10.6.0 | MIT | 传递性依赖 |
| rxjs-websockets | 8.0.1 | ISC | 传递性依赖 |
| safe-json-stringify | 1.2.0 | MIT | 传递性依赖 |
| tslib | 2.1.0 | BSD Zero Clause | 传递性依赖 |
| uuid | 3.4.0 | MIT | 传递性依赖 |
| webcrypto-shim | 0.1.6 | MIT | 传递性依赖 |
| 目标架构 | 开发语言 | API 最小版本 |
|---|---|---|
| arm64-v8a | ArkTS | HarmonyOS API 19 |
| 目标平台 | 目标架构 | 脚本运行版本 | 操作系统最小版本 |
|---|---|---|---|
| Android | armeabi-v7a、arm64-v8a、x86、x86-64 | .NET 4.x Equivalent | Android 4.1 |
| iOS | arm64、armv7 | .NET 4.x Equivalent | iOS 9.0 |
依赖工具
各平台支持情况如下。Unity 集成所需工具及许可证信息如下表所示。
| 名称 | 最小版本 | 许可证 | 许可证获得方式 |
|---|---|---|---|
| Unity Editor | 2018.4.26f1 | https://unity.com/cn/legal | 用户自行申请 |
| 目标平台 | 目标架构 | 开发环境最小版本 |
|---|---|---|
| Android |
|
|
| iOS | - | macOS 10.15 |
信息
- 更多环境要求细节,详见 Install Flutter。
- 你可以运行
flutter doctor命令检查开发和运行环境是否达到要求。
依赖工具
| 名称 | 最小版本 | 许可证 | 许可证获得方式 |
|---|---|---|---|
| Flutter SDK | 3.10.0 | BSD 3-Clause | 自行下载 |
| Dart SDK | 3.0 | BSD 3-Clause | 自行下载 |
| json_annotation | 4.4.0 | BSD-3-Clause | 传递性依赖 |
| ffi | 1.1.2 | BSD 3-Clause | 传递性依赖 |
| async | 2.8.2 | BSD 3-Clause | 传递性依赖 |
| meta | 1.7.0 | BSD 3-Clause | 传递性依赖 |
| iris_method_channel | 2.2.0 | MIT | 传递性依赖 |
| flutter_lints | 1.0.0 | BSD 3-Clause | 传递性依赖 |
| build_runner | 2.1.7 | BSD 3-Clause | 传递性依赖 |
| json_serializable | 6.1.1 | BSD 3-Clause | 传递性依赖 |
| ffigen | 4.1.2 | BSD 3-Clause | 传递性依赖 |
| 目标平台 | 目标架构 | 运行环境最小版本 | 操作系统最小版本 |
|---|---|---|---|
| Linux | x86-64 | C++ 14 | Ubuntu 18.04 LTS(64 位)或 Debian 9.9(64 位) |
| Windows | x86 | C++ 14 | Windows >= 7 |
| Windows | x86-64 | C++ 14 | Windows >= 7 |
| 平台 | 目标架构 | 操作系统最小版本 |
|---|---|---|
| iOS | armv7、arm64 | 11.0 |
| macOS | x86-64、arm64 | 10.10 |
| VisionOS | arm64 | 1.0 |
本文介绍 RTM 微信小程序 SDK 的运行环境和集成要求。
支持环境
集成 SDK 前,请确认项目满足以下要求:
- 已启用 npm 包支持的微信小程序项目。
- 当前稳定版本的微信开发者工具。
- 开发环境中已安装 Node.js 和 npm。
- 如需在主小程序 appservice 中加载 RTM SDK,微信小程序基础库版本需为 2.13.0 或以上。
- 已开通 RTM 服务并具有有效 App ID 的声网项目。
- 生产环境中已准备由业务服务器生成的 RTM Token。
- 已按照快速开始说明将 SDK 的 WebAssembly 文件放入小程序项目根目录下的
wasm/目录。 - 已将所需的 request 和 socket 域名添加到微信公众平台的服务器域名白名单。
小程序基础库要求
| 使用场景 | 最低基础库版本 |
|---|---|
| 主小程序 appservice | 2.13.0 |
| 小程序 Worker | 2.15.0 |
| 小程序插件 | 2.18.1 |
RTM SDK 使用的 WebAssembly 特性包括 atomics、mutable-globals、bulk-memory 和 sign-ext。由于微信小程序官方文档未明确列出这些特性的支持情况,请在目标运行环境中完成兼容性测试后再发布。
当前版本尚未完成按操作系统、系统版本、终端设备和微信版本维度的完整兼容性测试,因此本文不提供 Android、iOS、Windows、macOS 或 HarmonyOS 的具体支持版本列表。
已测试设备
以下为当前版本已完成验证的测试设备和微信版本,仅表示这些环境已测试通过,不代表完整支持版本矩阵。发布前请在你的目标运行环境中完成兼容性测试。
| 平台 | 测试环境 |
|---|---|
| Android | mi 10,Android 11 华为 nova 6,OS 4.2.0 微信版本:8.0.76 |
| iOS | iOS 15.5.3 微信版本:8.0.75 |
| Mac | MacBook Pro 13-inch, 2020, Four Thunderbolt 3 ports,OS 版本 14.2.1 (23C71) 微信版本:4.1.11 |
| Windows | Windows 11 微信版本:4.1.11.24 |
| 鸿蒙 | 华为 mate 70 pro,OS 版本 6.1.0 微信版本:8.0.20.47 |
npm 包
中国大陆地区使用声网服务的项目,使用以下 npm 包:
| 包名 | 安装方式 |
|---|---|
shengwang-rtm-miniapp | npm install shengwang-rtm-miniapp |
中国大陆以外地区使用 Agora 服务的项目,可使用 agora-rtm-miniapp。
WebAssembly 资源
安装 SDK 后,需要将包中的 WebAssembly 资源复制到小程序项目根目录下的 wasm/ 目录,并在微信开发者工具中执行构建 npm。如果未复制 WebAssembly 资源,SDK 将无法在小程序运行环境中正常初始化。
域名白名单
微信小程序项目需要在微信公众平台配置 request 合法域名和 socket 合法域名。完整域名列表见快速开始。
能力限制
微信小程序 SDK 不支持以下能力:
StreamChannel- Topic
RTMConfig.cloudProxyRTMConfig.privateConfig- 私有化部署
- 私有化配置
详见特性列表。