写点什么

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

作者:HMS Core
  • 2023-02-02
    新加坡
  • 本文字数:3741 字

    阅读完需:约 12 分钟

华为 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_keyHAEApplication.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://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();}
复制代码


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



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 中检查应用的音频编辑服务开关是否开启。如果未开启,可以参考此链接进行开启,开关开启后受缓存影响,一般需要等待一段时间才会生效。


了解更多详情>>


访问华为开发者联盟官网


获取开发指导文档


华为移动服务开源仓库地址:GitHubGitee


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

用户头像

HMS Core

关注

HMS Core技术团队。 2022-06-16 加入

分享最新的技术干货,带来最全的能力应用场景,更新热门开发者圈子活动。与开发者一起,同成长,共精彩。

评论

发布
暂无评论
音频编辑服务UI SDK接入指导及常见问题_HMS Core_HMS Core_InfoQ写作社区