音訊編輯服務UI SDK接入指導及常見問題

華為 HMS Core 音訊編輯服務（Audio Editor Kit）是華為幫助全球開發者快速構建各類應用音訊能力的服務，匯聚了華為在音樂、語音等相關音訊領域的先進技術。音訊編輯服務為開發者們提供音訊基礎編輯、AI配音、音源分離、空間渲染、變聲、多種音效等豐富的音訊處理能力，以及效能優異、簡單易用、開放性強的介面，開發者們可依據應用場景，在App中高效輕鬆完成音訊功能的整合。

音訊編輯UI SDK提供產品級UI介面，整合接入簡單、快速。

開發準備

1、配置AppGallery Connect

2、配置HMS Core SDK的Maven倉地址

3、整合HMS Core SDK

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);

![](/img/bVc58p0)

方式二：帶入參的啟動方式，支援設定選單列表、自定義匯出檔案路徑、音訊檔案路徑、草稿模式等。

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();
}

下圖為一級選單和二級選單樣式：

![](/img/bVc58p1)
![](/img/bVc58p2)

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 最新技術資訊~

音訊編輯服務UI SDK接入指導及常見問題

開發準備

支援的裝置

SDK整合開發

常見問題

相關文章