全景声功能接入

更新时间：2023-03-15

接入准备

接入全景声功能，需要使用播放器SDK高级版，并申请高级版License。
在BDCloudMediaPlayer.framework中包含有音效配置文件WANOS_*.txt，将这些配置文件导入到你的APP中，并设置到Xcode的Copy Bundle Resources选项中。SDK会直接在mainBundle下寻找这些配置文件。
在vendor目录下有libauthcheck.a和libwanosdecoder.a两个静态库，将它们导入到你的项目中，并设置到Xcode的Link Binary With Libraries选项中

功能介绍

在高级版SDK中，提供了全景声（WANOS）音频格式的解码和音效处理能力。其中解码能力无需调用任何接口，由播放内核原生支持。音效处理能力由专门的音效接口提供，既可对全景声（WANOS）格式进行音效处理，也可以对AAC、MP3等常规音频格式进行处理，优化听感。当前支持的音效列表如下：

音效名称	效果说明
扬声器原声模式	原声，保留多声道听感
扬声器电影模式	使用扬声器虚拟环绕技术，增加声场宽度，使声场以及某些声像不仅仅局限于两个喇叭之间，而能扩展至两个扬声器外侧，提高声音的沉浸感
扬声器音乐模式	音乐相对于电影来说，更需要注重声音的音质，此模式采用最佳的频率响应，不加任何环绕处理，增强了语音的清晰度，使音乐声音更加自然
耳机原声模式	原声，保留多声道听感
耳机电影模式	使用耳机端的虚拟环绕技术，扩展声音的宽度，提高沉浸感，同时在一定程度上减小头中效应
耳机音乐模式	采用最佳的频率响应，不加任何环绕处理，增强了语音的清晰度，使音乐声音更加自然
耳机全景环绕模式	采用动态增强算法，配合科学的滤波处理，提高声音动态感，提升可玩性；让声音包围双耳，在一定程度上较小头中效应

Demo体验

接口说明

在BDCloudMediaPlayer中定义了音效类型枚举

Objective-C

1typedef NS_ENUM(NSInteger, BDCloudMediaPlayerAudioEffect) {
2    // 关闭音效
3    BDCloudMediaPlayerAudioEffectClose  = 0,
4    // 扬声器原声模式
5    BDCloudMediaPlayerAudioEffectSpeakerOriginal,
6    // 扬声器音乐模式
7    BDCloudMediaPlayerAudioEffectSpeakerMusic,
8    // 扬声器电影模式
9    BDCloudMediaPlayerAudioEffectSpeakerMovie,
10    // 耳机原声模式
11    BDCloudMediaPlayerAudioEffectEarphoneOriginal,
12    // 耳机音乐模式
13    BDCloudMediaPlayerAudioEffectEarphoneMusic,
14    // 耳机电影模式
15    BDCloudMediaPlayerAudioEffectEarphoneMovie,
16    // 耳机全景环绕模式
17    BDCloudMediaPlayerAudioEffectEarphoneSurround
18};

BDCloudMediaPlayerController提供如下的音效设置接口，在播放过程中传入不同的音效枚举类型即可实现音效处理的切换，接口会对SDK有效性和证书有效性做校验，如不符合高级版SDK要求，会返回错误，错误码定义于BDCloudAVAuthErrorCode。在Demo中也对此接口的使用做了展示，可以参考。