Android TTS SDK 接口说明

// 1. 配置初始化参数
VirtualHumanTtsParam param = new VirtualHumanTtsParam();
param.appKey              = "your_app_key";
param.accessToken         = "your_access_token";
// virtualmanProjectId 与 assetVirtualmanKey 二选一必填，同时填写时 assetVirtualmanKey 优先
param.virtualmanProjectId = "your_project_id";
// param.assetVirtualmanKey = "your_asset_key";

// 2. 初始化 SDK（建议在 Application.onCreate 中调用）
VirtualHumanTts sdk = VirtualHumanTts.getInstance();
sdk.init(getApplicationContext(), param);

// 3. 注册回调
sdk.setDataCallback(result -> {
    if ("SPEECH".equals(result.driverRspType)) {
        byte[] pcm = result.speechRsp.audio;  // 播放音频
    }
});
sdk.setErrorCallback((code, msg) -> {
    Log.e("TTS", code + ": " + msg);
});
sdk.setEventCallback((code, msg) -> {
    if (code == VirtualHumanTts.EVENT_OPEN) {
        // 连接建立，可以开始发送
    }
});

// 4. （可选）设置本次请求的语音合成参数
TtsSpeechParam sp = new TtsSpeechParam();
sp.timbreKey = "zh_female_xxx";
sp.setSpeed(1.0f);
sdk.setSpeechParam(sp);

// 5. 发送文本（三种驱动方式任选其一）
String reqId = TtsUtils.uuid();

// 方式一：流式文本驱动（send* 方法须在 EVENT_OPEN 之后调用）
sdk.sendStreamText(reqId, 1, false, "你好，");
sdk.sendStreamText(reqId, 2, true,  "我是数智人。");  // isFinal=true 结束

// 方式二：普通文本驱动
sdk.sendText(reqId, "你好，我是数智人。");

// 方式三：对话驱动
sdk.sendChat(reqId, null, "今天天气怎么样？");

// 6. 打断当前请求
sdk.stop();

// 7. Activity/Fragment 销毁时释放资源
sdk.uninit();

public static VirtualHumanTts getInstance()

public synchronized void init(@NonNull Context context, VirtualHumanTtsParam param)

public synchronized void uninit()

public synchronized void reconnect()

public void setSpeechParam(TtsSpeechParam speechParam)

public void setDataCallback(OnResultListener listener)

public interface OnResultListener {
    void onResult(TtsResult result);
}

public void setErrorCallback(OnErrorListener listener)

public interface OnErrorListener {
    void onError(int code, String message);
}

public void setEventCallback(OnEventListener listener)

public interface OnEventListener {
    void onEvent(int code, String message);
}

public void sendStreamText(String reqId, int seq, boolean isFinal, String text)

TtsSpeechParam sp = new TtsSpeechParam();
sp.timbreKey = "zh_female_xxx";
sp.setSpeed(1.2f);
sdk.setSpeechParam(sp);

String reqId = TtsUtils.uuid();
sdk.sendStreamText(reqId, 1, false, "你好，");
sdk.sendStreamText(reqId, 2, false, "我是数智人。");
sdk.sendStreamText(reqId, 3, true,  "");

public void sendText(String reqId, String text)

sdk.setSpeechParam(null);  // 使用项目默认配置
sdk.sendText(TtsUtils.uuid(), "你好，我是数智人。");

public void sendChat(String reqId, String streamId, String text)

String sessionId = TtsUtils.uuid();  // 多轮对话中保持不变
sdk.sendChat(TtsUtils.uuid(), sessionId, "今天天气怎么样？");
sdk.sendChat(TtsUtils.uuid(), sessionId, "那明天呢？");  // 同一会话继续

public void stop()

TtsSpeechParam sp = new TtsSpeechParam();
sp.timbreKey = "zh_female_xxx";
sp.setSpeed(1.2f);
sp.volume = 2;
sp.emotionCategory = "happy";
sp.emotionIntensity = 150;
sp.smartActionEnabled = true;
sdk.setSpeechParam(sp);