语音合成
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 语音合成 > 在线 SDK 文档 > Java SDK

Java SDK

最近更新时间：2024-04-23 10:16:11

我的收藏

本页目录：

说明
此 SDK 基于老版 HTTP 接口服务，无法支持时间戳等最新特性；建议使用基于新版 API 服务的 SDK，单击进入 开发者资源 下载最新 SDK。
本文介绍如何使用腾讯云语音合成服务提供的实时语音合成 Java SDK，包括 SDK 的安装方法及 SDK 代码示例。

依赖环境

1. 依赖环境：JDK 1.8版本及以上。
2. 从 腾讯云控制台 开通相应产品。
3. 进入 API 密钥管理页面，获取 SecretId 和 SecretKey。

获取安装

安装 Java SDK 前，先获取安全凭证。在第一次使用 SDK 之前，用户首先需要在腾讯云控制台上申请安全凭证，安全凭证包括 SecretID 和 SecretKey，SecretID 是用于标识 API 调用者的身份，SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥，SecretKey 必须严格保管，避免泄露。

通过 Maven 安装

从 maven 服务器下载最新版本 SDK：
<dependency>
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-speech-sdk-java</artifactId>
    <version>LATEST</version>
</dependency>

TTS SDK 说明

关键类说明

SpeechClient 通过 SpeechClient.newInstance 创建该实例，newInstance 为单例实现。
SpeechSynthesizer 语音合成器，通过客户端 speechClient.newSpeechSynthesizer 创建实例。
SpeechSynthesizerRequest 用于配置请求参数，可通过 SpeechSynthesizerRequest.initialize() 方法进行初始化。
SpeechSynthesizerResponse 请求响应。
SpeechSynthesizerListener 请求回调。包含 onMessage onComplete onFail 回调方法。

SDK 使用说明

1. 创建 SpeechClient 实例。
2. 创建 SpeechSynthesisRequest，这里配置请求相关参数，具体参考官网 请求参数。
3. 创建 SpeechSynthesizer 实例，该实例是语音识别的处理者。
4. 调用 SpeechSynthesizer 的 synthesis 方法开始发送语音数据。

示例

参考案例

package com.tencentcloud.tts;

import com.tencent.SpeechClient;
import com.tencent.core.model.GlobalConfig;
import com.tencent.core.utils.ByteUtils;
import com.tencent.tts.model.*;
import com.tencent.tts.service.SpeechSynthesisListener;
import com.tencent.tts.service.SpeechSynthesizer;
import com.tencent.tts.service.SpeechSynthesisListener;
import com.tencent.tts.utils.OpusUtils;
import com.tencent.tts.utils.Ttsutils;

import java.io.*;
import java.util.Properties;
import java.util.concurrent.atomic.AtomicInteger;

/**
 * 语音合成 example
 */
public class SpeechTtsExample {

    private static String codec = "pcm";
    private static int sampleRate = 16000;

    private static byte[] datas = new byte[0];


    /**
     * 语音合成
     * @param args
     * @throws IOException
     */
    public static void main(String[] args) throws IOException {
        //从配置文件读取密钥
        Properties props = new Properties();
        props.load(new FileInputStream("../../config.properties"));
        String appId = props.getProperty("appId");
        String secretId = props.getProperty("secretId");
        String secretKey = props.getProperty("secretKey");
        //创建SpeechSynthesizerClient实例，目前是单例
        SpeechClient client = SpeechClient.newInstance(appId, secretId, secretKey);
        //初始化SpeechSynthesizerRequest，SpeechSynthesizerRequest包含请求参数
        SpeechSynthesisRequest request = SpeechSynthesisRequest.initialize();
        request.setCodec(codec);
        //request.setSampleRate(sampleRate);
        //request.setVolume(10);
        //request.setSpeed(2f);
        request.setVoiceType(101007);
        //使用客户端client创建语音合成实例
        SpeechSynthesizer speechSynthesizer = client.newSpeechSynthesizer(request, new MySpeechSynthesizerListener());
        //执行语音合成
        String ttsText = "腾讯云语音合成测试";
        speechSynthesizer.synthesis(ttsText);
    }


    public static class MySpeechSynthesizerListener extends SpeechSynthesisListener {

        private AtomicInteger sessionId = new AtomicInteger(0);

        @Override
        public void onComplete(SpeechSynthesisResponse response) {
            System.out.println("onComplete");
            if (response.getSuccess()) {
                //根据具体的业务选择逻辑处理
                //Ttsutils.saveResponseToFile(response.getAudio(),"./111.mp3");
                if ("pcm".equals(codec)) {
                    //pcm 转 wav
                    Ttsutils.responsePcm2Wav(sampleRate, response.getAudio(), response.getSessionId());
                }
                if ("opus".equals(codec)) {
                    //opus
                    System.out.println("OPUS:" + response.getSessionId() + " length:" + response.getAudio().length);
                }
            }
            System.out.println("结束：" + response.getSuccess() + " " + response.getCode()
                    + " " + response.getMessage() + " " + response.getEnd());
        }

        //语音合成的语音二进制数据
        @Override
        public void onMessage(byte[] data) {
            //System.out.println("onMessage:" + data.length);
            // Your own logic.
            System.out.println("onMessage length:" + data.length);
            sessionId.incrementAndGet();
        }

        @Override
        public void onFail(SpeechSynthesisResponse response) {
            System.out.println("onFail");
        }
    }
}

中国站