本文提供声网 Web SDK 3.x 及之前版本的发版说明。
声网 Web SDK 是通过 HTML 网页加载的 JavaScript 库。声网 Web SDK 库在网页浏览器中调用 API 建立连接,控制音视频通话和直播服务。
声网 Web SDK 对浏览器的支持情况详见声网 Web SDK 支持哪些浏览器?
Chrome 弃用和删除 Plan B 语义
Chrome 计划弃用和删除 WebRTC 中的 Plan B 语义,详见官方说明。该改动影响声网 Web SDK 版本使用和体验,具体如下:
Web SDK 版本 | 影响范围 |
---|---|
在调用 publish 方法后再调用 switchDevice 方法,出现视频卡顿或无声问题。 |
|
4.0.0-4.0.1 | publish 和 subscribe 方法不生效。 |
如你使用上述版本的 Web SDK,请尽快升级至最新版本。
其它已知限制
Stream.play
,Stream.startAudioMixing
以及 Stream.getAudioLevel
这三个方法必须由用户手势触发,详见处理浏览器的自动播放策略。更多问题,详见 Web 常见问题集。
该版本于 2022 年 6 月 21 日发布,修复了由于 Chrome WebRTC 行为变更,在 Chrome 103 版本上订阅音视频流失败的问题。
如果你使用 v3.6.10 及以下版本的 SDK,声网强烈推荐你升级到 v3.6.11 或以上版本。
该版本于 2022 年 3 月 28 日发布,改动如下:
该版本于 2022 年 1 月 6 日发布,修复了启用云代理服务后,特定场景下加入频道时浏览器控制台出现 CORS 报错的问题。
该版本于 2021 年 12 月 20 日发布,修复了一些已知问题。
该版本于 2021 年 11 月 24 日发布,修复了 Chrome 100 或以上版本中的一个已知问题。
该版本于 2021 年 11 月 10 日发布,有以下改动:
TypeError: null is not an object (evaluating 'e.track.kind')
报错的问题。该版本于 2021 年 9 月 13 日发布,修复了启用云代理服务后,特定场景下加入频道后出现 CORS 报错的问题。
该版本于 2021 年 9 月 1 日发布,修复了一些已知问题。
该版本于 2021 年 8 月 6 日发布,修复了 SDK 内部存在未销毁的 Media Player 的问题。由于 Chrome 92 新增了一个页面最多创建 75 个 Media Player 的限制,数次播放轨道后,SDK 内未销毁的 MediaPlayer 会导致当前页面无法继续播放。
该版本于 2021 年 7 月 15 日发布,修复了 Chrome 93 及之后版本弃用和删除 Plan B 语义导致的问题:调用 publish 后再调用 switchDevice 后会出现视频卡顿或无声。
该版本于 2021 年 7 月 1 日发布,修复了启用云代理服务后,连接云代理失败时不会主动重新请求的问题。
该版本于 2021 年 5 月 25 日发布。
媒体流加密
为了加强密钥的安全性,v3.6.0 新增 "aes-128-gcm2"
和 "aes-256-gcm2"
加密模式,使用 PBKDF2 (Password-Based Key Derivation Function 2) 函数来派生密钥。调用 setEncryptionMode
将加密模式设为 "aes-128-gcm2"
或 "aes-256-gcm2"
时,除了 secret
,你还需要设置盐值 salt
。secret
和 salt
的生成和设置方式详见媒体流加密。
v3.6.0 修复了用户被踢出频道后再使用同一个 uid 进入频道收到 uid conflict 报错的问题。
该版本于 2021 年 4 月 19 日发布,修复了指定访问区域为 CHINA
后无法访问声网服务器的问题。
该版本于 2021 年 4 月 14 日发布,修复了出现 None Ice Candidate not allowed
报错的问题。
该版本于 2021 年 4 月 12 日发布。
域名白名单变更
自 v3.5.0 起,SDK 的域名白名单变更为:
.agora.io
.edge.agora.io
.sd-rtn.com
.edge.sd-rtn.com
如果你将 SDK 升级至 v3.5.0,请务必更新防火墙的域名白名单。
AES-GCM 加密模式
在安全要求高的场景中,为保证数据的保密性、完整性和真实性,提高数据加密的计算效率,v3.5.0 在 EncryptionMode
中新增以下加密模式:
"aes-128-gcm"
: 128 位 AES 加密,GCM 模式。"aes-256-gcm"
: 256 位 AES 加密,GCM 模式。开启加密功能后,同一频道内的所有用户都必须使用相同的加密模式和密钥,包括服务端用户(例如声网录制服务)。
云代理服务
v3.5.0 在 client.on("stream-published")
事件中新增 proxy
字段,提示当前媒体流是否经云代理服务转发。
新增
EncryptionMode
新增 "aes-128-gcm"
和 "aes-256-gcm"
client.on("stream-published")
新增 proxy
字段该版本于 2021 年 1 月 26 日发布。
云代理服务
该版本优化了声网云代理架构,进一步加强了有网络访问限制的环境中 SDK 的连通性,同时支持限定访问区域。
你可联系 sales@agora.io 或技术支持申请使用优化后的云代理服务,然后调用 startProxyServer
方法将 type
参数设为 3 实现使用云代理服务。详见使用云代理服务。
该版本修复了 Safari 上 first-video-frame-decode
事件触发异常的问题。
该版本于 2020 年 12 月 11 日发布,修复了云代理服务连接报错的问题。
该版本于 2020 年 12 月 1 日发布。
调用 Client.setEncryptionMode
开启 SDK 内置加密功能后,当用户调用 Client.setEncryptionSecret
方法设置的密码为弱密码时,SDK 会在控制台打印警告信息,提醒用户设置强密码,即密码必须满足以下要求:
该版本修复了以下问题:
Client.on("stream-unpublished")
事件中调用 publish
会报错。switchDevice
切换麦克风后本地视图的显示模式由 contain
变为 cover
。Client.on("network-quality")
事件报告的上下行网络质量才变为 0。该版本于 2020 年 10 月 28 日发布,修复了以下问题:
setLiveTranscoding
后,如果在收到 Client.on("liveTranscodingUpdated")
事件前调用 startLiveStreaming
,旁路推流会失败。stopLiveStreaming
后 SDK 没有触发 Client.on("liveStreamingStopped")
事件。该版本于 2020 年 9 月 11 日发布,修复了部分用户升级 3.2.0 后编译打包报错的问题。
该版本于 2020 年 9 月 7 日发布。
视频传输优化策略
v3.2.0 在 StreamSpec
类中新增 optimizationMode
字段,支持在调用 createStream
方法创建 Stream 对象时选择以下视频传输优化策略,以确保遭遇网络波动时视频画面依然满足用户需求。
"motion"
: 流畅优先。大部分情况下,SDK 不会降低帧率,但是可能会降低发送分辨率。"detail"
: 清晰优先。大部分情况下,SDK 不会降低发送分辨率,但是可能会降低帧率。如果该字段留空,则使用 SDK 默认的优化策略:
createStream
时 screen
属性设为 true
),SDK 默认的优化策略为清晰优先。v3.2.0 全面支持基于 Chromium 内核的 Windows Edge 浏览器(80 及以上版本)。
该版本修复了以下问题:
setAudioProfile
)后,音频发送码率过高。Stream.init
失败。StreamSpec
类新增 optimizationMode
属性。
该版本于 2020 年 8 月 11 日发布。
设置区域访问限制
ClientConfig
新增 areaCode
属性,支持在创建客户端对象时指定服务器的访问区域。指定访问区域之后,SDK 只会连接到指定区域内的声网服务器。支持的区域如下:
该功能为高级设置,适用于有访问安全限制的场景。
加密
该版本在 setEncryptionMode
方法中新增对国密 SM4 加密模式的支持,你可以根据需要选择合适的加密模式。
该版本修复了 Client.on("stream-reconnect-end")
回调中 success
参数的值不准确的问题。
ClientConfig
新增 areaCode
属性。
该版本于 2020 年 6 月 1 日发布。
从该版本起,RTMP 推流支持使用云代理服务。
该版本修复了以下问题:
getLocalVideoStats
无法触发回调。该版本于 2020 年 4 月 30 日发布。
该版本优化了双流模式的实现。在双流模式下,SDK 行为有以下调整:
新增取消发布流成功回调
新增 Client.on("stream-unpublished")
回调,当本地用户取消发布流(Client.unpublish
)成功时,SDK 会触发该回调。
设置多个 TURN 服务器
该版本起,ClientConfig.turnServer
支持传入多个 TURN 服务器的配置。
设置播放器缓冲区延迟(H5 实时直播组件)
AgoraRTS.init
方法新增 bufferDelay
参数,支持设置播放器缓冲区延迟。该功能适用于网络不稳定或者对延迟不敏感的直播场景。
在网络环境较差时,你可以通过设置 bufferDelay
参数提高延迟,以保证直播的流畅度。详见 H5 实时直播。
该版本优化了 H5 实时直播组件的加载速度。
该版本修复了以下问题:
Stream.getStats
无法获取统计数据。Stream.switchDevice
出错。Client.join
时发生重连,加入频道成功后 SDK 没有返回用户 ID。Stream.play
的错误回调中,status
的值不准确。Client.on("mute-audio")
和 Client.on("mute-video")
回调重复触发。Client.on
新增事件 "stream-unpublished"
。
该版本于 2020 年 3 月 16 日发布,进行了一些内部改进。
该版本于 2020 年 2 月 12 日发布。
自采集视频支持双流模式
对使用 videoSource
属性创建的视频流,该版本支持开启双流模式 (enableDualStream
)。
改进自动重连机制,提升弱网下的用户体验。
该版本修复以下问题:
setClientRole
报错。leave
报错。videoSource
创建自采集视频流时报错。该版本于 2019 年 12 月 2 日发布。
声网在该版本对 SDK 的传输质量和互通体验进行了优化,在首帧出图时间和下行弱网对抗上有较大提升。
跨频道媒体流转发
跨频道媒体流转发,指将主播的媒体流转发至其他直播频道,实现主播与其他频道的主播实时互动的场景。该版本新增如下方法,通过将源频道中的媒体流转发至目标频道,实现跨直播间连麦功能:
startChannelMediaRelay
updateChannelMediaRelay
stopChannelMediaRelay
在跨频道媒体流转发过程中,SDK 会通过 Client.on("channel-media-relay-state")
和 Client.on("channel-media-relay-event")
回调报告媒体流转发的状态和事件。
该功能的实现方法详见跨直播间连麦。
屏幕共享分享背景音
在 StreamSpec
接口中新增 screenAudio
属性,支持屏幕共享的同时分享本地播放的背景音,详见分享音频。
美颜
新增方法 setBeautyEffectOptions
,支持美白、磨皮、红润肤色等美颜效果。详见美颜。
推流水印
LiveTranscoding
接口中新增 images
属性,支持将在线 PNG 图片作为水印添加到正在进行的推流直播中。
加密/解密失败通知
新增 Client.on("crypt-error")
回调,在发布或订阅流时出现加解密错误时可以收到通知。
远端视频状态
新增 Client.on("enable-local-video")
和 Client.on("disable-local-video")
回调,当远端 Native SDK 用户通过 enableLocalVideo
方法打开或关闭自己的视频采集时,Web 端可以收到通知。
离线原因
在 Client.on("peer-leave")
回调中增加 reason
参数,当远端用户掉线时可以通过该参数值了解具体原因。
该版本修复以下问题:
App ID 错误时,Client.join
没有错误回调。
某些场景下,SDK 和直播推流/拉流服务器连接断开后,没有自动重连。
在使用旁路推流 和输入在线媒体流功能时,SDK 会连接到专门用于推流/拉流的服务器,关于服务器连接断开的处理,请参考以下 FAQ:
偶现的 "Cannot read property 'getLastMsgTime' of null"
报错。
启用或禁用远端流的音视频轨道时控制台报错。
新增
Client.on
新增以下事件
"enable-local-video"
"disable-local-video"
"channel-media-relay-event"
"channel-media-relay-state"
"crypt-error"
修改
AgoraRTC.createStream
增加 screenAudio
属性。
该版本于 2019 年 9 月 5 日发布。
该版本优化了推流服务的性能和稳定性,对管理推流转码的接口 LiveTranscoding
的参数设置进行了如下限制:
videoFramerate
:设置转码推流的帧率,单位为 fps。如果设置的帧率超过 30,声网服务端会自动调整为 30。videoBitrate
:设置转码推流的码率,单位为 Kbps。你可以根据视频分辨率表格中的码率值进行设置。如果设置的码率超出合理范围,声网服务端会在合理区间内对码率值进行自适应。videoCodecProfile
:设置转码推流的视频编码规格,可以设置为 66、77 或 100。如果设置其他值,声网会统一设为默认值 100。width
和 height
:设置转码推流的视频分辨率。width x height 的最小值不低于 16 x 16。支持 NAT64 网络
该版本新增对 NAT64 的支持,在 NAT64 的网络环境下可以正常使用声网 Web SDK。
选择前置/后置摄像头
createStream
方法新增 facingMode
参数,支持在移动端创建本地流时选择使用前置或后置摄像头采集视频。
取消事件绑定
新增 Client.off
方法,支持移除通过 Client.on()
绑定的事件。
大规模减少了端口的使用,防火墙内的用户不再需要打开 10000-65535 的 UDP 端口,详见 Web SDK 防火墙端口。
减少加入频道的时间以及首帧出图时间。
网络传输控制优化,提升下行网络拥塞情况下的音视频体验。
进一步完善 NAT 类型支持的兼容性,提升了媒体流连接能力。
明确了部分 API 的失败回调中的错误码。
每次发布流成功时强制同步 mute 的状态。
仅在加入频道后才会触发 volume-indicator
回调。
优化 SDK 参数检查。
Client.subscribe
中的 options
参数)会被重置的问题。Stream.init
执行过程中调用 Stream.close
导致的异常问题。Stream.startAudioMixing
中 cacheResource
设为 false
不生效的问题。Client.off
方法AgoraRTC.createStream
方法新增 facingMode
参数该版本于 2019 年 7 月 8 日发布。
2.8.0 版本主要优化了对 String 类型的用户 ID的支持。
一个频道内的所有用户必须使用同样类型的用户 ID,即必须都为整数或都为字符串。使用字符串类型的用户 ID与声网 Native SDK 互通时,请确保 Native SDK 也使用字符串类型的用户 ID,即 User Account 加入频道,详见使用 String 型的用户 ID。
该版本于 2019 年 7 月 3 日发布。
修复了调用 Stream.setScreenProfile
方法设置屏幕共享的视频属性不生效的问题。
该版本于 2019 年 6 月 21 日发布。新增功能、改进及修复问题详见下文。
新增 Stream.setVideoEncoderConfiguration
方法,与原有的 Stream.setVideoProfile
方法相比,该方法可以自定义视频分辨率、帧率及码率,更加灵活。更多信息请参考设置视频属性。
为方便开发者管理音视频流播放状态,该版本新增以下功能:
Stream.play
方法中新增 callback
参数,用于通知音视频流的播放结果。如果播放失败,该参数会返回具体的失败原因。Stream.on
中新增 "player-status-change"
回调,当音视频流的播放状态发生变化时可以通过该回调了解具体的播放状态以及状态变化的原因。Stream.resume
方法,用于在播放失败时恢复播放。Client.on
中新增 "first-audio-frame-decode"
和 "first-video-frame-decode"
事件,在订阅远端流成功后完成第一帧远端音频和视频解码时通知 App。
Stream.on
中新增 "audioTrackEnded"
和 "videoTrackEnded"
回调,当音视频轨道停止时(如设备拔出、取消授权、计算机休眠)会通知 app,方便监控设备状态。
该版本支持在 Edge 浏览器上实现音视频基本互通,具体支持的功能请参考 Edge 浏览器支持。
该版本支持动态修改视频编码配置,即 Stream.init
之前或之后都可以调用 setVideoProfile
或 setVideoEncoderConfiguration
设置视频编码配置。
请勿在发布流时修改视频编码配置。
Stream.getStats
获取的部分数据异常的问题。Client.leave
不生效的问题。Stream.getAudioMixingPosition
获取的结果不准确的问题。Stream.unmuteVideo
导致音频无法播放的问题。API 整理
本次发版 API 变动如下。
Stream.setVideoEncoderConfiguration
Stream.resume
Client.on
新增以下事件:"first-audio-frame-decode"
"first-video-frame-decode"
Stream.on
新增以下事件:"audioTrackEnded"
"videoTrackEnded"
"player-status-change"
修改
Stream.play
新增 callback
参数。
该版本于 2019 年 4 月 11 日发布。改进及修复问题详见下文。
创建流(AgoraRTC.createStream
)时支持 cameraId
和 microphoneId
使用空字符串。
Client.publish
)之前调用 enableDualStream
方法报错的问题。getStats
返回的部分数据缺失的问题。该版本于 2019 年 4 月 3 日发布。新增功能及修复问题详见下文。
1. 音效文件播放和管理
新增一组方法支持在人声中同时播放效果音,支持同时播放多个音效文件,且支持对音效文件的管理,包括调节音量、暂停/停止播放、预加载音效文件等功能,详见播放音效/音乐混音。
2. Chrome 浏览器无插件屏幕共享
Chrome 72 及以上版本无需插件即可使用屏幕共享功能,详见进行屏幕共享。
3. 其他新增功能
Stream.startAudioMixing
中新增 cacheResource
参数用于设置是否缓存混音文件AgoraRTC.getSupportedCodec
方法,可检查浏览器支持的编解码格式。Client.on
新增 stream-updated
回调,当远端用户的音视频流进行 addTrack
或 removeTrack
操作时会触发该回调。startAudioMixing
)支持使用包含中文字符的 URL 作为音乐文件的地址该版本优化了弱网下的音视频流回退体验,同时在 Client.on
中新增 stream-fallback
回调,在开启音视频流回退(setStreamFallbackOption
)的情况下,当订阅的流从音视频流回退为音频流或者从音频流恢复为音视频流时可以收到回调通知。
switchDevice
无法切换麦克风的问题addTrack
后 mute 操作不生效的问题switchDevice
然后再次开始混音,远端听不到混音音乐的问题active-speaker
回调的问题muteAudio
或 muteVideo
可能不生效的问题replaceTrack
切换视频轨道后调用 startAudioMixing
远端无法听到混音音乐的问题本次发版 API 变动如下。
新增
AgoraRTC.getSupportedCodec
Stream.playEffect
Stream.stopEffect
Stream.pauseEffect
Stream.resumeEffect
Stream.setVolumeOfEffect
Stream.preloadEffect
Stream.unloadEffect
Stream.getEffectsVolume
Stream.setEffectsVolume
Stream.stopAllEffects
Stream.pauseAllEffects
Stream.resumeAllEffects
Client.on
新增以下事件:stream-fallback
stream-updated
修改
Stream.startAudioMixing
增加 cacheResource
参数该版本于 2019 年 2 月 28 日发布。修复问题见下文。
Stream.switchDevice
无法切换音频的问题。Client.subscribe
的可选参数会报错的问题。该版本于 2019 年 2 月 11 日发布。新增功能、改进及修复问题详见下文。
1. 质量透明
支持获取更多通话质量的统计数据:
Client.getSessionStats
方法,获取当前通话相关的统计数据,包括在频道内的时长,音视频总发送/接收码率,频道内的人数等。network-quality
回调,每 2 秒报告一次本地用户的上下行网络质量。Client.getRemoteAudioStats
获取的远端音频统计数据中新增以下数据:Client.getRemoteVideoStats
获取的远端视频统计数据中新增以下数据:Client.getLocalVideoStats
获取的本地视频统计数据中新增以下数据:Client.getTransportStats
获取的与网关的连接统计数据中新增以下数据:2. 独立订阅音频流/视频流
在 Client.subscribe
方法中新增 options
参数,用于设置是否接收音频数据和视频数据。
该方法可以根据需要在通话中多次调用,在订阅音频和/或视频之间灵活切换。
3. 设置用户角色
新增 Client.setClientRole
方法,支持在直播场景下设置用户的角色为主播或者观众。主播可以发布和接收音视频流,观众只能接收音视频流,无法发布。
相应新增 client-role-changed
回调,用于通知用户角色的改变。
4. 获取 SDK 与服务器的连接状态
Client.getConnectionState
方法,用于获取 SDK 与服务器的连接状态。connection-state-change
回调,用于通知连接状态的变化。5. 云代理服务
支持使用云代理服务,方便部署企业防火墙的用户正常使用声网的服务,详见使用云代理服务。
6. 其他新增功能
Stream.isPlaying
方法,用于检测音视频流当前是否在播放状态。Client.on
中新增以下回调:peer-online
:通知应用程序有其他用户/主播上线。stream-reconnect-start
:通知应用程序 SDk 开始重新发布/订阅音视频流。stream-reconnect-end
:通知应用程序重新发布/订阅音视频流已结束。exception
:通知应用程序频道内的异常事件。Stream.on
中新增以下回调:audioMixingPlayed
:通知应用程序混音开始播放。audioMixingFinished
:通知应用程序混音结束播放。Stream.play
方法中新增 muted
参数,用于规避浏览器自动播放策略。Stream.setAudioMixingPosition
方法中新增 callback
参数,可用于返回方法调用失败的错误信息。Client.on
回调事件的名称,以保持风格统一。getStats
方法返回的对端视频分辨率为 0 的问题。disableAudio
方法后开启混音功能,再调用 enableAudio
方法,无法听到麦克风声音的问题。switchDevice
方法切换音频设备后,调用 getAudioLevel
方法获取的音量为 0 的问题。replaceTrack
方法后,在本地听到自己声音的问题。switchDevice
方法无法二次切换的问题。本次发版 API 变动如下。
新增
AgoraRTC.getScreenSources
Client.removeInjectStreamUrl
Client.getSessionStats
Client.setClientRole
Client.getConnectionState
Client.startProxyServer
Client.stopProxyServer
Stream.isPlaying
Stream.muteAudio
Stream.unmuteAudio
Stream.muteVideo
Stream.unmuteVideo
Client.on
新增以下事件:client-role-changed
peer-online
network-quality
connection-state-change
stream-reconnect-start
stream-reconnect-end
exception
Stream.on
新增以下事件:audioMixingPlayed
audioMixingFinished
修改
Client.subscribe
方法增加 options
参数Stream.setAudioMixingPosition
方法增加 callback
参数Stream.play
方法增加 muted
参数Client.on
以下事件名称修改:原事件名 | 现事件名 |
---|---|
networkTypeChanged | network-type-changed |
recordingDeviceChanged | recording-device-changed |
playoutDeviceChanged | playout-device-changed |
cameraChanged | camera-changed |
streamTypeChange | stream-type-changed |
废弃
Client.getNetworkStats
Stream.enableAudio
Stream.disableAudio
Stream.enableVideo
Stream.disableVideo
该版本于 2018 年 10 月 30 日发布。新增功能与修复问题列表详见下文。
如果设置了域名防火墙,使用此版本时需将
*.agoraio.cn
和*.agora.io
添加到白名单。
为更好地与声网其他 SDK 互通,实现更多功能,Web SDK 在本版本中新增了如下功能。详细的方法说明,请参考声网 Web SDK API Reference。
1. 质量监控
为方便用户查看应用程序的通话质量,新增如下方法:
Client.getNetworkStats
:获取网络统计数据(网络类型)。Client.getSystemStats
:获取系统数据(系统电量)。Client.getRemoteAudioStats
:获取远端音频统计数据。Client.getLocalAudioStats
:获取本地音频统计数据。Client.getRemoteVideoStats
:获取远端视频统计数据。Client.getLocalVideoStats
:获取本地视频统计数据。Client.getTransportStats
:获取网络连接统计数据。2. 媒体设备管理
提供灵活的设备管理功能,以及设备状态查询。
枚举可用设备
新增如下方法:
Client.getRecordingDevices
:枚举音频输入设备,如麦克风。Client.getPlayoutDevices
:枚举音频输出设备,如扬声器。Client.getCameras
:枚举视频输入设备,如摄像头。同时新增如下事件,用来告知应用程序设备状态的变化:
recordingDeviceChanged
:通知应用程序音频输入设备已改变。playoutDeviceChanged
:通知应用程序音频输出设备已改变。cameraChanged
:通知应用程序视频输入设备已改变。切换媒体设备
Stream.switchDevice
方法,支持在频道内切换媒体输入设备,如麦克风、摄像头等。Stream.setAudioOutput
方法,支持选择音频输出设备,可以切换麦克风和扬声器。3. 支持伴奏混音
支持混音功能,混音是指原音(麦克风采集的音频)和伴奏(音频文件声音)混合。
新增如下伴奏混音相关的方法:
Stream.startAudioMixing
:开始播放伴奏。Stream.stopAudioMixing
:停止播放伴奏。Stream.pauseAudioMixing
:暂停播放伴奏。Stream.resumeAudioMixing
:恢复播放伴奏。Stream.adjustAudioMixingVolume
:调节伴奏音量。Stream.getAudioMixingDuration
:获取伴奏时长。Stream.getAudioMixingCurrentPosition
:获取伴奏播放进度。Stream.setAudioMixingPosition
:设置伴奏音频文件的播放位置。4. 音视频轨道管理
支持灵活管理音视频频道,新增如下方法:
Stream.getAudioTrack
:获取音频轨道。Stream.getVideoTrack
:获取视频轨道。Stream.replaceTrack
:替换音视频轨道。Stream.addTrack
:添加音视频轨道。Stream.removeTrack
:移除音视频轨道。5. 其他新增功能
Stream.play
方法中设置播放流的显示模式。Client.enableAudioVolumeIndicator
方法,允许 SDK 定期向应用程序反馈当前谁在说话,以及说话者的音量。Stream.setAudioVolume
方法,支持设置订阅流的音量。networkTypeChanged
事件,通知应用程序网络类型已改变。streamTypeChange
事件,通知应用程序视频流类型已由大流变为小流,或小流变为大流。Client.join
方法中,在原来支持整型 uid
的基础上,新增对字符串类型的支持。Stream.close
关闭流,对端 10 秒后无法收到 stream-removed
回调的问题。Stream.userId
后,收到 Warning 的问题。该版本于 2018 年 9 月 19 日发布。修复问题列表详见下文。
stream-removed
事件的问题。该版本于 2018 年 8 月 24 日发布。新增特性与修复问题列表详见下文。
本次发版新增如下功能:
1. 支持 Token
详见 密钥说明。
2. 支持音频信号处理
在 audioProcessing
参数中新增声学回声消除属性(AEC)和自动噪声抑制属性(ANS)。
3. 支持音视频前处理
在 client.createStream
方法中增加了 audioSource
和 videoSource
属性,可以指定创建的音视频流要使用的音视频 Track,因此在创建音视频流之前可以对音视频进行处理。
4. 支持设置音频属性
新增 stream.setAudioProfile
方法,提供多组音频属性设置(采样率、单双声道、编码码率)。
5. 支持弱网时音视频流回退
在网络环境不理想的情况下,为保证通话体验,新增 client.setStreamFallbackOption
接口支持在接收端选择订阅视频小流或者只订阅音频流。
6. 新增通话相关延迟数据
在 stream.getStats
的回调信息中新增通话中的延迟数据,包括从发送端到 SD-RTN 的延迟、SD-RTN 到接收端的延迟、发送端到接收端的延迟,以及接收端播放音视频的延迟。
7. 支持日志上传
新增 AgoraRTC.Logger.enableLogUpload
接口,支持将 SDK 的日志信息上传到声网的服务器,方便调查问题。
stream.setVideoProfile
接口, cameraId
和 microphoneId
设置就不生效的问题。setScreenProfile
设置不生效的问题。client.createStream
方法中同时开启 audio
和 screen
会出错的问题。microphoneId
不生效的问题。audioProcessing
设置不生效的问题。stream.stop
后才可以再次调用 stream.play
。该版本于 2018 年 6 月 7 日发布。新增特性与修复问题列表详见下文。
该版本于 2018 年 6 月 4 日发布。新增特性与修复问题列表详见下文。
本次发版新增如下功能:
1. 新通信场景
为增加 Web SDK 的适用场景,提升与 Native SDK 在通信和直播下的互通质量,在 createClient
方法中新增 mode
和 codec
参数,其中 mode
参数支持 rtc 和 live 两种场景,codec
参数支持 vp8 和 264 两种编解码方式。
2. 支持语音自动增益控制
为满足通话或直播中对语音响度进行控制和调整的需要,在 createStream
方法中新增 audioProcessing
参数。
3. 网页端 Proxy 功能
为解决设有防火墙的企业用户无法直接使用声网服务的问题,新增 2 个接口,通过代理服务器将用户的内网请求转到声网 SD-RTN 上,从而实现内网访问。使用该功能,用户需要自行部署 Nginx 和 TURN 服务器, 并在加入频道之前就调用相关接口。
4. 加密功能
为提高通话或直播安全性,新增加密功能。用户只要在加入频道之前调用接口设置加密密码及加密方案即可。
已修复:出现 p2plost 后重连一次或几次后不再重连。
该版本于 2018 年 4 月 16 日发布。新增特性与修复问题列表详见下文。
本次发版新增如下功能:
1. 获取版本信息
支持获取当前使用的 SDK 版本信息。
2. 设置小流参数
新增设置小流参数接口,允许对小流参数进行配置。
3. Firefox 浏览器屏幕共享
新增 Firefox 浏览器屏幕共享功能,通过在createStream
方法中增加mediaSource
参数实现。详见 Firefox 屏幕共享。
4. QQ 浏览器支持
新增 Android 设备对 QQ 浏览器的支持。
解决了 iOS 端使用 Safari 浏览器时,audio-only 模式下没有声音的问题。
该版本于 2018 年 3 月 19 日发布。
修复了 macOS 上 Firefox v59.01 浏览器使用 Web SDK 只能看到本地视频看不到对方视频的问题。
该版本于 2018 年 3 月 7 日发布。新增特性与修复问题列表详见下文。
本次发版新增如下功能:
功能 | 描述 |
质量检测 | 用户在使用 Web SDK 进行远程通信或直播前,提供回调对当前的浏览器的兼容情况、麦克风及摄像头的使用情况、网络状况进行测试,以保证通话质量; |
视频大小流 | 新增方便发送端控制发送大流或小流,以及接收端控制请求大流或小流,并允许对小流进行参数配置; |
客户端踢人 | 提供回调通知被踢客户其已被禁止加入频道 |
RTMP 推流(直播) | 新增接口支持 RTMP 推流 |
设置日志输出等级 | 新增接口对日志的输出等级进行设置 |
静音/取消静音 | 新增接口在通话或直播过程中静音或取消静音 |
本次发版改进如下功能:
功能 | 描述 |
P2P 连接建立时间优化 | 从 1.8 秒缩短到 500 毫秒 |
优化丢包对抗 | 优化 FEC 对抗 20% 丢包和 ULP FEC 扛丢包 |
该版本于 2017 年 12 月 6 日发布。新增特性与修复问题列表详见下文。
createClient
之前新增了 checkSystemRequirements
,以检查系统对浏览器是否支持。该版本于 2017 年 10 月 20 日发布。
新增了屏幕共享功能,在 createStream
里修改了参数 screen
, 并新增了参数 extensionId
。
该版本于 2017 年 9 月 4 日发布。新增特性与修复问题列表详见下文。
API configPublisher
描述该版本于 2017 年 7 月 25 日发布。。新增特性与修复问题列表详见下文。
新增和更新了以下 API:
API | 描述 |
createClient |
[新增] 创建纯 Web 端或 Web 互通版客户端对象,取决于你设置了哪种模式 |
renewChannelKey |
[新增] 之前 Channel Key 过期后,需调用该方法更新 Channel Key |
active-speaker |
[新增] 提示当前频道内谁正在说话 |
setRemoteVideoStreamType |
[新增] 当发送端发送了双流(视频大流和小流)时,本地用户调用该方法可以选择接收双流中的一路流 |
setVideoProfile |
[更新] 设置视频属性,默认值为 480p_1 |
init |
[更新] 初始化客户端对象 |
join |
[更新] 允许用户加入声网频道 |
更新了错误码和解释。