实时音视频
  • 平台类型
  • 框架 / 引擎
  • iOS
  • Android
  • macOS
  • Windows
  • Linux
  • Web
  • 小程序
Express-Video SDK
本地下载
2021-04-29Version:2.6.0

新增功能

1. 新增低延迟直播功能

低延迟直播专注于提供稳定可靠的直播服务,相比于标准视频直播产品,音画延迟更低,同步性更强,弱网抗性更好,能为用户带来毫秒级的直播体验。通常用于教育大班课、秀场直播、电商直播、一起看、在线拍卖等场景。

当开发者需要拉取低延迟直播流时,可通过设置拉流参数 “resourceMode” 为 “2”,选择拉取低延迟直播流,详情请参考 低延迟直播

相关 API 请参考 startPlayingStream

2. 新增 token 过期回调 tokenWillExpire 和 token 更新接口 renewToken

SDK 当前版本已支持该回调和接口,预计 2021-05-13 才可正式使用。

当 token 快要过期前的 30s SDK 会主动触发 tokenWillExpire 回调,开发者需要在收到该回调时,重新生成 token 并调用 renewToken 接口更新。

renewToken 接口常用于如下场景:

a. 当 token 过期时,通过该接口来更新 token。

b. 当开发者需要从登录权限切换到推流(含登录)权限,或者从推流(含登录)权限切换到只有登录权限时,可以通过该接口来实现。

相关 API 请参考 tokenWillExpirerenewToken

3. token 版本升级,支持 token 分功能鉴权

SDK 当前版本已支持该鉴权功能,但预计 2021-05-13 才可正式使用。

通过新版本 token 控制是否可登录,是否能推流,若想使用新版本 token 鉴权功能,请先联系 ZEGO 技术支持开启对应配置。

相关 API 请参考 tokenWillExpirerenewToken

优化改进

1. 优化了推拉流协商模式,减少推拉流首帧耗时

推拉流首帧耗时能在原有基础上缩短 150 ms 以上。

2. 优化了推拉流网络质量算法

进一步优化了推拉流网络质量的算法,提高推拉流质量回调中对 [videoQuality] 与 [audioQuality] 监听的准确性。

3. 增加节点质量探测

若检测到当前网络质量差则触发节点探测,SDK 会寻找质量更佳的推拉流节点进行切换,进一步提高抗弱网能力。

问题修复

1. 修复已知问题

2021-04-15Version:2.5.0

问题修复

1. 修复了切换摄像头时,原来的摄像头未被释放的问题

相关 API 请参考 useVideoDevice

2. 修复其他已知问题

2021-04-01Version:2.4.0

改进优化

1. 优化检测接口,提高视频编码检测准确率,并支持单项检测

相关 API 请参考 checkSystemRequirements

2. 修改了设置日志时上传地址的优先级,使其优先级高于后台下发的地址

相关 API 请参考 setLogConfig

3. 优化了视频码率设置策略,解决了屏幕共享码率初始值较低的问题

相关 API 请参考 createStream

问题修复

1. 修复了 Safari 使用部分蓝牙耳机播放音效时出现音质怪异的问题

2021-03-18Version:2.3.0

改进优化

1. 优化了推拉流网络质量评级逻辑,提高评估准确率

2. 支持纯视频流混音功能

相关 API 请参考 startMixingAudio

问题修复

1. 修复了拉流后马上停止拉流时,出现报错的问题

2. 修复了关闭摄像头后再开启时,推流卡顿的问题

2021-03-04Version:2.2.1

新增功能

1.新增采集音量修改功能

调用麦克风采集音量接口,可以调节推流端的音量,让观众感受到音量变化。

相关 API 请参考 setCaptureVolume

2.用户被踢出房间时,新增详细的踢出原因

房间成员被踢下线时,SDK 需要根据附加信息提示具体被踢下线的原因。

问题修复

1. 修复了重复登录房间时无法感知房间重置,导致收不到流更新的问题

2021-01-28Version:2.1.0

问题修复

1. 修复了 Windows 设备在 Chrome 浏览器开启硬件加速时,视频码率无法达到预期值的问题

2. 修复了 PC 上的微信内置浏览器拉流一段时间后报错的问题

2021-01-14Version:2.0.0

改进优化

1. 代码重构,减少不同模块之间耦合性

2. 日志系统重构,优化了日志结构,提高问题定位效率

3. 重试逻辑重构,进一步提高 SDK 抗弱网能力

2020-12-31Version:1.19.0

新增功能

1. 新增动态设置是否拉取远端音频流和视频流的功能

开发者可以在拉流成功后,根据需要动态调整是否拉取音频流或视频流。

相关 API 请参考 mutePlayStreamVideo mutePlayStreamAudio

问题修复

1. 修复了第三方流的音视频文件播放完成后,销毁流失败的问题

相关 API 请参考 destroyStream

2020-12-17Version:1.18.0

新增功能

1. 流更新回调新增扩展信息参数,例如:当流被删除时能够抛出相关原因信息

相关 API 请参考 roomStreamUpdate

2. 新增调节混音音量功能

支持动态调节推流时混入的背景音乐或音效的音量大小。

相关 API 请参考 setMixingAudioVolume

改进优化

1. 优化了 SDK 流媒体 websocket 连接等待时间

延长了推拉流重试过程中,websocket 连接超时的等待时间,提升连接成功率及抗弱网能力。

问题修复

1. 修复了推流为纯音频的场景下,Safari 浏览器选择自动拉取模式时拉到的音频没有声音的问题

相关 API 请参考 setMixingAudioVolume

2020-12-03Version:1.17.1

问题修复

1. 修复了静音后混音时,再次打开麦克风不能恢复麦克风声音的问题

相关 API 请参考 mutePublishStreamAudio

2. 修复了推流重试过程中调用停止推流接口时,对端未能及时收到流删除通知的问题

相关 API 请参考 stopPublishingStream , roomStreamUpdate

3. 修复了退出房间后快速重登房间时,对端可能收不到房间用户进出回调的问题

相关 API 请参考 loginRoom , roomUserUpdate

2020-11-26Version:1.16.5

问题修复

1. 修复了网络重连成功后存在部分推拉流无法恢复正常使用的问题

2. 修复了拉流端短时间内收到摄像头状态变更时可能状态不同步的问题

2020-11-23Version:1.16.1

问题修复

1. 修复了弱网环境下推拉流可能调度失败的问题

2020-11-19Version:1.16.0

新增功能

1. 第三方流支持设置推流的音频声道数和码率

创建第三方流时根据视频文件中的音频声道数和码率设置当前推流音频的声道数和码率,避免可能出现的音质损耗问题。

相关 API 请参考 createStream

2. 新增支持动态修改推流音频参数

创建流并推流成功后,可以根据需要修改推流音频参数,包括降噪、自动增益和回声消除。

相关 API 请参考 setAudioConfig

3. 新增设备插拔回调

当监测到系统中有音视频设备添加或移除时,会触发 audioDeviceStateChanged videoDeviceStateChanged 回调。通过监听此回调,用户可以根据需要使用特定音视频设备进行数据采集。

相关 API 请参考 audioDeviceStateChanged , videoDeviceStateChanged

改进优化

1. 优化弱网情况下停止推流后,拉流端收不到流删除回调的问题

发送流新增及删除失败时进行重试,增加弱网等情况下的推流成功率。

2. 优化推流端关闭摄像头后重新打开时,拉流端可能拉不到视频画面的问题

问题修复

1. 修复了在火狐浏览器上推流成功后刷新页面,再次输入相同房间号推流时拉不到流的问题

2020-11-05Version:1.15.0

改进优化

1. 优化 safari 浏览器使用混音功能时,麦克风采集声音质量差的问题

相关 API 请参考 startMixingAudio

2. 优化日志连接断开时报错信息

退出房间一分钟左右后日志 websocket 连接断开,不再显示 error 级别报错信息。

3. 优化 SDK 上报设备状态的日志,增加相应流 ID

问题修复

1. 修复 sendCustomCommand 回调结果,删除了返回值中的 messageID

2. 修复同一用户在其他平台登录导致从 web 平台下线时不触发 roomStateUpdate 的问题

3. 修复相同用户 ID 登录房间时,房间内其他用户收到 roomUserUpdate 回调的问题

2020-10-15Version:1.14.0

新增功能

1. 推拉流质量回调中增加音频发送帧率

推拉流质量回调中增加音频发送帧率(audioFPS),用于展示当前音频流畅度。

相关 API 请参考 publishQualityUpdate , playQualityUpdate

2. 增加屏幕分享流的推流分辨率设置

创建屏幕共享流时若传入的 videoQuality 参数取值为 4,则开发者需要将帧率、码率和分辨率传给 SDK。

相关 API 请参考 createStream

3. 增加推流参数动态修改功能

支持在创建流并推流成功后通过 setVideoConfig 接口动态修改音视频流的分辨率(宽和高)、帧率和码率。

相关 API 请参考 setVideoConfig

改进优化

1. 重试逻辑优化及重构

优化及重构了音视频通话过程中出现异常时的重试逻辑,提高 SDK 抗弱网能力,减少业务侧重试。

2. 转推 CDN 时无需鉴权

优化增加转推 CDN 和删除转推 CDN 接口,去除鉴权,提高易用性。

相关 API 请参考 addPublishCdnUrl , removePublishCdnUrl

问题修复

  1. 修复错误码信息重复问题

  2. 修复其它已知问题

2020-09-24Version:1.13.0

新增功能

1. 新增替换音视频轨道

支持替换本地音视频流中的音视频轨道,例如可以在摄像头、屏幕共享或视频之间切换视频轨道,在麦克风和 mp3 之间切换音频轨道。

相关 API 请参考 replaceTrack

2. 新增可用性检测错误信息返回

当 SDK 检测到设备不可用时,支持返回对应的错误提示信息,展现具体的错误原因。

相关 API 请参考 checkSystemRequirements

改进优化

1. 优化推流状态回调错误码

优化了推流时因网络问题导致请求响应超时的时候返回的错误码值。

2. 增加接口数值参数的类型判断

对接口中是数值类型的参数作严格判断,只允许传入整数,避免出现错误。

相关 API 请参考 loginRoom , createStream , setSoundLevelDelegate , startMixerTask

问题修复

  1. 修复登录房间后更改日志配置导致日志事件上报缺失 roomid 的问题

  2. 修复其它已知问题

2020-09-10Version:1.12.0

新增功能

1. 新增房间附加消息功能

该功能可以设置一个以房间为单位的附加消息,该消息跟随整个房间的生命周期,每个登录到房间的用户都能够同步消息。开发者可用于实现各种业务逻辑,如房间公告等等。目前房间附加消息只允许设置一个键值对,且 key 最大长度为 10 字节,value 最大长度为 100 字节。

相关 API 请参考 setRoomExtraInfo

改进优化

1. 优化退出房间参数

简化了退出房间的参数设置,将 roomID 修改为可选参数,开发者退出房间时可以不设置 roomID。

相关 API 请参考 logoutRoom

2. 增加切换设备的时机

创建流并预览后,支持在推流前切换摄像头和麦克风设备。

相关 API 请参考 useVideoDevice , useAudioDevice

3. 增加创建流属性参数的类型判断

增加了创建流时设置的分辨率、码率、帧率等参数的类型判断,只允许传入正整数,避免出现不明报错信息。

相关 API 请参考 createStream

4. 优化回调注册事件处理

开发者在回调事件中若出现业务逻辑的错误未处理,SDK 会捕获该错误,避免影响 SDK 内部逻辑的运行。

相关 API 请参考 on

5. 推拉流相关日志增加服务连接节点,便于查询日志定位问题

6. 日志事件上报相关字段区分正式环境和测试环境,方便统计信息

问题修复

1. 修复混流停止回调中调用退出房间可能报错的问题

2. 修复其它已知问题

2020-08-27Version:1.11.0

新增功能

1. 新增房间当前人数回调

用户进入房间后,会定时(30秒)触发 roomOnlineUserCountUpdate 回调,通知当前房间人数,开发者可直接获取到人数值。

相关 API 请参考 roomOnlineUserCountUpdate

改进优化

1. 混流为纯音频时,优化参数设置

简化了混流的参数设置,当混流为纯音频时,布局等相关参数会设置成默认值,开发者无需关注参数如何设置。

相关 API 请参考 startMixerTask

2. 增加 streamExtraInfoUpdate 的触发时机

当用户进入房间,房间内有流且带有附加信息时,streamExtraInfoUpdate 将会回调,因此开发者只需关注此回调即可处理流附加信息的逻辑。

相关 API 请参考 streamExtraInfoUpdate

问题修复

1. 修复其它已知问题

2020-08-13Version:1.10.0

新增功能

1. 新增支持双声道

提供双声道功能,该接口存在兼容问题,仅在 chrome 浏览器下支持。

相关 API 请参考 createStream

改进优化

1. 增加推流属性参数的类型判断

该优化增加了推流编码、流附加信息、备选参数的类型判断,避免出现不明报错信息。

相关 API 请参考 startPublishingStream

2. 优化媒体服务心跳

该优化旨在提升连接的稳定性,会根据媒体服务的心跳给出的参数,动态调节 SDK 向媒体服务发送心跳的间隔。

3. 推拉流相关日志增加流 ID , 便于查询日志定位问题

4. 推拉流上报可用带宽等信息,方便定位分辨率下降问题

5. 推流质量回调中增加丢包信息,便于定位网络问题

6. 推拉流质量回调增加对标签属性相关参数的监听

日志信息添加 muted 、paused、voilume 参数值,以便于定位推拉流无声问题。

问题修复

1. 修复推拉流状态在重复收到重试错误信息后可能不回调问题

2. 修复其它已知问题

2020-07-30Version:1.9.0

问题修复

  1. 修复订阅拉流更新回调信息中 CDN 地址为空的问题

  2. 修复其它已知问题

改进优化

  1. 创建屏幕共享流时优先使用插件进行屏幕共享,插件形式的屏幕共享兼容性更佳

  2. 优化停止推拉流接口的调用,推拉流后的任何时间都可以成功调用对应的停止接口

  3. 推拉流调度逻辑优化,减少不必要的代码执行

  4. 优化切换摄像头麦克风设备接口错误信息处理逻辑,相应的错误信息都会通过reject抛出

  5. 若调用停止推流前使用了混音功能,则调用停止推流接口时 SDK 内部将对应流的混音一并停止

  6. 优化 SDK 针对浏览器异常关闭的处理逻辑,兼容对浏览器beforeunload事件的监听

2020-07-20Version:1.8.1

问题修复

  1. startMixerTask 参数检查修正
2020-07-15Version:1.8.0

新增功能

  1. server 支持备用域名,提升在网络环境不好时的连通率

改进优化

  1. 统一对外错误码,对齐native 端
  2. 修复推拉流首次质量上报为空的问题,优化上报数据信息
  3. 开始、停止推拉流增加状态回调
  4. 修复切换设备内部部分错误没回调的问题
  5. 优化内部心跳发送逻辑
  6. 修复外接摄像头松动,web端拉流无法拉继续拉音频流问题
  7. 修复推流过程关闭摄像头,safari 拉音频流失败问题
  8. 修复其它已知问题
2020-06-30Version:1.7.0

新增功能

  1. 增加startMixingAudio 开始混音接口,并追加支持多路混音
  2. 增加stopMixingAudio 停止混音接口
  3. 新增音浪回调设置接口 setSoundLevelDelegate 用户可根据需要设置音浪回调频率,通过 soundLevelUpdate 回调

改进优化

  1. 拉流是否拉音视频若有设置以用户设置的为准
  2. 屏幕共享接口现支持多次调用
  3. 优化音频处理逻辑,避免性能浪费
  4. 推拉流视频编解码参数兼容大小写,提高容错率
  5. 修复推流前调用接口关闭摄像头麦克风,再进行推流,此时拉流端收到摄像头或麦克风状态不符合预期问题
  6. 修复在使用插件进行屏幕共享点击取消后多次弹窗问题,优化错误信息
  7. 修复其它已知问题
2020-06-15Version:1.6.0

问题修复

  1. 增加创建流createStream的接口对视频及音频码率的监测,解决参数越界导致推流失败问题
  2. 质量上报优化,解决部分浏览器存在质量上报缺失部分参数的问题
  3. 检测接口优化,修改部分监测时机,提高检测准确性
  4. publiserState及playerState状态回调优化,解决回到状态不够准确问题
  5. 流更新接口优化,解决房间流列表为空仍触发回调问题
  6. 修复其它已知问题
2020-06-08Version:1.5.2

问题修复

  1. startMixerTask 参数修正

  2. 修复日志信息过长上传报错

2020-06-02Version:1.5.1

问题修复

  • mutePublishStreamAudio 参数修正

  • 2020-05-15Version:1.5.0

    改进优化

    1. useVideoDevice useAudioDevice 切换设备接口改为Promise
    2. 优化部分错误码信息
    3. 优化拉流设备状态逻辑
    4. 优化部分关键日志

    问题修复

    1. 修复已知问题
    2020-04-30Version:1.4.0

    摄像头麦克风设备状态优化

    优化房间用户列表拉取策略

    修复已知问题

    2020-04-15Version:1.3.0

    客户端控制房间最大人数

    webrtc增加对https的检测

    优化节点重试逻辑

    修复已知问题

    2020-03-30Version:1.2.1

    新增remoteCameraStatusUpdate remoteMicStatusUpdate,监听回调推流端摄像头及麦克风设备状态

    新增节点重试逻辑,提高连接稳定性及成功率

    检测接口新增对屏幕共享功能检测,优化检测逻辑。相关接口: checkSystemRequirements

    新增推流设备状态信息上报,优化日志信息

    增加房间弹幕消息功能

    2019-11-28Version:1.1.0

    增加混流接口

    增加IM接口

    对齐各端接口,接口命名、参数命名、取值等统一

    2019-10-31Version:1.0.0

    Zego Webrtc Express SDK 初版发布。包含系统、房间、推流、拉流功能