【摘要】 基于 CodeArts API 設(shè)計(jì)語音合成接口，基于 API Explorer 調(diào)試接口，并利用 CodeArts IDE 實(shí)現(xiàn)數(shù)據(jù)流轉(zhuǎn)換為音頻

案例簡介

開發(fā)者將在云主機(jī)中，基于 CodeArts API 設(shè)計(jì)語音合成接口，基于 API Explorer 調(diào)試接口，并利用 CodeArts IDE 實(shí)現(xiàn)數(shù)據(jù)流轉(zhuǎn)換為音頻。在此過程中，開發(fā)者可體驗(yàn) API 設(shè)計(jì)、開發(fā)、調(diào)試等全生命周期，對(duì)華為云產(chǎn)品 API 體系及 API 開放能力有全面了解，并最終完成應(yīng)用創(chuàng)建，全程實(shí)踐約 15 分鐘。

配置開發(fā)者空間

華為云為全球開發(fā)者打造專屬開發(fā)者空間，匯聚了華為優(yōu)質(zhì)開發(fā)資源及工具，讓每一位開發(fā)者擁有一臺(tái)云主機(jī)。

在華為開發(fā)者空間，每位開發(fā)者每年可享有數(shù)百小時(shí)的云主機(jī)使用時(shí)長，5GB 的云存儲(chǔ)空間和場(chǎng)景化沙箱資源，以及海量的技術(shù)賦能課程與專業(yè)開發(fā)者認(rèn)證內(nèi)容。

點(diǎn)此領(lǐng)?。篽ttps://auth.huaweicloud.com/authui/login.html?service=https%3A%2F%2Fdeveloper.huaweicloud.com%2Fspace%2Flogin-forword.html%3FforwardUrl%3Dhttps%253A%252F%252Fdeveloper.huaweicloud.com%252Fspace%252Fhome%26module%3Dhuaweideveloper&locale=zh-cn#/login

1.進(jìn)入開發(fā)者空間，點(diǎn)擊“云主機(jī)（beta 體驗(yàn)）”

2.點(diǎn)擊“添加云主機(jī)”

3.點(diǎn)擊“立即進(jìn)入”

4.點(diǎn)擊“下一步”

5.繼續(xù)點(diǎn)擊“下一步”

6.點(diǎn)擊“進(jìn)入桌面”

7.等待機(jī)器準(zhǔn)備進(jìn)度條加載完成至 100%，預(yù)計(jì)等待 1 分鐘，然后點(diǎn)擊“打開云桌面”即可使用

通過 CodeArts API 設(shè)計(jì)語音合成接口

3.1 進(jìn)入 CodeArts API 官網(wǎng)，打開左邊工具欄-Firefox 網(wǎng)絡(luò)瀏覽器，輸入網(wǎng)頁版體驗(yàn)地址并登錄

https://developer.huaweicloud.com/develop/codeartsapi.html

3.2 創(chuàng)建項(xiàng)目

3.2.1 登錄后點(diǎn)擊頁面右上角的“創(chuàng)建項(xiàng)目”按鈕

3.2.2 在創(chuàng)建項(xiàng)目彈窗中輸入項(xiàng)目名稱：語音合成，并點(diǎn)擊保存

3.2.3 提示保存成功，點(diǎn)擊 API 設(shè)計(jì)頁簽，進(jìn)入到 API 設(shè)計(jì)頁面

3.3 設(shè)計(jì)接口

3.3.1 點(diǎn)擊頁面上的“新建 API 接口”卡片

3.3.2 顯示新建標(biāo)簽頁

3.3.3輸入接口的 URL：/tts

3.3.4輸入接口名稱：語音合成

3.3.5下拉滾動(dòng)條到請(qǐng)求參數(shù)區(qū)域，點(diǎn)擊請(qǐng)求體“Body”頁簽，選擇“raw”，默認(rèn)選擇“JSON”格式。

3.3.6顯示請(qǐng)求體的數(shù)據(jù)結(jié)構(gòu)模板，默認(rèn)根節(jié)點(diǎn)類型為“object”

3.3.7點(diǎn)擊根節(jié)點(diǎn)最右側(cè)的“+”操作

3.3.8頁面上在根節(jié)點(diǎn)下新增一條參數(shù)（可以通過滾動(dòng)條左右拖動(dòng)）

3.3.9將參數(shù)名 param2 修改為 text，描述 param2 修改為待合成的文本

3.3.10 下拉頁面，看到返回響應(yīng)區(qū)域

3.3.11 同樣點(diǎn)擊根節(jié)點(diǎn)最右側(cè)的“+”操作（可以通過滾動(dòng)條拖動(dòng)到最右側(cè)），在根節(jié)點(diǎn)下顯示一條新的參數(shù)

3.3.12 將參數(shù)名 param2 修改為result，將描述修改為合成結(jié)果

3.3.13 點(diǎn)擊右上角的保存按鈕

3.3.14 保存成功，設(shè)計(jì)完成

通過 API Explorer 調(diào)試語音合成接口，生成 5 段數(shù)據(jù)流

4.1 語音合成（API Explorer 部分）：

鏈接：https://console.huaweicloud.com/apiexplorer/#/openapi/SIS/debug?api=RunTts

4.1.1 生成語音格式為 wav，采樣率：8000，標(biāo)準(zhǔn)女音，語速 0，音色 0

圖 1.1.1wav 標(biāo)準(zhǔn)女音

4.1.2 生成語音格式為 wav，采樣率：16000，標(biāo)準(zhǔn)男聲，語速 0，音色 0

圖 1..12wav 標(biāo)準(zhǔn)男音

4.1.3 生成語音格式為 mp3，采樣率：8000，標(biāo)準(zhǔn)女音，語速 100，音色 100

圖 1.1.3 mp3 標(biāo)準(zhǔn)女音

4.1.4 生成語音格式為 mp3，采樣率：16000，標(biāo)準(zhǔn)男聲，語速 100，音色 100

圖 1.1.4 mp3 標(biāo)準(zhǔn)男聲

4.1.5 生成語音格式為 pcm，采樣率：16000，標(biāo)準(zhǔn)男聲，語速 100，音色 100

圖 1.1.5標(biāo)準(zhǔn)男聲

在開發(fā)者空間基于華為云自研 CodeArts IDE，實(shí)現(xiàn)數(shù)據(jù)流轉(zhuǎn)換為音頻的功能

5.1 實(shí)現(xiàn)數(shù)據(jù)流轉(zhuǎn)換為音頻

5.1.1 將實(shí)驗(yàn)用 Demo 工程上傳到 CodeArts IDE

打開右側(cè)工具欄-Firefox 網(wǎng)絡(luò)瀏覽器，輸入并訪問 Demo 工程下載鏈接：

https://sandbox-expriment-files.obs.cn-north-1.myhuaweicloud.com/2601/CodeArtsProject.zip

對(duì)下載好的文件進(jìn)行解壓（目錄：主文件夾/下載），右鍵提取到此處

打開 CodeArts IDE，左上角點(diǎn)擊“工程”->“打開工程”，選擇剛剛解壓出來的文件夾，打開：

預(yù)計(jì)等待 1 分鐘左右的時(shí)間，工程模型同步成功：

5.1.2 在華為云控制臺(tái)新增訪問秘鑰，配置 AK/SK

1）登錄華為云控制臺(tái)：https://console.huaweicloud.com/iam/?agencyId=599e2ee1492f48e9b69a0a682d435fb8?ion=cn-north-4&locale=zh-cn#/mine/accessKey

選擇“我的憑證”->“訪問秘鑰”->新增訪問秘鑰

注：如果已經(jīng)有 AK/SK 秘鑰，不需要新增訪問秘鑰

創(chuàng)建秘鑰成功后點(diǎn)擊“立即下載”，即可獲得“credentials.csv”文件，里面可以查看到 AK（Access Key Id）和 SK（Secret Access Key）

2）進(jìn)入工程，src/main/resources 下選擇 credentials.properties，將 AK/SK 配置上

5.1.3 將 API Explorer 上調(diào)試成功的流數(shù)據(jù)文件配置到 APIResponse.json 中

在 2.1 語音合成章節(jié)，我們?cè)?API Explorer 完成接口的調(diào)試

https://console.huaweicloud.com/apiexplorer/#/openapi/SIS/debug?api=RunTts

最終生成“SIS_RunTts_ResponseBody_xxxxxxxxxxxxx.json”文件，打開 json 文件，復(fù)制響應(yīng)體內(nèi)容（如果響應(yīng)體內(nèi)容沒有超出限制，直接點(diǎn)擊右側(cè)的復(fù)制按鈕即可）

打開工程，進(jìn)入 src/main/resources 中，選擇 APIResponse.json，將 json 文件的內(nèi)容復(fù)制到 APIResponse.json 中。

5.1.4 配置 pom.xml：

在 pom.xml 中如圖所示，增加如下配置：

17

17

17

5.1.5 執(zhí)行“should_return_audio_when_response_json”，生成 mps 格式音頻文件：

找到 test 目錄下的測(cè)試類 SisServiceTest.java，點(diǎn)擊找到方法“should_return_audio_when_response_json（）”，點(diǎn)擊執(zhí)行測(cè)試，最后可以看到目錄下生成的音頻文件。

目錄下生成“devkit.mps”文件，實(shí)驗(yàn)結(jié)束。

審核編輯 黃宇