音頻編輯服務UI SDK接入指導及常見問題

来源:https://www.cnblogs.com/hmscore/archive/2023/01/31/17078831.html
-Advertisement-
Play Games

華為 HMS Core 音頻編輯服務(Audio Editor Kit)是華為幫助全球開發者快速構建各類應用音頻能力的服務,匯聚了華為在音樂、語音等相關音頻領域的先進技術。音頻編輯服務為開發者們提供音頻基礎編輯、AI配音、音源分離、空間渲染、變聲、多種音效等豐富的音頻處理能力,以及性能優異、簡單易用 ...


華為 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_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<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 最新技術資訊~


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 本文介紹基於Python語言,按照一定命名規則批量修改多個文件的文件名的方法。 已知現有一個文件夾,其中包括班級所有同學上交的作業文件,每人一份;所有作業文件命名格式統一,都是地信1701_姓名_學習心得格式。 現需要對每一位同學的作業文件加以改名,有很多種需求。 第一種需求,將每一位同學作業文件名 ...
  • Python 是一種代表簡單思想的語言,其語法相對簡單,很容易上手。不過,如果就此小視 Python 語法的精妙和深邃,那就大錯特錯了。本文精心篩選了最能展現 Python 語法之精妙的十個知識點,並附上詳細的實例代碼。如能在實戰中融會貫通、靈活使用,必將使代碼更為精煉、高效,同時也會極大提升代碼B ...
  • 前言 相信大家看過不少講C# async await的文章,博客園就能搜到很多,但還是有很多C#程式員不明白。 如果搞不明白,其實也不影響使用。但有人就會疑惑,為什麼要用非同步?我感覺它更慢了,跟同步有啥區別? 有的人研究深入,比如去研究狀態機,可能會明白其中的原理。但深入研究的畢竟少數。有的人寫一些 ...
  • 由於一些客戶的內部系統需要提取一些記錄信息,如果手工錄入會變得比較麻煩,因此考慮使用百度雲的OCR進行圖片文字的提取處理,綜合比較了一下開源免費的Tesseract 類庫進行處理,不過識別效果不太理想,因此轉為了百度的OCR雲介面處理方式,測試的效果比較理想,基本上較少出現錯別字。本篇隨筆介紹如何利... ...
  • 1.背景知識 CRLF用來表示文本換行的方式 ,CR是回車的意思,對應 \r ;LF 是換行的意思,對應 \n Windows 換行符是 \r\n Unix 換行是 \n 如果一個將要在Linux伺服器上使用的文件,比如某個配置文件,在windows電腦打開,編輯過,那麼文件每一行末尾會多有\r 。 ...
  • MySQL中既存在redo log,又存在bin log,這是因為bin log是MySQL Server提供的一種歸檔日誌,其本身並不具備crash-safe能力。而redo log本身不具備歸檔能力,他是一種迴圈寫的日誌。 MySQL通過將這兩種日誌整合起來,並通過兩階段提交的機制,保證了數據... ...
  • 一:背景 1. 講故事 相信絕大部分用 SQLSERVER 作為底層存儲的程式員都知道 nolock 關鍵詞,即使當時不知道也會在踩過若幹阻塞坑之後果斷的加上 nolock,但這玩意有什麼註意事項呢?這就需要瞭解它的底層原理了。 二:nolock 的原理 1. sql 阻塞還原 為了方便講述,先創建 ...
  • Redis 每秒可以處理超過 10 萬次讀寫操作,是已知性能最快的 key-value 資料庫,稱得上是必須要學會的知識。 ...
一周排行
    -Advertisement-
    Play Games
  • Timer是什麼 Timer 是一種用於創建定期粒度行為的機制。 與標準的 .NET System.Threading.Timer 類相似,Orleans 的 Timer 允許在一段時間後執行特定的操作,或者在特定的時間間隔內重覆執行操作。 它在分散式系統中具有重要作用,特別是在處理需要周期性執行的 ...
  • 前言 相信很多做WPF開發的小伙伴都遇到過表格類的需求,雖然現有的Grid控制項也能實現,但是使用起來的體驗感並不好,比如要實現一個Excel中的表格效果,估計你能想到的第一個方法就是套Border控制項,用這種方法你需要控制每個Border的邊框,並且在一堆Bordr中找到Grid.Row,Grid. ...
  • .NET C#程式啟動閃退,目錄導致的問題 這是第2次踩這個坑了,很小的編程細節,容易忽略,所以寫個博客,分享給大家。 1.第一次坑:是windows 系統把程式運行成服務,找不到配置文件,原因是以服務運行它的工作目錄是在C:\Windows\System32 2.本次坑:WPF桌面程式通過註冊表設 ...
  • 在分散式系統中,數據的持久化是至關重要的一環。 Orleans 7 引入了強大的持久化功能,使得在分散式環境下管理數據變得更加輕鬆和可靠。 本文將介紹什麼是 Orleans 7 的持久化,如何設置它以及相應的代碼示例。 什麼是 Orleans 7 的持久化? Orleans 7 的持久化是指將 Or ...
  • 前言 .NET Feature Management 是一個用於管理應用程式功能的庫,它可以幫助開發人員在應用程式中輕鬆地添加、移除和管理功能。使用 Feature Management,開發人員可以根據不同用戶、環境或其他條件來動態地控制應用程式中的功能。這使得開發人員可以更靈活地管理應用程式的功 ...
  • 在 WPF 應用程式中,拖放操作是實現用戶交互的重要組成部分。通過拖放操作,用戶可以輕鬆地將數據從一個位置移動到另一個位置,或者將控制項從一個容器移動到另一個容器。然而,WPF 中預設的拖放操作可能並不是那麼好用。為瞭解決這個問題,我們可以自定義一個 Panel 來實現更簡單的拖拽操作。 自定義 Pa ...
  • 在實際使用中,由於涉及到不同編程語言之間互相調用,導致C++ 中的OpenCV與C#中的OpenCvSharp 圖像數據在不同編程語言之間難以有效傳遞。在本文中我們將結合OpenCvSharp源碼實現原理,探究兩種數據之間的通信方式。 ...
  • 一、前言 這是一篇搭建許可權管理系統的系列文章。 隨著網路的發展,信息安全對應任何企業來說都越發的重要,而本系列文章將和大家一起一步一步搭建一個全新的許可權管理系統。 說明:由於搭建一個全新的項目過於繁瑣,所有作者將挑選核心代碼和核心思路進行分享。 二、技術選擇 三、開始設計 1、自主搭建vue前端和. ...
  • Csharper中的表達式樹 這節課來瞭解一下表示式樹是什麼? 在C#中,表達式樹是一種數據結構,它可以表示一些代碼塊,如Lambda表達式或查詢表達式。表達式樹使你能夠查看和操作數據,就像你可以查看和操作代碼一樣。它們通常用於創建動態查詢和解析表達式。 一、認識表達式樹 為什麼要這樣說?它和委托有 ...
  • 在使用Django等框架來操作MySQL時,實際上底層還是通過Python來操作的,首先需要安裝一個驅動程式,在Python3中,驅動程式有多種選擇,比如有pymysql以及mysqlclient等。使用pip命令安裝mysqlclient失敗應如何解決? 安裝的python版本說明 機器同時安裝了 ...