该版本于 2022 年 12 月 30 日发布。
该版本于 2022 年 9 月 21 日发布。
成功调用 enableAudioPropertiesReport 后,SDK 会持续监测音量最大的远端用户。当房间内用户数量大于或等于 2 且有活跃用户时,SDK 会触发回调 onActiveSpeaker 并周期性报告最活跃用户的信息。
封禁/解禁指定房间内的指定用户的音/视频流时,房间内所有用户都会收到 onAudioStreamBanned/onVideoStreamBanned的回调。
支持设置共享屏幕时的内容类型参数 contentHint,在不同场景下提升屏幕共享的视频质量。
USER_MESSAGE_EXCEED_MAX_LENGTH 和 USER_MESSAGE_EMPTY_USER,相应的错误实际是通过 INVALID_PARAMS 抛出,例如, SDKError('INVALID_PARAMS', 'The message length must be less than 64K')。该版本于 2022 年 8 月 31 日发布。
支持在调用 createEngine 时根据业务场景,设置自动播放策略。扩展 play 接口能力,当音视频流因自动播放策略设置或自动播放失败不播放时,都可以调用 play 接口开启播放。onAutoPlayFailed 回调增加了对本地媒体流自动播放失败情况的支持,不带 userId 参数时,表示本地媒体流自动播放失败。更多自动播放策略信息,详见 Web 端自动播放策略。
设置共享屏幕的视频编码参数,同时对视频采集生效。若设置的参数浏览器不支持,RTC SDK 按照浏览器支持的参数范围进行采集,并通过回调 onLocalVideoSizeChanged 通知实际参数。
该版本于 2022 年 7 月 29 日发布。
细化了转推直播相关事件、错误码和错误码信息。你能根据不同推流事件和错误码及时修改直播间的状态提示。可通过新增接口 onStreamMixingEvent 查看事件类型、错误码和错误码信息。
重新设计媒体流和音视频设备接口,实现了摄像头/麦克风采集的媒体流与屏幕共享媒体流的分离控制,同时支持灵活控制媒体流的发布/取消发布、订阅/取消订阅,具体接口变更参看升级指南。
该版本于 2022 年 7 月 18 日发布。
RoomProfileType 和音质选项设置接口 setAudioProfile,满足更多不同场景的音视频算法和参数以及网络参数配置需要。 RoomProfileType 既可以在客户端设置,也可以通过配置下发。在选定的音频场景 RoomProfileType 基础上,调用 setAudioProfile 切换音质档位。该版本于 2022 年 7 月 1 日发布。
| 接口 | 说明 |
|---|---|
| startAudioPlaybackDeviceTest | 开始播放测试 |
| stopAudioPlaybackDeviceTest | 停止播放测试 |
| startAudioDeviceRecordTest | 开启录播测试 |
| stopAudioDeviceRecordAndPlayTest | 停止录制,并开始播放测试语音 |
| stopAudioDevicePlayTest | 停止录播测试 |
支持在本地视频采集暂停时,使用指定的图片填充上行视频流。使用这一功能时,你可以在录制音视频通话时,避免某一用户画面黑帧的情况。参看 setDummyCaptureImagePath。
支持发布视频大小流,并为一路或多路流设置视频编码参数。参看 enableSimulcastMode 和 setVideoEncoderConfig 。
该版本于 2022 年 6 月 16 日发布。
| 接口 | 说明 |
|---|---|
| startPushPublicStream | 发布一路公共流 |
| updatePublicStreamParam | 更新公共流参数 |
| stopPushPublicStream | 停止发布公共流 |
| startPlayPublicStream | 订阅指定公共流 |
| stopPlayPublicStream | 取消订阅指定公共流 |
| setPublicStreamVideoPlayer | 为指定公共流设置使用的视图和渲染模式 |
| onPublicStreamStats | 用户订阅的公共流统计信息以及网络状况 |
| onPushPublicStreamResult | 公共流发布结果回调 |
| onPublicStreamSEIMessageReceived | 回调公共流中包含的 SEI 信息 |
| onFirstPublicStreamVideoFrameDecoded | 公共流的视频首帧解码成功 |
| onFirstPublicStreamAudioFrameDecoded | 公共流的音频首帧解码成功 |
| onFirstPublicStreamAudioFrameDecoded | 公共流的首帧视频渲染成功 |
支持 vp8 编码模式,你可以调用 getSupportedCodecs 查看当前浏览器是否支持 vp8 编码类型。
支持云代理功能。能够在有防火墙限制的情况下,通过云代理实现正常的音视频通话。参看 startCloudProxy。
该版本于 2022 年 6 月 1 日发布。
| 接口 | 说明 |
|---|---|
| login | 发送房间外消息和服务器消息前需要先登录 |
| logout | 登出 |
| updateLoginToken | 更新登录 Token |
查询对端用户或本端用户的登录状态 | |
| sendUserMessageOutsideRoom | 向指定用户发送房间外消息 |
| sendUserBinaryMessageOutsideRoom | 向指定用户发送房间外二进制消息 |
| setServerParams | 设置目标服务器地址和签名 |
| sendServerMessage | 向服务器发送实时消息 |
| sendServerBinaryMessage | 向服务器发送实时二进制消息 |
该版本于 2022 年 5 月 6 日发布。
该版本于 2022 年 4 月 1 日发布。
4.0 版本是基于 3.0 版本的全量重构版本,不向下兼容。