Skip to content

语音合成

语音合成插件需要实现以下函数:

  1. 获取支持的语言数组(必须实现)
  2. 执行语音合成(必须实现)
  3. 自定义语音合成超时时间(可选)
  4. 自定义验证(可选)

1. 获取支持的语言数组

与文本翻译插件要求相同,点此查看

2. 执行文字识别

javascript
function tts(query, completion) {
    ...
    ...
    completion({'result': result});
    // or
    completion({'error': error});    
}

该函数在每次进行语音合成的时候会被调用。

  • query 参数为 object 类型,用于描述需要合成的文本信息
  • completion 参数为 function 类型,用于合成完成后回调

query

query 参数的结构如下:

属性类型说明
textstring需要合成的文本
langstring当前文本的语言,一定不是 auto。查看 语言代码

示例:

javascript
{
    'text': 'What are you doing',
    'lang': 'en'
}

completion

completion 函数的参数为 object 类型,根据不同情况赋值对应属性:

属性类型说明
resulttts result翻译成功时,设置该属性。
errorservice error合成错误时,设置该属性。

3. 自定义语音合成超时时间 Bob 1.6.0+ 可用

Bob 主程序调用插件 tts 函数的时候,会设定一个超时时间,防止插件出现不回调的情况。

超时时间默认为 60 秒,可自定义为 30 秒到 300 秒之间。不建议将超时时间设置得过长,比较影响用户体验。如无特殊需要,请勿自定义超时时间。

如果需要自定义超时时间,可以实现以下函数:

js
function pluginTimeoutInterval() {
    return 60;
}

4. 自定义验证 Bob 1.6.0+ 可用

如果插件想要在偏好设置显示验证按钮,可以自行实现验证函数。

验证函数的 completion 参数为 function 类型,用于验证完毕之后回调。

completion 的参数为 object 类型,根据不同情况赋值对应属性:

属性类型说明
resultboolean验证是否成功。
errorservice error验证失败时,设置该属性。

注意,error 新增了 troubleshootingLink 属性,可用于验证失败时显示故障排除的链接给用户。

js
function pluginValidate(completion) {
    // 验证成功示例
    completion({ result: true });

    // 验证失败示例
    completion({ 
        result: false,
        error: {
            type: "secretKey",
            message: "未设置秘钥",
            troubleshootingLink: "https://www.google.com"
        }
    });
}