在音乐创作、音视频剪辑和游戏等畛域中,给用户带来沉迷式音频体验越来越重要。开发者如何在利用内打造 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() {
// 获取到的音频文件门路 filePath
String filePath = "/sdcard/AudioEdit/audio/music.aac";
ArrayList<String> audioList = new ArrayList<>();
audioList.add(filePath);
// 将音频文件门路返回到音频编辑页面
Intent intent = new Intent();
// 应用 sdk 提供的 HAEConstant.AUDIO_PATH_LIST
intent.putExtra(HAEConstant.AUDIO_PATH_LIST, audioList);
// 应用 sdk 提供的 HAEConstant.RESULT_CODE 为后果 CODE
this.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)@Override
public void onProgress(int progress) { }
// 转换失败
@Override
public void onFail(int errorCode) { }
// 转换胜利
@Override
public void onSuccess(String outPutPath) { }
// 勾销转换
@Override
public void onCancel() {}
});
// 勾销转换工作接口
HAEAudioExpansion.getInstance().cancelTransformAudio();
调用 transformAudio 接口进行音频格式转换,转换后的音频文件导出到指标门路。
// 音频格式转换接口
HAEAudioExpansion.getInstance().transformAudio(context,inAudioPath, outAudioPath, new OnTransformCallBack(){
// 进度回调(0-100)@Override
public void onProgress(int progress) { }
// 转换失败
@Override
public void onFail(int errorCode) { }
// 转换胜利
@Override
public void onSuccess(String outPutPath) { }
// 勾销转换
@Override
public void onCancel() {}
});
// 勾销转换工作接口
HAEAudioExpansion.getInstance().cancelTransformAudio();
2.5 如果素材是视频格式,能够调用 extractAudio 接口进行音频提取,从视频中提取音频文件再导出到指定目录 :
// outAudioDir 提取出的音频保留的文件夹门路,非必填
// outAudioName 提取出的音频名称,不带后缀,非必填
HAEAudioExpansion.getInstance().extractAudio(context,inVideoPath,outAudioDir, outAudioName,new AudioExtractCallBack() {
@Override
public void onSuccess(String audioPath) {Log.d(TAG, "ExtractAudio onSuccess :" + audioPath);
}
@Override
public void onProgress(int progress) {Log.d(TAG, "ExtractAudio onProgress :" + progress);
}
@Override
public void onFail(int errCode) {Log.i(TAG, "ExtractAudio onFail :" + errCode);
}
@Override
public 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}
@Override
public void onError(int errorCode) {// 失败返回}
});
// 设置要提取的伴奏参数
List instruments = new ArrayList<>();
instruments.add(“伴奏 id”);
haeAudioSeparationFile.setInstruments(instruments);
// 开始进行伴奏拆散
haeAudioSeparationFile.startSeparationTasks(inAudioPath, outAudioDir, outAudioName, new AudioSeparationCallBack() {
@Override
public void onResult(SeparationBean separationBean) { }
@Override
public void onFinish(List<SeparationBean> separationBeans) {}
@Override
public void onFail(int errorCode) {}
@Override
public 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 最新技术资讯~