声网 Agora SDK 2.4 正式上线

阅读数:281 2019 年 11 月 30 日 13:51

声网 Agora SDK 2.4 正式上线

声网 Agora Voice/Video SDK 2.4 已经正式上线,大家可以在官网「开发者」中下载对应各系统平台的 SDK。新版本新增基础美颜、高优先级主播视频质量保障、趣味变声、听声辨位功能,可为全行业的多种场景带来更好的用户体验。

在 2.4 版中,我们优化了音频抗丢包的性能。在 1 对 1 教学、1 对 1 语音社交等通信、纯音频与音视频场景下,用户会得到更好的交互体验。围绕一些对音质要求较高的场景,例如音乐陪练、语音聊天室等,我们优化了 Android 端的音质效果。另外,我们在屏幕共享、本地视频回显效果、混响效果、质量透明等方面进行了优化。接下来,我们详细看一下本次的新增接口、功能改进,以及质量透明的最新特性。

新增功能

基础美颜

在社交、直播连麦,甚至是在线教育场景下,能以最好的状态示人,对主播们来讲非常重要。2.4 版 SDK 新增了基础美颜功能,通过以下新增方法可以轻松实现基础的美白、磨皮、红润等美颜效果。

复制代码
setBeautyEffectOptions(boolean enabled, BeautyOptions options)

该方法中有两个参数。 enabled 代表了是否开启美颜功能。 options 则包含了明暗对比度、亮度、平滑度、红润度四个参数,通过它们可以灵活调整美白、磨皮、红润等效果。

趣味变声

在社交娱乐和游戏中,变声功能可以进一步增加趣味性。2.4 版 SDK 新增了趣味变声功能,通过 setLocalVoiceChanger()方法,可以将用户的声音变为各种各样的角色。该方法目前提供了 6 种变声效果,包括老男孩、小女孩、绿巨人、猪八戒等。

预设声效太少?不是大问题。我们还开放了接口,可以通过调整音调、均衡和混响的参数值来定制自己想要的效果。

可以设想一下,在剧本杀这类角色扮演游戏中,可以用趣味变声,给玩家更进一步的游戏沉浸感。当然,大家也可以将这个方法应用于其它音视频互动场景下。

高优先级主播视频质量保障

这个新功能主要面向的是在线教育和一些直播社交的场景,优先让某个连麦用户收到的音视频质量为最高。大家可以通过 setRemoteUserPriority() 这个新增接口来实现,只需要将某个用户的优先级设为高,那么发给这个用户的音视频流的优先级就会高于其他用户。在与 setRemoteSubscribeFallbackOption 搭配使用时,即使该用户处于弱网状态下,也能保证他收到的音视频的质量。具体用法,大家可以参考声网 Agora 开发文档。

听声辨位

听声辨位这个功能,我们曾经介绍过,也已经应用于“小米枪战”中。现在该功能已被加入到 Native SDK 2.4 版中。通过新增的 enableSoundPositionIndication 和 setRemoteVoicePosition 方法,可以实现听声辨位功能,给角色扮演类游戏、射击游戏、多人竞技游戏等增加角色方位感,用声音来提升游戏沉浸感。

开发者需要在加入频道前调用 enableSoundPositionIndication 开启远端用户的语音立体声,然后在 setRemoteVoicePosition 中设置远端用户声音出现的位置,通过左右耳听到的声音差异,对远端用户的声音产生方位感。详细参数,大家需要参考文档来进行设置。

本地预览与性能优先

在过去的版本中,我们默认由 SDK 来自动控制摄像头的输出参数。但我们发现这可能无法满足一些场景的需求,甚至有时候会因为增加了视频的后处理(比如美颜、特效)会引起设备性能问题。所以我们增加了新的接口 setCameraCaptureConfiguration,通过设置摄像头采集偏好,开发者可以根据实际场景选择优先保证设备性能还是视频质量。

功能优化

屏幕共享

屏幕共享是广泛应用于视频会议和在线教育场景中的功能。2.4 版对该功能进行了多项优化,包括:

  • 支持外接屏幕共享
  • 支持设置屏幕共享分辨率、帧率、码率
  • 支持在屏幕共享过程中,动态调整共享区域、帧率、码率和分辨率
  • 针对不同分辨率,可精确定位鼠标位置
  • 支持设置分享内容为清晰度优先或流畅度优先
  • 支持在桌面或窗口共享时,指定共享其中的某个区域。
  • 在窗口共享时,支持窗口大小的动态变化
  • 关于以上功能优化所对应的新增接口及使用方法,可以在文档中心搜索“进行屏幕共享”,来阅读详细的接口调用方法。

高音质优化

在新版本 SDK 中,我们优化了 Agora 引擎的回声消除算法。在音乐陪练、语音聊天室等一些对音质要求较高的场景下,该优化可保证音乐的音质不受损失。

质量透明

通话前 Last-mile 网络探测

在通话前进行 Last-mile 网络探测,可以有效帮助本地用户判断和预测上行网络质量是否良好。该版本新增通话前 Last-mile 网络探测接口,向用户反馈开始通话前上下行网络的带宽、丢包、网络抖动和往返时延数据。接口包括:

  • startLastmileProbeTest: 开始 Last-mile 网络探测
  • stopLastmileProbeTest:停止 Last-mile 网络探测
  • lastmileProbeResult:Last-mile 网络探测结果回调

语音通话回路测试

在新版本中,新增 startEchoTestWithInterval 接口取代原有的 startEchoTest。该方法会启动语音通话测试,检测系统的音频设备(耳麦、扬声器等)和网络连接是否正常。通过新接口中的参数 intervalInSeconds,可以设置测试结果返回的时间间隔。

音频设备回路测试

该版本新增音频设备回路测试接口 startAudioDeviceLoopbackTest 与 stopAudioDeviceLoopbackTest,用于测试本地的麦克风和播放设备能否正常工作。该测试在本地进行,不涉及网络传输。

通话中视频流信息透明

该版本在本地视频流统计信息 AgoraRtcLocalVideoStats 类中新增 sentTargetBitrate,sentTargetFrameRate,qualityAdaptIndication 三个参数,分别反映目标码率、目标帧率与和上次返回的本地视频流统计信息相比,本地视频质量的自适应情况。

本文转载自公众号声网 Agora(ID:shengwang-agora)。

原文链接:

https://mp.weixin.qq.com/s/kQif6MAXb5MQJeoWQN0oHQ

评论

发布