前提条件在使用SDK之前，请先阅读接口说明，详情请参见

为使用长文本语音合成服务，请将SDK版本更新至2.1.1及以上。

下载安装

依赖文件内容如下。

com.alibaba.nls

nls-sdk-tts

2.1.6

解压ZIP文件，在pom目录运行mvn package，会在target目录生成可执行JAR：nls-example-long-tts-2.0.0-jar-with-dependencies.jar，将此JAR包拷贝到目标服务器，用于快速验证及压测服务。

服务验证：

运行如下代码，并按提示提供相应参数。

运行后在命令执行目录生成logs/nls.log。java -cp nls-example-long-tts-2.0.0-jar-with-dependencies.jar com.alibaba.nls.client.SpeechSynthesizerDemo

服务压测：

运行如下代码，并按提示提供相应参数。

其中阿里云服务url参数为：wss://nls-gateway.cn-shanghai.aliyuncs.com/ws/v1，并发数根据您的购买情况进行选择。java -jar nls-example-long-tts-2.0.0-jar-with-dependencies.jar

说明

自行压测超过2路并发会产生费用。

关键接口NlsClient：语音处理客户端，利用该客户端可以进行一句话识别、实时语音识别和语音合成的语音处理任务。该客户端为线程安全，建议全局仅创建一个实例。

SpeechSynthesizer：语音合成处理类，设置请求参数，发送请求。非线程安全。

SpeechSynthesizerListener：语音合成监听类，监听返回结果。非线程安全。需要实现如下两个抽象方法：

/**

* 接收语音合成二进制数据

*/

abstract public void onMessage(ByteBuffer message);

/**

* 语音合成结束事件通知

*/

abstract public void onComplete(SpeechSynthesizerResponse response);

说明

SDK调用注意事项：NlsClient使用Netty框架，NlsClient对象的创建会消耗一定时间和资源，一经创建可以重复使用。建议调用程序将NlsClient的创建和关闭与程序本身的生命周期相结合。

SpeechSynthesizer对象不可重复使用，一个语音合成任务对应一个SpeechSynthesizer对象。例如，N个文本要进行N次语音合成任务，创建N个SpeechSynthesizer对象。

SpeechSynthesizerListener对象和SpeechSynthesizer对象是一一对应的，不能将一个SpeechSynthesizerListener对象设置到多个SpeechSynthesizer对象中，否则不能将各语音合成任务区分开。

Java SDK依赖Netty网络库，如果您的应用依赖Netty，其版本需更新至4.1.17.Final及以上。

代码示例

说明

示例中使用SDK内置的默认语音合成服务的外网访问服务URL，如果您使用阿里云上海ECS，且需要通过内网访问服务URL，则在创建NlsClient对象时，设置内网访问的URL：client = new NlsClient("ws://nls-gateway.cn-shanghai-internal.aliyuncs.com/ws/v1", accessToken);

示例中将合成的音频保存在文件中，如果您需要播放音频且对实时性要求较高，建议使用流式播放，即边接收语音数据边播放，减少延时。package com.alibaba.nls.client;

import java.io.File;

import java.io.FileOutputStream;

import java.io.IOException;

import java.nio.ByteBuffer;

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调用(setLongText)。

* 流式合成TTS。

* 首包延迟计算。

*

* 说明：该示例和nls-example-tts下的SpeechSynthesizerLongTextDemo不完全相同，长文本语音合成是单独的产品功能，是将一长串文本直接发送给服务端去合成，

* 而SpeechSynthesizerLongTextDemo演示的是将一长串文本在调用方处切割然后分段调用语音合成接口。

*/

public class SpeechLongSynthesizerDemo {

private static final Logger logger = LoggerFactory.getLogger(SpeechLongSynthesizerDemo.class);

private static long startTime;

private String appKey;

NlsClient client;

public SpeechLongSynthesizerDemo(String appKey, String token, String url) {

this.appKey = appKey;

//创建NlsClient实例应用全局创建一个即可。生命周期可和整个应用保持一致，默认服务地址为阿里云线上服务地址。

if(url.isEmpty()) {

client = new NlsClient(token);

} else {

client = new NlsClient(url, token);

}

}

private static SpeechSynthesizerListener getSynthesizerListener() {

SpeechSynthesizerListener listener = null;

try {

listener = new SpeechSynthesizerListener() {

File f=new File("ttsForLongText.wav");

FileOutputStream fout = new FileOutputStream(f);

private boolean firstRecvBinary = true;

//语音合成结束

@Override

public void onComplete(SpeechSynthesizerResponse response) {

// 调用onComplete时，表示所有TTS数据已经接收完成，因此为整个合成数据的延迟。该延迟可能较大，不一定满足实时场景。

System.out.println("name: " + response.getName() + ", 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 - SpeechLongSynthesizerDemo.startTime) + " ms");

}

byte[] bytesArray = new byte[message.remaining()];

message.get(bytesArray, 0, bytesArray.length);

//System.out.println("write array:" + bytesArray.length);

fout.write(bytesArray);

} catch (IOException e) {

e.printStackTrace();

}

}

@Override

public void onFail(SpeechSynthesizerResponse response){

// task_id是调用方和服务端通信的唯一标识，当遇到问题时，需要提供此task_id以便排查。

System.out.println(

"task_id: " + response.getTaskId() +

//状态码

", status: " + response.getStatus() +

//错误信息

", status_text: " + response.getStatusText());

}

};

} catch (Exception e) {

e.printStackTrace();

}

return listener;

}

public void process(String text) {

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

//语速，范围是-500~500，默认是0。

synthesizer.setSpeechRate(0);

//设置用于语音合成的文本

// 此处调用的是setLongText接口(原语音合成接口是setText)。

synthesizer.setLongText(text);

//此方法将以上参数设置序列化为JSON发送给服务端，并等待服务端确认。

long start = System.currentTimeMillis();

synthesizer.start();

logger.info("tts start latency " + (System.currentTimeMillis() - start) + " ms");

SpeechLongSynthesizerDemo.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 = "";

String token = "填写你的token";

// url取默认值

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[2];

} else {

System.err.println("run error, need params(url is optional): " + " [url]");

System.exit(-1);

}

String ttsTextLong = "百草堂与三味书屋 鲁迅 \n" +

"我家的后面有一个很大的园，相传叫作百草园。现在是早已并屋子一起卖给朱文公的子孙了，连那最末次的相见也已经隔了七八年，其中似乎确凿只有一些野草；但那时却是我的乐园。\n" +

"不必说碧绿的菜畦，光滑的石井栏，高大的皂荚树，紫红的桑葚；也不必说鸣蝉在树叶里长吟，肥胖的黄蜂伏在菜花上，轻捷的叫天子(云雀)忽然从草间直窜向云霄里去了。\n" +

"单是周围的短短的泥墙根一带，就有无限趣味。油蛉在这里低唱，蟋蟀们在这里弹琴。翻开断砖来，有时会遇见蜈蚣；还有斑蝥，倘若用手指按住它的脊梁，便会啪的一声，\n" +

"从后窍喷出一阵烟雾。何首乌藤和木莲藤缠络着，木莲有莲房一般的果实，何首乌有臃肿的根。有人说，何首乌根是有像人形的，吃了便可以成仙，我于是常常拔它起来，牵连不断地拔起来，\n" +

"也曾因此弄坏了泥墙，却从来没有见过有一块根像人样! 如果不怕刺，还可以摘到覆盆子，像小珊瑚珠攒成的小球，又酸又甜，色味都比桑葚要好得远......";

SpeechLongSynthesizerDemo demo = new SpeechLongSynthesizerDemo(appKey, token, url);

demo.process(ttsTextLong);

demo.shutdown();

}

}