語音實時合成服務在輸出音頻流的同時，可輸出每個漢字/英文單詞在音頻中的時間位置，即時間戳，時間戳功能又叫字級別音素邊界接口。該時間信息可用于驅動虛擬人口型、做視頻配音字幕等。
只有支持字級別音素邊界接口的發音人才有此功能。
由于HTTP協議傳輸方式的限制，短文本語音合成RESTful API不支持返回時間戳信息。
TTS服務返回的字幕是基于發音的，所以不能直接用于上屏，需要使用您的原始文本。
如果用于上屏，可以基于返回的結果，定位每個句子的句首和句尾時間戳。
參數設置
在客戶端設置請求參數enable_subtitle為true，開啟時間戳功能。
以Java SDK為例，其設置?式如下。
// 是否開啟字幕功能（返回對應文本的相應時間戳），默認不開啟。
synthesizer.addCustomedParam("enable_subtitle", true);服務端響應
服務端返回的帶字幕信息的響應MetaInfo事件。
參數 | 類型 | 說明 |
subtitles | List | 時間戳信息。 |
其中，SubtitleItem格式如下。
參數 | 類型 | 說明 |
text | String | ?本信息。 |
begin_time | Integer | ?本對應tts語?開始時間戳，單位ms。 |
end_time | Integer | ?本對應tts語?結束時間戳，單位ms。 |
phoneme | String | 不支持打印該字對應的phone系列，默認輸出為 |
begin_index | Integer | 該字在整句中的開始位置，從0開始。 |
end_index | Integer | 該字在整句中的結束位置，從0開始。 |
返回示例
{
"header": {
"message_id": "05450bf69c53413f8d88aed1ee60****",
"task_id": "640bc797bb684bd6960185651307****",
"namespace": "SpeechSynthesizer",
"name": "MetaInfo",
"status": 20000000,
"status_message": "GATEWAY|SUCCESS|Success."
},
"payload": {
"subtitles": [
{
"begin_index": 0,
"phoneme": "null",
"end_time": 180,
"end_index": 1,
"begin_time": 0,
"text": "你"
},
{
"begin_index": 1,
"phoneme": "null",
"end_time": 299,
"end_index": 2,
"begin_time": 180,
"text": "好"
}
]
}
}音素級別時間戳
參數設置
在客戶端設置請求參數enable_subtitle為true，enable_phoneme_timestamp為true，開啟音素級別時間戳功能。
移動端暫不支持音素級別時間戳。
以Java SDK為例，其設置?式如下：
// 是否開啟字幕功能（返回對應文本的相應時間戳），默認不開啟。
synthesizer.addCustomedParam("enable_subtitle", true);
synthesizer.addCustomedParam("enable_phoneme_timestamp", true);服務端響應
服務端返回的帶字幕信息的響應MetaInfo事件。
參數 | 類型 | 說明 |
subtitles | List | 時間戳信息。 |
其中，SubtitleItem格式如下表所示：
參數 | 類型 | 說明 |
text | String | ?本信息。 |
begin_time | Integer | ?本對應tts語?開始時間戳，單位ms。 |
end_time | Integer | ?本對應tts語?結束時間戳，單位ms。 |
phoneme | String | 打印該字對應的phone系列，默認輸出為 |
begin_index | Integer | 該字在整句中的開始位置，從0開始。 |
end_index | Integer | 該字在整句中的結束位置，從0開始。 |
phoneme_list | List | 音素時間戳數組。 |
phoneme_list格式如下表所示：
參數 | 類型 | 說明 |
index | Integer | 音素字內序號，從0開始。 |
begin_time | Integer | 起始時間，單位為毫秒。 |
end_time | Integer | 結束時間，單位為毫秒。 |
phoneme | String | 音素名，詳情請參見音素與拼音，國際音標間關系。 |
tone | Integer | 音調。英文中0/1/2分表代表輕音，重音，次重音。拼音中1/2/3/4/5分別代表一聲，二聲，三聲，四聲，輕聲。 |
subtitles示例
//今天
{
"subtitles":[
{"begin_index":0,"begin_time":0,"end_index":1,"end_time":100,
"phoneme_list":[
{"index":0, "begin_time":0, "end_time": 20, "phoneme":"hh", "tone":0},
{"index":1, "begin_time":20, "end_time": 40, "phoneme":"ah", "tone":0},
{"index":1, "begin_time":40, "end_time": 60, "phoneme":"l", "tone":1},
{"index":1, "begin_time":60, "end_time": 100, "phoneme":"ow", "tone":1}
],
"text":"hello", "phoneme":"hh ah l ow"},
{"begin_index":1,"begin_time":100,"end_index":2,"end_time":200,
"phoneme_list":[
{"index":0, "begin_time":100, "end_time": 150, "phoneme":"j_c", "tone":1},
{"index":1, "begin_time":150, "end_time": 200, "phoneme":"in_c", "tone":1}
],
"text":"今", "phoneme":"j_c in_c"},
{"begin_index":1,"begin_time":200,"end_index":2,"end_time":400,
"phoneme_list":[
{"index":0, "begin_time":200, "end_time": 300, "phoneme":"t_c", "tone":1},
{"index":1, "begin_time":300, "end_time": 400, "phoneme":"ian_c", "tone":1}
],"text":"天", "phoneme":"t_c ian_c"}
]
}音素與拼音、國際音標間關系
對于拼音，以<拼音>_c的方式給出音素，比如天的拼音是t和ian，給出的音素為t_c和ian_c。
對于英文，詳情請參見下表，其中如果音素形式為<音素><數字>，數字為0/1/2的話，意思是音素和tone的組合。例如，對于ah這個音素，ah1代表ah重音的情況，ah0代表ah輕音的情況。
英文音素與國際音標（IPA）映射關系表
美式英文
序號
美式英文音素
國際音標（IPA）
1
aa
ɑ
2
ae
?
3
ah1
?
4
ah2
?
5
ah0
?
6
ao
?
7
aw
a?
8
ay
a?
9
b
b
10
ch
t?
11
d
d
12
dh
e
13
eh
?
14
er
?
15
ey
e?
16
f
f
17
g
g
18
hh
h
19
ih
?
20
iy
i
21
jh
d?
22
k
k
23
l
l
24
m
m
25
n
n
26
ng
?
27
ow
o?
28
oy
??
29
p
p
30
r
?
31
s
s
32
sh
?
33
t
t
34
th
θ
35
uh
?
36
uw
u
37
v
v
38
w
w
39
y
j
40
z
z
41
zh
?
英式英文
序號
英式英文音素
國際音標（IPA）
1
@
?
2
@@
??
3
a
?
4
aa
ɑ?
5
e
?
6
i
?
7
ii
i?
8
o
?
9
oo
??
10
u
?
11
uh
?
12
uu
u?
13
ai
a?
14
au
a?
15
e@
??
16
ei
e?
17
i@
??
18
oi
??
19
ou
??
20
u@
??
21
p
p
22
b
b
23
t
t
24
d
d
25
k
k
26
g
g
27
ch
t?
28
jh
d?
29
s
s
30
z
z
31
v
v
32
f
f
33
sh
?
34
th
θ
35
dh
e
36
zh
?
37
h
h
38
r
?
39
l
l
40
m
m
41
n
n
42
ng
?
43
y
j
44
w
w
字級別時間戳代碼示例
示例中使用SDK內置的默認語音合成服務的外網訪問服務URL，如果您使用位于阿里云上海地域的ECS，且需要通過內網訪問服務URL，則在創建NlsClient對象時，設置內網訪問的URL：
client = new NlsClient("ws://nls-gateway.cn-shanghai-internal.aliyuncs.com/ws/v1", accessToken);示例中將合成的音頻保存在文件中，如果您需要播放音頻且對實時性要求較高，建議使用流式播放，即邊接收語音數據邊播放，減少延時。
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.nio.ByteBuffer;
import java.util.List;
import java.util.Map;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.nls.client.protocol.NlsClient;
import com.alibaba.nls.client.protocol.OutputFormatEnum;
import com.alibaba.nls.client.protocol.SampleRateEnum;
import com.alibaba.nls.client.protocol.tts.SpeechSynthesizer;
import com.alibaba.nls.client.protocol.tts.SpeechSynthesizerListener;
import com.alibaba.nls.client.protocol.tts.SpeechSynthesizerResponse;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* 此示例演示了：
* 語音合成API調用。
* 動態獲取token。
* 流式合成TTS。
* 首包延遲計算。
* 字級別時間戳返回。
*/
public class SpeechSynthesizerDemo {
private static final Logger logger = LoggerFactory.getLogger(SpeechSynthesizerDemo.class);
private static long startTime;
private String appKey;
NlsClient client;
public SpeechSynthesizerDemo(String appKey, String token) {
this.appKey = appKey;
//應用全局創建一個NlsClient實例，默認服務地址為阿里云線上服務地址。
try {
client = new NlsClient(token);
} catch (IOException e) {
e.printStackTrace();
}
}
public SpeechSynthesizerDemo(String appKey, String token, String url) {
this.appKey = appKey;
try {
if(url.isEmpty()) {
client = new NlsClient(token);
}else {
client = new NlsClient(url, token);
}
} catch (IOException e) {
e.printStackTrace();
}
}
private static SpeechSynthesizerListener getSynthesizerListener() {
SpeechSynthesizerListener listener = null;
try {
listener = new SpeechSynthesizerListener() {
File f=new File("tts_test.wav");
FileOutputStream fout = new FileOutputStream(f);
private boolean firstRecvBinary = true;
//語音合成結束
@Override
public void onComplete(SpeechSynthesizerResponse response) {
//調用onComplete時表示所有TTS數據已接收完成，因此為整個合成數據的延遲。該延遲可能較大，不一定滿足實時場景。
System.out.println("name: " + response.getName() +
", task_id: " + response.getTaskId() +
", status: " + response.getStatus()+
", output file :"+f.getAbsolutePath()
);
}
//語音合成的語音二進制數據
@Override
public void onMessage(ByteBuffer message) {
try {
if(firstRecvBinary) {
//計算首包語音流的延遲，收到第一包語音流時，即可以進行語音播放，以提升響應速度（特別是實時交互場景下）。
firstRecvBinary = false;
long now = System.currentTimeMillis();
logger.info("tts first latency : " + (now - SpeechSynthesizerDemo.startTime) + " ms");
}
byte[] bytesArray = new byte[message.remaining()];
message.get(bytesArray, 0, bytesArray.length);
fout.write(bytesArray);
} catch (IOException e) {
e.printStackTrace();
}
}
@Override
public void onMetaInfo(SpeechSynthesizerResponse response) {
// 調用onMetaInfo時表示返回字級別時間戳
System.out.println("name: " + response.getName() + ", task_id: " + response.getTaskId());
JSONArray subtitles = (JSONArray)response.getObject("subtitles");
List<Map> subtitleList = subtitles.toJavaList(Map.class);
for (Map word : subtitleList) {
System.out.println("current subtitle: " + word);
}
}
@Override
public void onFail(SpeechSynthesizerResponse response){
//task_id是調用方和服務端通信的唯一標識，當遇到問題時需要提供task_id以便排查。
System.out.println(
"task_id: " + response.getTaskId() +
//狀態碼 20000000 表示識別成功
", status: " + response.getStatus() +
//錯誤信息
", status_text: " + response.getStatusText());
}
};
} catch (Exception e) {
e.printStackTrace();
}
return listener;
}
public void process() {
SpeechSynthesizer synthesizer = null;
try {
//創建實例，建立連接。
synthesizer = new SpeechSynthesizer(client, getSynthesizerListener());
synthesizer.setAppKey(appKey);
//設置返回音頻的編碼格式
synthesizer.setFormat(OutputFormatEnum.WAV);
//設置返回音頻的采樣率
synthesizer.setSampleRate(SampleRateEnum.SAMPLE_RATE_16K);
//發音人
synthesizer.setVoice("siyue");
//語調，范圍是-500~500，可選，默認是0。
synthesizer.setPitchRate(100);
//語速，范圍是-500~500，默認是0。
synthesizer.setSpeechRate(100);
//設置用于語音合成的文本
synthesizer.setText("歡迎使用阿里巴巴智能語音合成服務，您可以說北京明天天氣怎么樣啊");
// 是否開啟字幕功能（返回相應文本的時間戳），默認不開啟，需要注意并非所有發音人都支持該參數。
synthesizer.addCustomedParam("enable_subtitle", true);
//此方法將以上參數設置序列化為JSON格式發送給服務端，并等待服務端確認。
long start = System.currentTimeMillis();
synthesizer.start();
logger.info("tts start latency " + (System.currentTimeMillis() - start) + " ms");
SpeechSynthesizerDemo.startTime = System.currentTimeMillis();
//等待語音合成結束
synthesizer.waitForComplete();
logger.info("tts stop latency " + (System.currentTimeMillis() - start) + " ms");
} catch (Exception e) {
e.printStackTrace();
} finally {
//關閉連接
if (null != synthesizer) {
synthesizer.close();
}
}
}
public void shutdown() {
client.shutdown();
}
public static void main(String[] args) throws Exception {
String appKey = "您的Appkey";
String token = "您的Token";
String url = ""; //默認值：wss://nls-gateway.cn-shanghai.aliyuncs.com/ws/v1
if (args.length == 2) {
appKey = args[0];
token = args[1];
} else if (args.length == 3) {
appKey = args[0];
token = args[1];
url = args[3];
} else {
System.err.println("run error, need params(url is optional): " + "<app-key> <Token> [url]");
System.exit(-1);
}
SpeechSynthesizerDemo demo = new SpeechSynthesizerDemo(appKey, token, url);
demo.process();
demo.shutdown();
}
}