华为 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(MenuCommo