声临其境，轻松几步教你把音频变成3D环绕音

在音乐创作、音视频剪辑和游戏等领域中，给用户带来沉浸式音频体验越来越重要。开发者如何在应用内打造3D环绕声效？华为音频编辑服务6.2.0版本此次带来了空间动态渲染功能，可以将人声、乐器等音频元素渲染到指定的三维空间方位，支持静态和动态渲染两种模式，进一步提升应用中的音效体验。开发者可以点击查看以下Demo演示，了解集成效果并上手实验功能特性。

开发实战

1. 开发准备

开发者提前准备音乐素材，MP3格式最佳。其他音频格式请参考“2.4”步骤转换，视频格式请参考“2.5”步骤进行音频提取。

1.1项目级build.gradle里配置Maven仓地址：

buildscript {repositories {google()jcenter()// 配置HMS Core SDK的Maven仓地址。maven {url 'https://developer.huawei.com/repo/'}}dependencies {...// 增加agcp插件配置。classpath 'com.huawei.agconnect:agcp:1.4.2.300'}
}
allprojects {repositories {google()jcenter()// 配置HMS Core SDK的Maven仓地址。maven {url 'https://developer.huawei.com/repo/'}}
}

1.2 文件头增加配置：

apply plugin: 'com.huawei.agconnect'

1.3 应用级build.gradle里配置SDK依赖：

dependencies{implementation 'com.huawei.hms:audio-editor-ui:{version}'
}

1.4在AndroidManifest.xml文件中申请如下权限：

<!--震动权限-->
<uses-permission android:name="android.permission.VIBRATE" />
<!--麦克风权限-->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!--写存储权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!--读存储权限-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!--网络权限-->
<uses-permission android:name="android.permission.INTERNET" />
<!--网络状态权限-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!--网络状态变化权限-->
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

2.代码开发

2.1创建应用自定义的activity界面，用于选择音频，并将该音频文件路径返回给音频编辑SDK：

// 将音频文件路径List返回到音频编辑页面
private void sendAudioToSdk() {// 获取到的音频文件路径 filePathString filePath = "/sdcard/AudioEdit/audio/music.aac";ArrayList<String> audioList = new ArrayList<>();audioList.add(filePath);// 将音频文件路径返回到音频编辑页面Intent intent = new Intent();// 使用sdk提供的HAEConstant.AUDIO_PATH_LISTintent.putExtra(HAEConstant.AUDIO_PATH_LIST, audioList);// 使用sdk提供的HAEConstant.RESULT_CODE为结果CODEthis.setResult(HAEConstant.RESULT_CODE, intent);finish();
}

2.2在UI界面导入音频时，SDK会发送一个action值为com.huawei.hms.audioeditor.chooseaudio的intent以跳转到该activity。因此，该activity“AndroidManifest.xml”中的注册形式如下：

<activity android:name="Activity ">
<intent-filter>
<action android:name="com.huawei.hms.audioeditor.chooseaudio"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</activity>

2.3启动音频编辑页面，点击“添加音频”，SDK会主动调用“2.1”步骤中定义的activity。添加好音频，就可以进行音频编辑、特效添加等操作，完成后导出编辑音频。

HAEUIManager.getInstance().launchEditorActivity(this);

2.4.如果音频素材不是MP3格式，此步骤可以完成音频格式转换：

调用transformAudioUseDefaultPath接口进行音频格式转换，转换后的音频文件导出到默认路径。

// 音频格式转换接口
HAEAudioExpansion.getInstance().transformAudioUseDefaultPath(context,inAudioPath, audioFormat, new OnTransformCallBack() {// 进度回调（0-100）@Overridepublic void onProgress(int progress) {}// 转换失败@Overridepublic void onFail(int errorCode) {}// 转换成功@Overridepublic void onSuccess(String outPutPath) {}// 取消转换@Overridepublic void onCancel() {}});// 取消转换任务接口
HAEAudioExpansion.getInstance().cancelTransformAudio();

调用transformAudio接口进行音频格式转换，转换后的音频文件导出到目标路径。

// 音频格式转换接口
HAEAudioExpansion.getInstance().transformAudio(context,inAudioPath, outAudioPath, new OnTransformCallBack(){// 进度回调（0-100）@Overridepublic void onProgress(int progress) {}// 转换失败@Overridepublic void onFail(int errorCode) {}// 转换成功@Overridepublic void onSuccess(String outPutPath) {}// 取消转换@Overridepublic void onCancel() {}});
// 取消转换任务接口
HAEAudioExpansion.getInstance().cancelTransformAudio();

2.5如果素材是视频格式，可以调用extractAudio接口进行音频提取，从视频中提取音频文件再导出到指定目录：

// outAudioDir提取出的音频保存的文件夹路径，非必填
// outAudioName提取出的音频名称，不带后缀，非必填
HAEAudioExpansion.getInstance().extractAudio(context,inVideoPath,outAudioDir, outAudioName,new AudioExtractCallBack() {@Overridepublic void onSuccess(String audioPath) {Log.d(TAG, "ExtractAudio onSuccess : " + audioPath);}@Overridepublic void onProgress(int progress) {Log.d(TAG, "ExtractAudio onProgress : " + progress);}@Overridepublic void onFail(int errCode) {Log.i(TAG, "ExtractAudio onFail : " + errCode);}@Overridepublic void onCancel() {Log.d(TAG, "ExtractAudio onCancel.");}});
// 取消音频提取任务接口
HAEAudioExpansion.getInstance().cancelExtractAudio();

2.6调用getInstruments和startSeparationTasks接口进行伴奏提取。

// 获取提取伴奏类型ID，后面将此ID传给接口
HAEAudioSeparationFile haeAudioSeparationFile = new HAEAudioSeparationFile();
haeAudioSeparationFile.getInstruments(new SeparationCloudCallBack<List<SeparationBean>>() {@Override
public void onFinish(List<SeparationBean> response) {
// 返回的数据，包括伴奏的类型ID
}@Overridepublic void onError(int errorCode) {// 失败返回
}
});
// 设置要提取的伴奏参数
List instruments = new ArrayList<>();
instruments.add(“伴奏id”);
haeAudioSeparationFile.setInstruments(instruments);
// 开始进行伴奏分离
haeAudioSeparationFile.startSeparationTasks(inAudioPath, outAudioDir, outAudioName, new AudioSeparationCallBack() {@Overridepublic void onResult(SeparationBean separationBean) { }@Overridepublic void onFinish(List<SeparationBean> separationBeans) {}@Overridepublic void onFail(int errorCode) {}@Overridepublic void onCancel() {}
});
// 取消分离任务
haeAudioSeparationFile.cancel();

2.7调用applyAudioFile接口进行空间方位渲染。

// 空间方位渲染
// 固定摆位
HAESpaceRenderFile haeSpaceRenderFile = new HAESpaceRenderFile(SpaceRenderMode.POSITION);
haeSpaceRenderFile.setSpacePositionParams(new SpaceRenderPositionParams(x, y, z));
// 动态渲染
HAESpaceRenderFile haeSpaceRenderFile = new HAESpaceRenderFile(SpaceRenderMode.ROTATION);
haeSpaceRenderFile.setRotationParams( new SpaceRenderRotationParams(x, y, z, surroundTime, surroundDirection));
// 扩展
HAESpaceRenderFile haeSpaceRenderFile = new HAESpaceRenderFile(SpaceRenderMode.EXTENSION);
haeSpaceRenderFile.setExtensionParams(new SpaceRenderExtensionParams(radiusVal, angledVal));
// 调用接口
haeSpaceRenderFile.applyAudioFile(inAudioPath, outAudioDir, outAudioName, callBack);
// 取消空间方位渲染
haeSpaceRenderFile.cancel();

完成以上步骤，就可以得到对应的空间动态渲染效果，在应用内轻松实现2D转3D音效啦！这项功能还可以应用到企业会议以及运动康复领域，比如在展会上进行产品沉浸式展示、作为视障人群的方向感线索，为日常生活提供便利等。开发者们可以根据自己应用的实际需求选择使用，如需了解更多详情，请参考：
华为开发者联盟音频编辑服务官网; 获取集成音频编辑服务指导文档。

了解更多详情>>

访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee

关注我们，第一时间了解 HMS Core 最新技术资讯~