已知问题与局限

由于小程序SDK是基于微信和 QQ 平台搭建，小程序的固有问题可能会影响您的使用体验，例如音视频通话场景中，如果将小程序组件的 live-player 组件中的 mode 字段设置为RTC，在部分iPhone 机型中可能会造成通话时音质差等声音问题。

随着小程序平台的升级迭代，该问题可能会逐步解决，当下我们推荐您采用临时方案规避，即设置 live 直播模式、并将缓冲区设置为推荐范围。该方案会致使通话延时增大到0.8～1s，但不影响正常使用。

操作步骤：

1. 将 live-player 组件中的 mode 字段设置为默认值 live。
2. 将 live-player 组件中的 min-cache 设置为 0.2s，将 max-cache 设置为 0.8s。

[4.6.11] - 2022-09-6

网易云信于 2022 年 9 月 6 日发布了 NERTC SDK 最新版本 V4.6.11。

优化

修复订阅异常引起的语法

[4.6.10] - 2022-07-11

网易云信于 2022 年 7 月 11 日发布了 NERTC SDK 最新版本 V4.6.10。

新增特性

支持订阅远端用户的音频辅流。

API 变更

API	API 说明
subscribe	接收远端音视频流。 该接口的 mediaType 参数增加 slaveAudio 枚举值，设置后，可以订阅远端用户的音频辅流。
unsubscribe	取消接收远端音视频流。 该接口的 mediaType 参数增加 slaveAudio 枚举值，设置后，可以取消订阅远端用户的音频辅流。

[4.6.0] - 2021-12-30

网易云信于 2021 年 12 月 30 日发布了 NERTC SDK 最新版本 V4.6.0。

新增特性

序号	新增特性	特性描述	相关文档
1	支持设置音频美声。	小程序端支持设置本地上行美声效果。	setVoiceBeautifierPreset
2	支持设置音频变声。	小程序端支持设置用户上行的音频变声。	setAudioEffectPreset
3	支持设置语音音调。	小程序端支持设置本地语音音调，例如将音调调高或者调低。	setLocalVoicePitch
4	支持设置语音音效均衡。	小程序端支持设置本地语音音效均衡，即自定义设置本地人声均衡波段的中心频率。	setLocalVoiceEqualization
5	支持添加推流任务。	小程序端支持添加推流任务。	addTasks
6	支持更新推流任务。	小程序端支持更新推流任务。	updateTasks
7	支持删除推流任务。	小程序端支持删除推流任务。	deleteTasks

API 变更

新增 API

API	API 说明
setVoiceBeautifierPreset	设置用户上行的音频美声。
setAudioEffectPreset	支持设置用户上行的音频变声
setLocalVoicePitch	支持设置本地语音音调
setLocalVoiceEqualization	支持设置本地语音音效均衡
addTasks	支持添加推流任务。
updateTasks	支持更新推流任务。
deleteTasks	支持删除推流任务。

[4.4.1] - 2021-08-31

网易云信于 2021 年 8 月 30 日发布了 NERTC SDK 最新版本 V4.4.1。

新增特性

序号	新增特性	特性描述	相关文档
1	支持订阅屏幕共享流。	小程序端支持订阅屏幕共享流，观看远端的屏幕共享画面。	subscribe

API 变更

变更 API

API	API 说明
subscribe	接收远端音视频流。该接口的 mediaType 参数增加 screenShare 枚举值，设置后，可以观看远端的屏幕共享画面。

[4.4.0] - 2021-07-14

NERTC Miniapp SDK 兼容微信和 QQ 小程序。

• NERTC Miniapp SDK 兼容 QQ 官方平台组件，可能在部分场景下的支持有所局限。
• QQ 小程序在网络切换时，可能会因网络重连引起通话质量问题，请尽量避免此类重连场景。

[4.2.1] - 2021-05-17

支持超长 UID，用户 ID 可设置为超出 Number 范围的长度。uid说明请参考 client.join。

[4.2.0] - 2021-04-21

网易云信于 2021 年 4 月 21 日发布了 NERTC SDK 最新版本 V4.2.0。

新增特性

序号	新增特性	特性描述	相关文档
1	支持设置用户角色	支持用户角色管理，角色包括主播（broadcaster）和观众（audience），默认以主播角色加入房间。	setRole

API 变更

新增 API

API	API 说明
setRole	设置用户角色。

变更 API

API	API 说明
on	增加 event 类型 role-Changed，表示用户角色已改变。

[4.1.0] - 2021-04-07

网易云信于 2021 年 4 月 7 日发布了 NERTC SDK 最新版本 V4.1.0。

新增特性

序号	新增特性	特性描述	相关文档
1	支持设置订阅和发布的媒体类型	发布本地音视频流或订阅远端音视频流时，可以指定媒体类型。例如音频流或音视频流	publish、subscribe
2	停止或继续接收远端音视频流	支持停止或继续接收远端音视频流。	mute、unmute

API 变更

新增 API

API	API 说明
mute	停止接收远端音视频流。
unmute	继续接收远端音视频流。

变更 API

API	API 说明
publish	增加参数 mediaType，指定媒体类型为纯音频或音视频。
subscribe	增加参数 mediaType，指定媒体类型为纯音频或音视频。

[V4.0.1] - 2021-02-04

修复

• 优化了安全模式下的登录流程，建议所有客户都升级到最新版本。

[V4.0.0] - 2021-01-27

NERTC Miniapp SDK for WeChat 正式发布。

功能

• 支持实时音视频通话及互动直播场景。
• 支持微信小程序 SDK 与 Native SDK、Web SDK 之间的双向互通。

限制

NERTC Miniapp SDK for Wechat 基于微信官方平台组件进行搭建，因此部分场景下的支持有所局限。微信小程序 SDK 的推流和拉流，主要依赖小程序平台的 live-pusher 和 live-player 组件，因此想要获取小程序实时媒体的收发情况，需用业务层主动去监听小程序的回调事件。详细说明请参考监听质量数据。