语音合成（1077+）

接口声明

在manifest.json文件的 features属性中增加如下配置。

{"name": "service.ml.tts"}

导入模块

在调用接口页面的<script>部分增加如下配置。

import mltts from '@service.ml.tts'

或

var mltts = require("@service.ml.tts ")

使用限制

接口定义

[h2]mltts.speak(OBJECT)（1077+）

描述

启动语音合成，在回调中获取合成结果。

参数

eventName说明

callback返回值

fail返回错误码

返回值

识别过程中会多次回调，返回值视第一个参数eventName值而定。

示例代码

mltts.speak({ //启动语音合成
    appId: “开发者申请的appId”, //String 参数，必填
    apiKey: “开发者申请的apiKey”, //String 参数，必填，鉴权，设置apiKey
    language: “”, //String 参数，非必填，设置语言，可不传，默认中文，zh-Hans/en-US/fr-FR/es-ES。
    speaker: “”, //String 参数，非必填，设置声音，可不传，默认中文女声：Female-zh/Female-en/Male-zh/Male-en/fr-FR-st-1/es-ES-st-1。
    speed: 1, //Number 参数，非必填，播放速度，默认1
    volume: 1, //Number 参数，非必填，播放声音，默认1
    queueMode: 0, //Number 参数，非必填，队列模式，默认0， 0-排队模式 1-清空模式
    sourceText: "这是一个测试", //String 参数，表示需要合成的文本信息，支持最长500个字符的输入（包含500）。
    callback: (eventName, taskId, ...data) => { //回调方法，返回1个或多个参数，第一个参数为事件名称(eventName)，其它参数视业务而定。
    console.log(eventName, taskId, ...data);
    switch (eventName) {
        case 'onWarn': //告警处理（不影响业务逻辑）。
        let mlTtsWarn = data[0]; //json格式，告警id：mlTtsWarn.warnId；告警信息：mlTtsWarn.warnMsg
        break;
        case 'onRangeStart': //当前播放分片和文本对应关系处理。
        let start = data[0]; //音频分片在输入文本中的起始位置
        let end = data[1]; //音频分片在输入文本中的结束位置（不包含）
        break;
        case ' onPlayStart': //播放开始回调

        break;
        case ' onPlayResume': //播放恢复回调

        break;

        case 'onPlayPause': //播放暂停回调

        break;
        case 'onPlayStop': //播放停止回调

        break;
        case 'onSynthesisStart': //语音合成开始的回调。

        break;
        case 'onSynthesisEnd': //语音合成结束的回调。

        break;

        }
    },
    fail: (errMsg, errCode) => { //失败回调，识别发生错误后调用该接口
        console.log("error:", errMsg);
    },
});

[h2]mltts.stop()（1077+）

描述

停止语音合成。

示例代码

mltts.stop(); //停止

[h2]mltts.pausePlay()（1077+）

描述

暂停播放。

示例代码

mltts.pausePlay(); //暂停播放

[h2]mltts.resumePlay()（1077+）

描述

恢复播放。

示例代码

mltts.resumePlay(); //恢复播放