关于android:音频编辑服务UI-SDK接入指导及常见问题

华为 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 及以上

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

![](/img/bVc58p0)

形式二：带入参的启动形式，反对设置菜单列表、自定义导出文件门路、音频文件门路、草稿模式等。

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();
}

下图为一级菜单和二级菜单款式：

![](/img/bVc58p1)
![](/img/bVc58p2)

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 中查看利用的音频编辑服务开关是否开启。如果未开启，能够参考此链接进行开启，开关开启后受缓存影响，个别须要期待一段时间才会失效。

理解更多详情 >>

拜访华为开发者联盟官网
获取开发领导文档
华为挪动服务开源仓库地址：GitHub、Gitee

关注咱们，第一工夫理解 HMS Core 最新技术资讯~

关于android:音频编辑服务UI-SDK接入指导及常见问题

开发筹备

反对的设施

SDK 集成开发

常见问题