开发准备
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();
}
下图为一级菜单和二级菜单样式：
![图片转存失败，建议将图片保存下来直接上传
(https://img2023.cnblogs.com/other/2396482/202301/2396482-20230131142013498-583515779.png)
(https://img2023.cnblogs.com/other/2396482/202301/2396482-20230131142015799-1918975293.png)
]()```
2、 带音频文件路径的启动方式。
// 设置音频导入路径 ArrayList 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 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过期或非法”。
请检查鉴权信息是否配置，如果未配置，可以参考此[链接](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)进行开启，开关开启后受缓存影响，一般需要等待一段时间才会生效。
