華為 HMS Core 音頻編輯服務（Audio Editor Kit）是華為幫助全球開發者快速構建各類應用音頻能力的服務，匯聚了華為在音樂、語音等相關音頻領域的先進技術。音頻編輯服務為開發者們提供音頻基礎編輯、AI配音、音源分離、空間渲染、變聲、多種音效等豐富的音頻處理能力，以及性能優異、簡單易用 ...
華為 HMS Core 音頻編輯服務（Audio Editor Kit）是華為幫助全球開發者快速構建各類應用音頻能力的服務，匯聚了華為在音樂、語音等相關音頻領域的先進技術。音頻編輯服務為開發者們提供音頻基礎編輯、AI配音、音源分離、空間渲染、變聲、多種音效等豐富的音頻處理能力，以及性能優異、簡單易用、開放性強的介面，開發者們可依據應用場景，在App中高效輕鬆完成音頻功能的集成。
音頻編輯UI SDK提供產品級UI界面，集成接入簡單、快速。
開發準備
4、在“AndroidManifest.xml”文件中添加相關許可權。
說明：如果應用集成的Android SDK版本為29及以上時，還需要在AndroidManifest.xml的application節點下新增以下屬性，以獲取訪問外部存儲文件的許可權。
<application
android:requestLegacyExternalStorage="true"
…… >
支持的設備
REST
Android：
華為手機 EMUI5.0 及以上
非華為手機 Android7.0 及以上
SDK集成開發
1、初始化SDK，設置應用的鑒權信息，如果不設置將影響部分功能的使用。
// 獲取agconnect-services.json文件中的api_key。
// 正式應用中建議將api_key存儲在雲側，運行時在進行獲取。
String api_key = AGConnectInstance.getInstance().getOptions().getString("client/api_key");
// 設置api_key
HAEApplication.getInstance().setApiKey(api_key);
2、創建AudioFilePickerActivity，此Activity為自定義Activity，用於音頻文件選擇。
/**
* 自定義Activity界面，用於音頻文件的選擇
*/
public class AudioFilePickerActivity extends AppCompatActivity {
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
performFileSearch();
}
private void performFileSearch() {
// 選擇多個音頻文件
registerForActivityResult(new ActivityResultContracts.GetMultipleContents(), new ActivityResultCallback<List<Uri>>() {
@Override
public void onActivityResult(List<Uri> result) {
handleSelectedAudios(result);
finish();
}
}).launch("audio/*");
}
/**
* 處理選定的音頻，將Uri轉成需要的路徑
*
* @param uriList 選中的音頻文件
*/
private void handleSelectedAudios(List<Uri> uriList) {
// 判斷是否存在音頻文件
if (uriList == null || uriList.size() == 0) {
return;
}
ArrayList<String> audioList = new ArrayList<>();
for (Uri uri : uriList) {
// 獲取真實路徑
String filePath = FileUtils.getRealPath(this, uri);
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();
}
}
獲取真實路徑時用到的FileUtils工具類，可以在示例代碼中查看，工具類路徑為：
app/src/main/java/com/huawei/hms/audioeditor/demo/util/FileUtils.java
3、在“AndroidManifest.xml”中為AudioFilePickerActivity添加action值，SDK將根據此action進行跳轉。
<activity
android:name=".AudioFilePickerActivity"
android:exported="false">
<intent-filter>
<action android:name="com.huawei.hms.audioeditor.chooseaudio" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
4、啟動音頻編輯頁面。
方式一：不帶入參的啟動方式，使用SDK提供的預設配置，方便快捷。
HAEUIManager.getInstance().launchEditorActivity(this);
方式二：帶入參的啟動方式，支持設置菜單列表、自定義導出文件路徑、音頻文件路徑、草稿模式等。
1、 帶菜單列表以及自定義導出文件路徑的啟動方式：
// 一級菜單列表（以下菜單列表僅為部分示例）
ArrayList<Integer> menuList = new ArrayList<>();
// 添加音頻
menuList.add(MenuCommon.MAIN_MENU_ADD_AUDIO_CODE);
// 錄音
menuList.add(MenuCommon.MAIN_MENU_AUDIO_RECORDER_CODE);
// 二級菜單列表（以下菜單列表僅為部分示例），導入音頻後，選中音頻時展示
ArrayList<Integer> secondMenuList = new ArrayList<>();
// 分割
secondMenuList.add(MenuCommon.EDIT_MENU_SPLIT_CODE);
// 刪除
secondMenuList.add(MenuCommon.EDIT_MENU_DEL_CODE);
// 音量
secondMenuList.add(MenuCommon.EDIT_MENU_VOLUME2_CODE);
// 自定義導出路徑
String exportPath = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MUSIC).getPath() + "/";
AudioEditorLaunchOption.Builder audioEditorLaunch = new AudioEditorLaunchOption.Builder()
// 設置一級菜單
.setCustomMenuList(menuList)
// 設置二級菜單
.setSecondMenuList(secondMenuList)
// 設置導出路徑
.setExportPath(exportPath);
// 帶菜單列表以及自定義音頻文件導出路徑的啟動方式
try {
HAEUIManager.getInstance().launchEditorActivity(this, audioEditorLaunch.build(), new LaunchCallback() {
@Override
public void onFailed(int errCode, String errMsg) {
Toast.makeText(mContext, errMsg, Toast.LENGTH_SHORT).show();
}
});
} catch (IOException e) {
e.printStackTrace();
}
下圖為一級菜單和二級菜單樣式：
2、 帶音頻文件路徑的啟動方式。
// 設置音頻導入路徑
ArrayList<AudioInfo> audioInfoList = new ArrayList<>();
// 音頻路徑，以實際路徑為準。
String audioPath = "/storage/emulated/0/Music/Dream_It_Possible.flac";
// 創建AudioInfo實例，並傳入音頻路徑。
AudioInfo audioInfo = new AudioInfo(audioPath);
// 設置音頻名字
audioInfo.setAudioName("Dream_It_Possible");
audioInfoList.add(audioInfo);
AudioEditorLaunchOption.Builder audioEditorLaunch = new AudioEditorLaunchOption.Builder()
// 設置音頻導入路徑
.setFilePaths(audioInfoList);
// 帶音頻文件路徑的啟動方式
try {
HAEUIManager.getInstance().launchEditorActivity(this, audioEditorLaunch.build(), new LaunchCallback() {
@Override
public void onFailed(int errCode, String errMsg) {
Toast.makeText(mContext, errMsg, Toast.LENGTH_SHORT).show();
}
});
} catch (IOException e) {
e.printStackTrace();
}
帶音頻文件路徑的啟動方式，啟動音頻編輯頁面後會直接進入二級菜單。
3、 帶草稿的啟動方式。
// 獲取草稿列表，此處只做演示使用
List<DraftInfo> draftList = HAEUIManager.getInstance().getDraftList();
// 指定草稿列表的第一個草稿
String draftId = null;
if (!draftList.isEmpty()) {
draftId = draftList.get(0).getDraftId();
}
AudioEditorLaunchOption.Builder audioEditorLaunch = new AudioEditorLaunchOption.Builder()
// 設置草稿ID，可以為null
.setDraftId(draftId)
// 設置草稿模式，預設值為NOT_SAVE：不保存。
.setDraftMode(AudioEditorLaunchOption.DraftMode.SAVE_DRAFT);
// 帶草稿的啟動方式
try {
HAEUIManager.getInstance().launchEditorActivity(this, audioEditorLaunch.build(), new LaunchCallback() {
@Override
public void onFailed(int errCode, String errMsg) {
Toast.makeText(mContext, errMsg, Toast.LENGTH_SHORT).show();
}
});
} catch (IOException e) {
e.printStackTrace();
}
演示Demo
常見問題
Q1：添加音效、AI配音等功能提示“Token過期或非法”。
請檢查鑒權信息是否配置，如果未配置，可以參考此鏈接進行配置。
一般在日誌中會有如下提示：HAEApplication: please set your app apiKey。
Q2：在進行相關操作時，提示“內部錯誤”。
1、檢查鑒權信息是否配置。
2、在AppGallery Connect中檢查應用的音頻編輯服務開關是否開啟。如果未開啟，可以參考此鏈接進行開啟，開關開啟後受緩存影響，一般需要等待一段時間才會生效。
瞭解更多詳情>>
訪問華為開發者聯盟官網
獲取開髮指導文檔
華為移動服務開源倉庫地址：GitHub、Gitee
關註我們，第一時間瞭解 HMS Core 最新技術資訊~
