华为 HMS Core [音频编辑服务](https://developer.huawei.com/consumer/cn/hms/huawei-audio-editor/?ha_source=hms1)（Audio Editor Kit）是华为帮助全球开发者快速构建各类应用音频能力的服务，汇聚了华为在音乐、语音等相关音频领域的先进技术。音频编辑服务为开发者们提供音频基础编辑、AI配音、音源分离、空间渲染、变声、多种音效等丰富的音频处理能力，以及性能优异、简单易用、开放性强的接口，开发者们可依据应用场景，在App中高效轻松完成音频功能的集成。

![](https://oscimg.oschina.net/oscnet/up-0fd231851226ad49e6aacc1bcf2da61fe92.jpg)
 
音频编辑UI SDK提供产品级UI界面，集成接入简单、快速。

### 开发准备

1、[配置AppGallery Connect](https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/config-agc-0000001154009063?ha_source=hms1)

2、[配置HMS Core SDK的Maven仓地址](https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/integrating-sdk-0000001154289127#section290812311592?ha_source=hms1)

3、[集成HMS Core SDK](https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/integrating-sdk-0000001154289127?ha_source=hms1)

4、在“AndroidManifest.xml”文件中[添加相关权限](https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/add-permissions-0000001154228175%E7%A0%81?ha_source=hms1)。

说明：如果应用集成的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工具类，可以在[示例代码](https://developer.huawei.com/consumer/cn/doc/development/Media-Examples/android-sample-code-0000001152953929?ha_source=hms1)中查看，工具类路径为：

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

![](https://oscimg.oschina.net/oscnet/up-20abd2131045b96bbe852216e945241a5d4.png)
	![](https://oscimg.oschina.net/oscnet/up-6cfbe8652fe9bff1d62f7a7a0c7c2c439bf.png)
	
	
方式二：带入参的启动方式，支持设置菜单列表、自定义导出文件路径、音频文件路径、草稿模式等。

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://oscimg.oschina.net/oscnet/up-b4b60ea8c3cefae7069012b427278d516eb.png)
	![](https://oscimg.oschina.net/oscnet/up-066606bee2a938735b4ea1ddd55245a29d1.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();
}
```

带音频文件路径的启动方式，启动音频编辑页面后会直接进入二级菜单。

![](https://oscimg.oschina.net/oscnet/up-c030930e0d2142ad3e1e0ce5fd9be84b99a.png)
 
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

![](https://oscimg.oschina.net/oscnet/up-3eeaf13b3c35d7b2b0e425c0cd33970ed53.gif)
 
### 常见问题

Q1：添加音效、AI配音等功能提示“Token过期或非法”。

请检查鉴权信息是否配置，如果未配置，可以参考此[链接](https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/client-dev-0000001107465102?ha_source=hms1)进行配置。

一般在日志中会有如下提示：HAEApplication: please set your app apiKey。

Q2：在进行相关操作时，提示“内部错误”。

1、检查鉴权信息是否配置。

2、在AppGallery Connect中检查应用的音频编辑服务开关是否开启。如果未开启，可以参考此[链接](https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-enabling-service-0000001146598793?ha_source=hms1)进行开启，开关开启后受缓存影响，一般需要等待一段时间才会生效。

**了解更多详情>>**

访问[华为开发者联盟官网](http://developer.huawei.com/consumer/cn/hms?ha_source=hms1)  
获取[开发指导文档](http://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)  
华为移动服务开源仓库地址：[GitHub](http://github.com/HMS-Core)、[Gitee](http://gitee.com/hms-core)

**关注我们，第一时间了解 HMS Core 最新技术资讯~**

ITPub博客

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

最新文章