Skip to content

初始化SDK

方法名

initSdk

注意

该方法会回调合成进度以及合成文件的路径

用法

  • 用法如下:

    js
    module.initSdk({
      //网页上应用的appId,申请纯离线SDK鉴权的必备信息
      appId: "",
      //网页上应用的appKey
      appKey: "",
      //网页上应用的secretKey
      secretKey: "",
      //官网获取的激活纯离线sdk的序列号
      sn: "",
      //以下参数可以在初始化中不设置,支持在合成的时候设置
      // 设置在线发声音人: 0 普通女声(默认) 1 普通男声 3 情感男声<度逍遥> 4 情感儿童声<度丫丫>, 其它发音人见文档,也可以在合成的时候设置
      speaker: "0",
      // 设置合成的音量,0-15 ,默认 5
      volume: "15",
      // 设置合成的语速,0-15 ,默认 5
      speed: "5",
      // 设置合成的语调,0-15 ,默认 5
      pitch: "5",
      //模式
      // MIX_MODE_DEFAULT 默认 ,wifi状态下使用在线,非wifi离线。在线状态下,请求超时6s自动转离线
      // MIX_MODE_HIGH_SPEED_SYNTHESIZE_WIFI wifi状态下使用在线,非wifi离线。在线状态下, 请求超时1.2s自动转离线
      // MIX_MODE_HIGH_SPEED_NETWORK , 3G 4G wifi状态下使用在线,其它状态离线。在线状态下,请求超时1.2s自动转离线
      // MIX_MODE_HIGH_SPEED_SYNTHESIZE, 2G 3G 4G wifi状态下使用在线,其它状态离线。在线状态下,请求超时1.2s自动转离线
      mixMode: "MIX_MODE_DEFAULT",
      //模式超时时间,可选值:PARAM_MIX_TIMEOUT_TWO_SECOND, PARAM_MIX_TIMEOUT_THREE_SECOND,PARAM_MIX_TIMEOUT_FOUR_SECOND
      mixModeTimeout: "PARAM_MIX_TIMEOUT_TWO_SECOND",
      //语音模型,可选值:duxiaoyu,navi,duxiaoyao,duyaya
      voiceType: "navi",
      //自定义语音模型,需放置到asset根目录下(dat文件名)
      // customVoiceType:""
    }, res => {
      console.log(res)
    })
  • 参数说明

    参数名参数类型是否必填默认值参数描述
    appIdString网页上应用的appId,申请纯离线SDK鉴权的必备信息
    appKeyString网页上应用的appKey
    secretKeyString网页上应用的secretKey
    snString官网获取的激活纯离线sdk的序列号
    speakerString设置在线发声音人: 0 普通女声(默认) 1 普通男声 3 情感男声<度逍遥> 4 情感儿童声<度丫丫>, 其它发音人见文档,也可以在合成的时候设置
    volumeString5设置合成的音量,0-15
    speedString5设置合成的语速,0-15
    pitchString5设置合成的语调,0-15
    mixModeString模式,请参考下方说明
    mixModeTimeoutString模式超时时间,请参考下方说明
    voiceTypeStringduxiaoyu语音模型,可选值:duxiaoyu,navi,duxiaoyao,duyaya
    customVoiceTypeString自定义语音模型,需放置到asset根目录下(dat文件名)

    mixMode说明

    模式有以下可选属性

    • MIX_MODE_DEFAULT 默认 ,wifi状态下使用在线,非wifi离线。在线状态下,请求超时6s自动转离线
    • MIX_MODE_HIGH_SPEED_SYNTHESIZE_WIFI wifi状态下使用在线,非wifi离线。在线状态下, 请求超时1.2s自动转离线
    • MIX_MODE_HIGH_SPEED_NETWORK , 3G 4G wifi状态下使用在线,其它状态离线。在线状态下,请求超时1.2s自动转离线
    • MIX_MODE_HIGH_SPEED_SYNTHESIZE, 2G 3G 4G wifi状态下使用在线,其它状态离线。在线状态下,请求超时1.2s自动转离线

    mixModeTimeout说明

    模式超时时间有以下可选属性

    • PARAM_MIX_TIMEOUT_TWO_SECOND 默认 ,2秒
    • PARAM_MIX_TIMEOUT_THREE_SECOND 3秒
    • PARAM_MIX_TIMEOUT_FOUR_SECOND , 4秒

    customVoiceType说明

    自定义语音文件需要将dat文件放置到【uni_modules】> 【leven-uts-bdTts】> 【utssdk】> 【app-android】> 【asset】目录下

回调

  • 示例
json
{
    "data": {
        "type": "onInitSuccess"
    },
    "message": "",
    "code": 0
}
json
{
    "data": {
        "type": "onSynthesizeStart",
        "utteranceId": "0"
    },
    "message": "",
    "code": 0
}
json
{
    "data": {
        "type": "onSpeechStart",
        "utteranceId": "0"
    },
    "message": "",
    "code": 0
}
json
{
    "data": {
        "type": "onSynthesizeDataArrived",
        "engineType": 1,
        "progress": 0,
        "utteranceId": "0"
    },
    "message": "",
    "code": 0
}
json
{
    "data": {
        "type": "onSpeechProgressChanged",
        "progress": 0,
        "utteranceId": "0"
    },
    "message": "",
    "code": 0
}
json
{
    "data": {
        "type": "onSynthesizeFinish",
        "filePath": "/storage/emulated/0/levenUtsBdTts/1763520081920_0.pcm",
        "utteranceId": "0"
    },
    "message": "",
    "code": 0
}
json
{
    "data": {
        "type": "onSpeechFinish",
        "utteranceId": "0"
    },
    "message": "",
    "code": 0
}
  • 回调说明:

    参数名参数类型参数描述
    messageString消息提示
    dataObject数据对象
    data.typeString类型,请参考下方说明
    data.utteranceIdString合成唯一id
    data.engineTypeString引擎类型,1:音频数据由离线引擎合成; 0:音频数据由在线引擎(百度服务器)合成。
    data.progressString合成进度,如合成“百度语音问题”这6个字, progress肯定是从0开始,到6结束。 但progress无法和合成到第几个字对应。
    data.filePathString合成文件路径
    data.codeString合成出错code值
    data.messageString合成出错信息
    codeInteger返回类型,0.成功,其他:失败

    data.type说明

    • onInitSuccess 初始化成功
    • onSynthesizeStart 合成开始
    • onSynthesizeDataArrived 合成进度
    • onSynthesizeFinish 合成正常结束
    • onSpeechStart 播放开始
    • onSpeechProgressChanged 播放进度
    • onSpeechFinish 播放正常结束
    • onError 合成或者播放过程中出错