华为 HMS Core 音频编辑服务(Audio Editor Kit)是华为帮助全球开发者快速构建各类应用音频能力的服务,汇聚了华为在音乐、语音等相关音频领域的先进技术。音频编辑服务为开发者们提供音频基础编辑、AI配音、音源分离、空间渲染、变声、多种音效等丰富的音频处理能力,以及性能优异、简单易用、开放性强的接口,开发者们可依据应用场景,在App中高效轻松完成音频功能的集成。
音频编辑UI SDK提供产品级UI界面,集成接入简单、快速。
4、在“AndroidManifest.xml”文件中添加相关权限。
说明:如果应用集成的Android SDK版本为29及以上时,还需要在AndroidManifest.xml的application节点下新增以下属性,以获取访问外部存储文件的权限。
1 2 3 | <application android:requestLegacyExternalStorage = "true" …… > |
REST
Android:
华为手机 EMUI5.0 及以上
非华为手机 Android7.0 及以上
1、初始化SDK,设置应用的鉴权信息,如果不设置将影响部分功能的使用。
1 2 3 4 5 | / / 获取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,用于音频文件选择。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 | / * * * 自定义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工具类,可以在示例代码中查看,工具类路径为:
1 | app / src / main / java / com / huawei / hms / audioeditor / demo / util / FileUtils.java |
3、在“AndroidManifest.xml”中为AudioFilePickerActivity添加action值,SDK将根据此action进行跳转。
1 2 3 4 5 6 7 8 | <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提供的默认配置,方便快捷。
1 | HAEUIManager.getInstance().launchEditorActivity(this); |
方式二:带入参的启动方式,支持设置菜单列表、自定义导出文件路径、音频文件路径、草稿模式等。
1、 带菜单列表以及自定义导出文件路径的启动方式:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 | / / 一级菜单列表(以下菜单列表仅为部分示例) 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(); } |
下图为一级菜单和二级菜单样式:
1 2 | ![](https: / / oscimg.oschina.net / oscnet / up - b4b60ea8c3cefae7069012b427278d516eb.png) ![](https: / / oscimg.oschina.net / oscnet / up - 066606bee2a938735b4ea1ddd55245a29d1 .png) |
2、 带音频文件路径的启动方式。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | / / 设置音频导入路径 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、 带草稿的启动方式。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | / / 获取草稿列表,此处只做演示使用 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中检查应用的音频编辑服务开关是否开启。如果未开启,可以参考此链接进行开启,开关开启后受缓存影响,一般需要等待一段时间才会生效。
了解更多详情>>
访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址:GitHub、Gitee
关注我们,第一时间了解 HMS Core 最新技术资讯~