即构SDK8月迭代：新增下行网络测速切换房间预览首帧回调等多项功能

Posted 2020-12-19 zegoinfo

即构SDK8月上新，网络探测模块新增下行网络测速、媒体播放器新增缓存到文件结尾的回调、新增切换房间功能、新增预览首帧回调等。本月SDK迭代新上线的功能非常丰富，详细内容请看下文。

 

LiveRoom

新增

 

1、网络探测模块新增下行网络测速功能

在拉流前可进行下行网络测速，可有效帮助用户判断和预测下行网络质量是否良好。此前，即构SDK已支持推流前上行网络测速，帮助用户判断和预测上行网络质量是否良好。

新增 StartDownlinkSpeedTest，StopDownlinkSpeedTest 等接口，用于下行网络测速。

如需要网络测速模块功能，请联系 ZEGO 技术支持处理。

 

2、媒体播放器新增缓存到文件结尾的回调

通过该回调，便于掌握媒体播放器的缓存加载情况。在教育场景中，教学视频缓存到达结尾时可能需要提示用户即将播放下一教学视频/开始下一章节等。

在event回调中新增onReadEoF回调，当文件缓冲到达文件的结束时抛出。

 

3、新增切换房间功能

通过“切换房间”功能，可以实现从一个房间快速切换到另一个房间。

此前切换房间，是通过“调用登出原房间和加入新房间”两个接口来实现；新的切换房间功能，通过调用新增的SwitchRoom 接口，调用后停止上一个房间的推拉流并进入新房间，切换房间成功会收到新房间登录成功的回调。与之前的方法相比，更易用也更高效。

 

4、新增AudioDeviceMode下General2模式

该模式下会保持对设备的占用，让切换房间耗时更短。在狼人杀和剧本杀等场景下，使用该模式可以让用户切换房间后推流/拉流时快速发出声音/听到声音。

具体配置可联系 ZEGO 技术支持咨询。

 

5、新增预览首帧回调

启动本地预览（startPreview）时，渲染出第一帧作为回调抛出。便于使用视频外部采集设备时，掌握开启本地预览的情况。

每个开启预览（startPreview）/结束预览（stopPreview）周期内只会抛出一次首帧回调。期间调用设置预览（setPreview）和开关摄像头（enableCam）不会触发此回调。

 

优化

 

1、媒体播放器支持同时播放音视频文件的数量从4个提高到10个

通过优化重构MediaPlayer模块，SDK支持创建最多10个媒体播放器实例，同时播放音视频文件。

在线教育场景下，通过在课前播放多种音效，如鼓掌声、欢呼声等，活跃课堂气氛，让学生快速进入课堂状态。

 

2、优化初始化反初始化的逻辑

原先enableMic和setFrontCam等接口在反初始化后再次初始化SDK时，在主副通道的逻辑不一致，偶现状态未被重置的情况。优化逻辑后，反初始化SDK后再初始化，所有状态会正确重置。

 

3、混流支持单独调整输入流的音量

在多路混流时，可单独调整某条流的声音音量，解决混流后因为音频来源本身的音量大小差距较大，而导致混流后的音频音量不均衡的问题。由默认的0-100，修改为0-200。

 

4、优化投屏场景下声音回采问题

通过配置可以实现AirPlay连接时，声音依旧从手机设备播放，解决投屏场景下声音回采的问题。可通过SetConfig("air_play_route_to_speaker") 配置设置。

 

5、增加60Hz高通滤波器的配置开关选项

SDK默认打开该选项，用于处理低于60Hz的低频杂音，可通过SetConfig("prep_high_pass_filter=false")配置关闭。

 

AudioRoom

 

新增

 

1、网络探测模块新增下行网络测速功能

在拉流前可进行下行网络测速，可有效帮助用户判断和预测下行网络质量是否良好。此前，即构SDK已支持推流前上行网络测速，帮助用户判断和预测上行网络质量是否良好。 

新增 StartDownlinkSpeedTest，StopDownlinkSpeedTest 等接口，用于下行网络测速。

如需要网络测速模块功能，请联系 ZEGO 技术支持处理。

 

2、媒体播放器新增缓存到文件结尾的回调

通过该回调，便于掌握媒体播放器的缓存加载情况。在教育场景中，教学素材缓存到达结尾时可能需要提示用户即将播放下一个教学视频/开始下一章节等。

在event回调中新增onReadEoF回调，当文件缓冲到达文件的结束时抛出。

 

3、新增SetConfig的修改配置接口

LiveRoom SDK已有此修改配置的接口，现AudioRoom开放SetConfig接口与LiveRoom SDK对齐。

 

4、新增切换房间功能

通过“切换房间”功能，可以实现从一个房间快速切换到另一个房间。

此前切换房间，是通过“调用登出原房间和加入新房间”两个接口来实现；新的切换房间功能，通过调用新增的SwitchRoom 接口，调用后停止上一个房间的推拉流并进入新房间，切换房间成功会收到新房间登录成功的回调。与之前的方法相比，更易用也更高效。

 

5、新增AudioDeviceMode下General2模式

该模式下会保持对设备的占用，让切换房间耗时更短。在狼人杀和剧本杀等场景下，使用该模式可以让用户切换房间后推流/拉流时快速发出声音/听到声音。

具体配置可联系 ZEGO 技术支持咨询。

 

 

优化

 

1、媒体播放器支持同时播放音视频文件的数量从4个提高到10个

通过优化重构MediaPlayer模块，SDK支持创建最多10个媒体播放器实例，同时播放音视频文件。

 

2、优化初始化反初始化的逻辑

原先enableMic和setFrontCam等接口在反初始化后再次初始化SDK时，在主副通道的逻辑不一致，偶现状态未被重置的情况。优化逻辑后，反初始化SDK后再初始化，所有状态会正确重置。

 

3、混流支持单独调整输入流的音量

在多路混流时，可单独调整某条流的声音音量，解决混流后因为音频来源本身的音量大小差距较大，而导致混流后的音频音量不均衡的问题。由默认的0-100，修改为0-200。

 

4、增加60Hz高通滤波器的配置开关选项

SDK默认打开该选项，用于处理低于60Hz的低频杂音，可通过SetConfig("prep_high_pass_filter=false")配置关闭。

 

以上就是本月SDK更新迭代的主要内容，更多详细文档以及SDK历史更新内容，可以进入“即构官网（zego.im）-开发者中心”查看。