声网 Agora Web SDK 2.5 版升级公告（二）

2.支持 IPv6

支持 IPv6 网络环境接入，并正常使用 Agora 服务。本地网关必须同时支持 IPv4 协议栈。

3.媒体设备管理

可提供灵活的设备管理功能，以及设备状态查询。

• 枚举可用的音频输入输出设备和视频输入设备

• 新增如下接口：

• Client.getRecordingDevices：枚举音频输入设备，如麦克风。

• Client.getPlayoutDevices ：枚举音频输出设备，如扬声器。

• Client.getCameras ：枚举视频输入设备，如摄像头。

• 同时新增如下事件，用来告知应用程序设备状态的变化：

• recordingDeviceChanged ：通知应用程序音频输入设备已改变。

• playoutDeviceChanged ：通知应用程序音频输出设备已改变。

• cameraChanged ：通知应用程序视频输入设备已改变。

• 切换媒体设备

• 新增 Stream.switchDevice 接口，支持在频道内切换媒体输入设备，如麦克风、摄像头等。

• 新增 Stream.setAudioOutput 接口，支持选择音频输出设备，可以切换麦克风和扬声器。

4.支持伴奏混音

支持混音功能，混音是指原音（麦克风采集的音频）和伴奏（音频文件声音）混合。新增如下伴奏混音相关的接口：

• Stream.startAudioMixing ：开始播放伴奏。

• Stream.stopAudioMixing ：停止播放伴奏。

• Stream.pauseAudioMixing ：暂停播放伴奏。

• Stream.resumeAudioMixing ：恢复播放伴奏。

• Stream.adjustAudioMixingVolume ：调节伴奏音量。

• Stream.getAudioMixingDuration ：获取伴奏时长。

• Stream.getAudioMixingCurrentPosition ：获取伴奏播放进度。

• Stream.setAudioMixingPosition ：设置伴奏音频文件的播放位置。

5.音视频轨道管理

支持灵活管理音视频频道，新增如下接口：

• Stream.getAudioTrack ：获取音频轨道。

• Stream.getVideoTrack ：获取视频轨道。

• Stream.replaceTrack ：替换音视频轨道。

• Stream.addTrack ：添加音视频轨道。

• Stream.removeTrack ：移除音视频轨道。

6.其他新增功能

• 支持两种视频显示模式，可以在 Stream.play 接口中设置播放流的显示模式。

• 新增 Stream.setScreenBitrate 接口，支持手动设置屏幕共享时的视频码率。

• 新增 Client.enableAudioVolumeIndicator 接口，允许 SDK 定期向应用程序反馈当前谁在说话，以及说话者的音量。

• 新增 Stream.setAudioVolume 接口，支持设置订阅流的音量。

• 新增 networkTypeChanged 事件，通知应用程序网络类型已改变。

• 新增 streamTypeChange 事件，通知应用程序视频流类型已由大流变为小流，或小流变为大流。

• Client.join 接口中，在原来支持整型 uid 的基础上，新增对字符串类型的支持。

• 支持 360 安全浏览器 9.1.0.432 及以上版本。

• 支持 Windows XP 平台的 Chrome 49 浏览器。

问题修复

• 修复了手机端使用 Safari 或 Chrome 浏览器进入频道后，在仅有音频通话的情况下对 video codec 的依赖。

• 修复了使用 Safari 浏览器推流后调用 Stream.close 关闭流，对端 10 秒后无法收到 stream-removed 回调的问题。

• 修复了重置 Stream.userId 后，收到 Warning 的问题。

本文转载自公众号声网 Agora（ID：shengwang-agora）。

原文链接：

https://mp.weixin.qq.com/s/kJSrHQFAygqnMbXlE_sa-g