音频编辑服务UI SDK接入指导及常见问题

技术分享 3年前 (2023-02-01) 0 999+

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

音频编辑服务UI SDK接入指导及常见问题

方式二：带入参的启动方式，支持设置菜单列表、自定义导出文件路径、音频文件路径、草稿模式等。

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

下图为一级菜单和二级菜单样式：

![](https://img2023.cnblogs.com/other/2396482/202301/2396482-20230131142013498-583515779.png) ![](https://img2023.cnblogs.com/other/2396482/202301/2396482-20230131142015799-1918975293.png)

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