com.sinovoice.hcicloudsdk.api.tts

类 HciCloudTts

java.lang.Object

com.sinovoice.hcicloudsdk.api.tts.HciCloudTts

public class HciCloudTts
extends java.lang.Object

灵云TTS能力API

构造器概要

构造器

构造器和说明
HciCloudTts()

方法概要

限定符和类型	方法和说明
static int	hciTtsInit(java.lang.String initParam) 灵云TTS能力初始化
static int	hciTtsRelease() 灵云TTS能力反初始化
static int	hciTtsSessionStart(java.lang.String synthConfig, Session outSession) 开始会话
static int	hciTtsSessionStop(Session session) 结束会话
static int	hciTtsSynth(Session session, java.lang.String synthText, java.lang.String synthConfig, ITtsSynthCallback callback) 进行语音合成操作
static int	hciTtsSynthEx(Session session, byte[] synthData, java.lang.String synthConfig, ITtsSynthCallback callback) 合成指定的文本数据

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

HciCloudTts

public HciCloudTts()

方法详细资料

hciTtsInit

public static final int hciTtsInit(java.lang.String initParam)

灵云TTS能力初始化

参数:

initParam - 初始化引擎的配置参数，可由TtsInitParam类辅助生成，可为null

返回:

HCI_ERR_NONE	操作成功
HCI_ERR_SYS_NOT_INIT	HCI SYS 尚未初始化
HCI_ERR_TTS_ALREADY_INIT	已经初始化过了
HCI_ERR_CONFIG_INVALID	配置参数有误，如设定值非法、或格式错误等
HCI_ERR_CONFIG_DATAPATH_MISSING	本地引擎资源路径未配置
HCI_ERR_CAPKEY_NOT_FOUND	未找到授权能力项
HCI_ERR_CONFIG_CAPKEY_NOT_MATCH	能力与Key不匹配

hciTtsSessionStart

public static final int hciTtsSessionStart(java.lang.String synthConfig,
                                           Session outSession)

开始会话

参数:

synthConfig - 会话配置串，ASCII字符串，以’\0’结束

outSession - 成功时返回会话ID

返回:

HCI_ERR_NONE	操作成功
HCI_ERR_TTS_NOT_INIT	HCI TTS尚未初始化
HCI_ERR_PARAM_INVALID	传入的参数不合法
HCI_ERR_CONFIG_INVALID	配置参数有误，如设定值非法、或格式错误等
HCI_ERR_CONFIG_CAPKEY_MISSING	缺少必需的capKey配置项
HCI_ERR_CONFIG_CAPKEY_NOT_MATCH	能力与Key不匹配
HCI_ERR_TOO_MANY_SESSION	创建的Session数量超出限制(256),本地能力需要打开本地资源文件，最终能够成功打开的本地Session个数与本地系统对同时打开文件个数的限制有关。
HCI_ERR_CAPKEY_NOT_FOUND	未找到授权能力项
HCI_ERR_CONFIG_DATAPATH_MISSING	本地引擎资源路径未配置
HCI_ERR_TTS_ENGINE_SESSION_START_FAILED	TTS本地引擎开启会话失败
HCI_ERR_CONFIG_UNSUPPORT	配置参数，引擎不支持
HCI_ERR_LOCAL_LIB_MISSING	本地能力引擎缺失必要的库资源

hciTtsSynth

public static final int hciTtsSynth(Session session,
                                    java.lang.String synthText,
                                    java.lang.String synthConfig,
                                    ITtsSynthCallback callback)

进行语音合成操作

参数:

session - 会话ID

synthText - 要合成的文本数据，UTF-8编码，最大长度为1024字节（本地歌唱能力支持最大长度为8192字节，本地歌唱能力暂不支持传入无歌曲内容文本），以’\0’结束

synthConfig - 合成参数配置串，可由TtsConfig类辅助生成，可为NULL

callback - 合成结果返回的回调

返回:

HCI_ERR_NONE	操作成功
HCI_ERR_TTS_NOT_INIT	HCI TTS尚未初始化
HCI_ERR_PARAM_INVALID	传入的参数不合法
HCI_ERR_CONFIG_INVALID	配置参数有误，如设定值非法、或格式错误等
HCI_ERR_SESSION_INVALID	传入的Session无效
HCI_ERR_TTS_SESSION_BUSY	TTS当前会话正忙
HCI_ERR_CAPKEY_NOT_FOUND	未找到授权能力项
HCI_ERR_CONFIG_UNSUPPORT	配置参数，引擎不支持
HCI_ERR_TTS_ENGINE_FAILED	本地引擎合成失败
HCI_ERR_SERVICE_CONNECT_FAILED	连接服务器失败，服务器无响应
HCI_ERR_SERVICE_TIMEOUT	服务器访问超时
HCI_ERR_SERVICE_DATA_INVALID	服务器返回的数据格式不正确
HCI_ERR_SERVICE_RESPONSE_FAILED	服务器返回合成失败
HCI_ERR_LOAD_CODEC_DLL	加载codec编码库失败
HCI_ERR_TTS_CONFIG_PROPERTY_MISSING	TTS 云端property参数缺失

hciTtsSynthEx

public static final int hciTtsSynthEx(Session session,
                                      byte[] synthData,
                                      java.lang.String synthConfig,
                                      ITtsSynthCallback callback)

合成指定的文本数据

参数:

session - 会话

synthData - 合成的文本数据，文本字节长度本地引擎不超过1024，云端引擎不限

synthConfig - 合成参数配置串（key=value 的形式），可由TtsConfig类辅助生成，可为NULL

callback - 合成结果返回的回调

返回:

HCI_ERR_NONE	操作成功
HCI_ERR_TTS_NOT_INIT	HCI TTS尚未初始化
HCI_ERR_PARAM_INVALID	传入的参数不合法
HCI_ERR_CONFIG_INVALID	配置参数有误，如设定值非法、或格式错误等
HCI_ERR_SESSION_INVALID	传入的Session无效
HCI_ERR_TTS_SESSION_BUSY	TTS当前会话正忙
HCI_ERR_CAPKEY_NOT_FOUND	未找到授权能力项
HCI_ERR_CONFIG_UNSUPPORT	配置参数，引擎不支持
HCI_ERR_TTS_ENGINE_FAILED	本地引擎合成失败
HCI_ERR_SERVICE_CONNECT_FAILED	连接服务器失败，服务器无响应
HCI_ERR_SERVICE_TIMEOUT	服务器访问超时
HCI_ERR_SERVICE_DATA_INVALID	服务器返回的数据格式不正确
HCI_ERR_SERVICE_RESPONSE_FAILED	服务器返回合成失败
HCI_ERR_LOAD_CODEC_DLL	加载codec编码库失败
HCI_ERR_TTS_CONFIG_PROPERTY_MISSING	TTS 云端property参数缺失

参数配置请参考hciTtsSynth（）定义

hciTtsSessionStop

public static final int hciTtsSessionStop(Session session)

结束会话

参数:

session - 会话

返回:

HCI_ERR_NONE	操作成功
HCI_ERR_TTS_NOT_INIT	HCI TTS尚未初始化
HCI_ERR_SESSION_INVALID	传入的Session非法
HCI_ERR_TTS_SESSION_BUSY	HCI TTS忙，尚有hci_tts_session_synth执行中

hciTtsRelease

public static final int hciTtsRelease()

灵云TTS能力反初始化

返回:

HCI_ERR_NONE	操作成功
HCI_ERR_TTS_NOT_INIT	HCI TTS尚未初始化
HCI_ERR_ACTIVE_SESSION_EXIST	尚有未stop的Sesssion，无法结束