语音合成 java_语音合成 JAVA SDK
語音合成 Java SDK
一、SDK描述
京東AI為滿足TTS相關產品的快速接入,在REST API的基礎上對各種平臺和語言進行封裝,大大降低客戶接入的難度。現已發布的平臺及語言有:C/C++,Java,Android,IOS,Python, H5等,已適用于大部分的應用場景。并成功應用于虛擬主播,智能客服,智能外呼,讀書,新聞讀報,引導機器人,智能音箱等各領域的應用場景。
用戶通過SDK創建TTSEngine對象,設置用戶需要的參數,把文本數據通過speak和synthesize方法,交給實例化的ttsEngine對象,即可通過注冊的Listener對象,獲取生成的語音數據和系統的各種狀態,大大降低了AI功能接入的難度。
本文檔只提供Java 版本中的在線語音合成功能
1.1. 功能描述
當前主要支持的功能:
基本功能: 語音數據合成功能。
1.2. 鑒權說明
平臺為每個API提供試用體驗服務,您在AI市場選擇“免費試用”規格下單后,即可開始體驗業內領先的人工智能API服務。 免費試用服務具有調用量、QPS限制,如需更高性能的API服務,可以提交咨詢工單,聯系京東AI擴容購買。
該SDK封裝TTS API的功能,需要先參考 接入流程 獲取AppKey和SecretKey,并在調用SDK時作為參數傳入。
1.3. 支持的系統
通用Java平臺系統
二、使用說明
2.1. 下載地址
TTS_SDK_JAVA.zip(5980552a7822a9df8bf1e67657661192)
三、接口說明
3.2 TTSParam 參數封裝
setOpts()
函數定義:
setOpts(String key, String val)
功能:
設置TTS系統參數值。
參數說明:
key:參數名稱
val:參數值
用例:
TTSParam ttsParam = new TTSParam();
ttsParam.setOpts("serverURL", "https://aiapi.jd.com/jdai/tts"); //接口地址(注意每個API接口地址不同,詳見購買的API接口文檔)
ttsParam.setOpts("appKey", "XXXXXX");
ttsParam.setOpts("appSecret", "XXXXXXX");
ttsParam.setOpts("CustomerType", "0"); //固定值,Neuhub平臺
ttsParam.setOpts("tte", "1"); // 1:UTF-8 (目前僅支持UTF-8格式)
ttsParam.setOpts("aue", "1"); // 0:wav 1:pcm 2:opus 3:mp3
ttsParam.setOpts("tim", "0"); // 0:女聲 1:男聲 (注意每個API的音色參數不同,詳見購買的API接口文檔)
ttsParam.setOpts("vol", "2.0"); // 音量[0.1, 10.0]
ttsParam.setOpts("sp", "1.0"); // 語速 [0.5, 2.0]
ttsParam.setOpts("sr", "24000"); // 采樣率 wav和pcm支持4k到24k的采樣率 opus支持8k 12k 16k 和24k的采樣率
ttsParam.setOpts("streamMode", "1"); // 1 流式模式, 0 非流式模式
ttsParam.setOpts("tt", "0"); // 文本格式, 0:文本 1:SSML
ttsEngine.setParam(ttsParam);
String txt = "我是京東小精靈";
System.out.println("start synthesize ....");
ttsEngine.synthesize(txt, listener);
System.out.println("synthesize end");
getOpts()
函數定義:
getOpts(String key)
功能:
獲取系統參數值
參數:
key:參數名稱
用例:
String readTimeout = ttsParam.getOpts("readTimeout")
toString()
功能:
輸出系統的參數
用例:
String paramInfo = ttsParam.toString()
3.3 TTSEngineListener SDK事件監聽類
onRecvData(byte[] data, int index);
功能:
合成數據的回調函數
參數:
data:合成的數據
index:數據返回的index值, 當index由正數變為負數時, 合成數據結束
onError()
函數定義:
onError(int err)
功能:
系統異常回調
參數:
err :錯誤碼
3.4 TTSEngine 引擎類
TTSEngine()
函數定義:
TTSEngine()
功能:
創建tts engine對象
用例:
TTSEngine ttsEngine = new TTSEngine()
setParam()
函數定義:
setParam(TTSParam param)
功能:
設置參數。
參數:
param:TTSEngine 參數對象
用例:
ttsEngine.setParam(ttsParam)
synthesize()
函數定義:
synthesize(String txt, TTSEngineListener listener)
功能:
TTS 合成音頻功能。
參數:
txt:文本輸入。
listener:監聽函數。
用例:
String txt = "我是京東小精靈";
ttsEngine.synthesize(txt, listener);
五、錯誤碼
此處錯誤碼只包含的SDK,只處理SDK處理的錯誤,API的錯誤通過onError函數直接透傳。
Name
Value
Description
OK_NO
0
Success
ERR_RESOURCE_NO
-100
Loading error
ERR_PLAYER_NO
-101
audio player error
ERR_TEXTEMPTY_NO
-102
Text is empty
ERR_TEXTTOOLONG_NO
-103
Text is too long
ERR_SYNTHESIZE_NO
-104
Synthesize error
ERR_INITTTSENGINE_NO
-105
Init TTS engine error
ERR_BATCHEMPTY_NO
-106
Batch speak empty
ERR_BATCHTOOLONG_NO
-107
Batch speak too long
ERR_PLAYERNULL_NO
-108
Audio player is null
ERR_PLAYERCLOSE_NO
-108
Audio player release failed
ERR_TTSENGINECLOSE_NO
-110
TTS engine release failed
ERR_NOT_SUPPORT
-111
TTS engine not support
ERR_SRV_Error
-112
TTS Srv status
ERR_NOT_AUTH
-113
TTS Not Auth
ERR_NO_Data_Recv
-114
Recv Data len = 0
ERR_PARAM_NO_SUPPORT
-115
Param Not Support
ERR_SRV_Exception
-116
Http Srv Exception
ERR_AUTH_OK
-117
TTS Auth OK
ERR_AUTH_Err
-118
TTS Auth Err
ERR_UNKNOWN_NO
-999
Unknown error
六、Demo示例
static boolean isSynthesizeStart = true;
static boolean isFileStart = true;
final boolean isEnd = false;
static int errno = -1;
public static void main( String[] args )
{
System.out.println( "Hello World!" );
System.out.println("Hello JD TTS ");
final Base64.Encoder encoder = Base64.getEncoder();
TTSEngine ttsEngine = new TTSEngine();
TTSParam ttsParam = new TTSParam();
TTSEngineListener listener = new TTSEngineListener() {
public int onRecvData(byte[] audioBin, int index) {
if(errno < 0) {
System.out.println("errno=" + errno);
return -1;
}
System.out.println("onRecvData :index=" + index + ", onRecvData=" + encoder.encodeToString(audioBin));
if (index > 0) { // 沒有結束
FileUtil.WriteBuf(audioBin, isFileStart, false);
} else {
FileUtil.WriteBuf(audioBin, isFileStart, true);
}
isFileStart = false;
return 0;
}
public void onError(int err) {
//System.out.println("onError");
errno = err;
return ;
}
};
//server
ttsParam.setOpts("serverURL", "https://aiapi.jd.com/jdai/tts"); //接口地址(注意每個API接口地址不同,詳見購買的API接口文檔)
ttsParam.setOpts("appKey", "XXXXXX");
ttsParam.setOpts("appSecret", "XXXXXXX");
ttsParam.setOpts("CustomerType", "0"); //固定值,Neuhub平臺
//param
ttsParam.setOpts("tte", "1"); // 1:UTF-8 (目前僅支持UTF-8格式)
ttsParam.setOpts("aue", "3"); // 0:wav 1:pcm 2:opus 3:mp3
ttsParam.setOpts("tim", "0"); // 0:女聲 1:男聲(注意每個API的音色參數不同,詳見購買的API接口文檔)
ttsParam.setOpts("vol", "2.0"); // 音量[0.1, 10.0]
ttsParam.setOpts("sp", "1.0"); // 語速 [0.5, 2.0]
ttsParam.setOpts("sr", "24000"); // 采樣率 wav和pcm支持4k到24k的采樣率 opus支持8k 12k 16k 和24k的采樣率
ttsParam.setOpts("streamMode", "1"); // 1 流式模式, 0 非流式模式
ttsParam.setOpts("tt", "0"); // 文本格式, 0:文本 1:SSML
ttsEngine.setParam(ttsParam);
String txt = "我是京東小精靈";
System.out.println("start synthesize ....");
ttsEngine.synthesize(txt, listener);
System.out.println("synthesize end");
}Copyright ? JD AI Platform all right reserved,powered by GitbookFile Modify:
2021-01-28 07:06:14
總結
以上是生活随笔為你收集整理的语音合成 java_语音合成 JAVA SDK的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 数据挖掘算法之-关联规则挖掘(Assoc
- 下一篇: 求HCNP实验指南