在音樂創作、音視頻剪輯和游戲等領域中,給用戶帶來沉浸式音頻體驗越來越重要,開發者如何在應用內打造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 one rror(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 最新技術資訊~
轉載請註明出處,本文鏈接:https://www.uj5u.com/yidong/380845.html
標籤:其他
下一篇:將結構值添加到C中的char陣列
