参数和错误说明
更新时间：2022-01-19
参数和错误说明
BDSSpeechSynthesizerParams.h 文件中包含了各类参数的使用说明，如果开发者想寻找一些功能的设置办法，请浏览该文件中的相关参数说明
语音合成器参数
合成参数
百度语音合成支持的参数用BDSSynthesizerParamKey类型表示，具体如下：
| 参数 | 含义 |
|---|---|
| BDS_SYNTHESIZER_PARAM_SPEED | 语速 |
| BDS_SYNTHESIZER_PARAM_PITCH | 音调 |
| BDS_SYNTHESIZER_PARAM_VOLUME | 音量 |
| BDS_SYNTHESIZER_PARAM_PID | 产品号 |
| BDS_SYNTHESIZER_PARAM_LANGUAGE | 语言 |
| BDS_SYNTHESIZER_PARAM_TEXT_ENCODE | 文本编码类型 |
| BDS_SYNTHESIZER_PARAM_AUDIO_ENCODING | 音频编码类型 |
| BDS_SYNTHESIZER_PARAM_SPEAKER | 发音人 在线基础：0（普通女声） 1（普通男声） 3（磁性男声<度逍遥>） 4（可爱童声<度丫丫>） 在线精品：106（情感男声<度博文>） 110 （活泼童声<度小童>） 111 （可爱童声<度小萌>）103（可爱童声<度米朵>）5（情感女声<度小娇>）5118（甜美女声<度小鹿>）5003（磁性男声<度逍遥（精品）>) |
| BDS_SYNTHESIZER_PARAM_USER_AGENT | UA |
| BDS_SYNTHESIZER_PARAM_ONLINE_REQUEST_TIMEOUT | 超时时间 |
| BDS_SYNTHESIZER_PARAM_ETTS_AUDIO_FORMAT | 音频格式 |
| BDS_SYNTHESIZER_PARAM_ETTS_VOCODER_OPTIM_LEVEL | 合成引擎速度优化等级 |
| BDS_SYNTHESIZER_PARAM_SYNTH_STRATEGY | 合成策略 |
语音合成文本语言
语音合成文本语言用BDSSynthesizerLanguages类型表示，具体如下：
| 参数 | 含义 |
|---|---|
| BDS_SYNTHESIZER_LANGUAGE_ZH | 中文 |
| BDS_SYNTHESIZER_LANGUAGE_EN | 英文 |
语音合成文本编码格式
语音合成文本编码格式用BDSSynthesizerTextEncodings类型表示，具体如下：
| 参数 | 含义 |
|---|---|
| BDS_SYNTHESIZER_TEXT_ENCODE_GBK | GBK编码 |
| BDS_SYNTHESIZER_TEXT_ENCODE_BIG5 | 大五码编码 |
| BDS_SYNTHESIZER_TEXT_ENCODE_UTF8 | UTF8编码 |
语音合成音频编码格式
不支持 mp3，支持AMR、OPUS。 语音合成音频编码格式用BDSSynthesizerAudioEncoding类型表示，具体如下：
| 参数 | 含义 |
|---|---|
| BDS_SYNTHESIZER_AUDIO_ENCODE_BV_16K | bv 16k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_6K6 | amr 6.6k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_8K85 | amr 8.85k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_12K65 | amr 12.65k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_14K25 | amr 14.25k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_15K85 | amr 15.85k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_18K25 | amr 18.25k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_19K85 | amr 19.85k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_23K05 | amr 23.05k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_AMR_23K85 | amr 23.85k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_OPUS_8K | opus 8k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_OPUS_16K | opus 16k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_OPUS_18K | opus 18k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_OPUS_20K | opus 20k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_OPUS_24K | opus 24k比特率 |
| BDS_SYNTHESIZER_AUDIO_ENCODE_OPUS_32K | opus 32k比特率 |
关于AVAudioSession
SDK默认会在需要的时候设置AVAudioSession的category和setActive，如果用户想自行管理，请设置参数
BDS_SYNTHESIZER_PARAM_ENABLE_AVSESSION_MGMT和BDS_SYNTHESIZER_PARAM_AUDIO_SESSION_CATEGORY_OPTIONS
语音合成错误码
开始合成错误
开始合成错误用BDSStartSynthesisError类型表示，具体如下：
| 参数 | 含义 |
|---|---|
| BDS_START_SYNTHESIS_OK | 启动成功 |
| BDS_START_SYNTHESIS_SYNTHESIZER_UNINITIALIZED | 合成器未初始化 |
| BDS_START_SYNTHESIS_TEXT_EMPTY | 合成文本为空 |
| BDS_START_SYNTHESIS_TEXT_TOO_LONG | 和成文本过长 |
| BDS_START_SYNTHESIS_ENGINE_BUSY | 合成引擎繁忙 |
| BDS_START_SYNTHESIS_MALLOC_ERROR | 获取资源失败 |
| BDS_START_SYNTHESIS_NO_NETWORK | 无网络连接 |
| BDS_START_SYNTHESIS_NO_VERIFY_INFO | 无授权信息 |
| BDS_START_SYNTHESIS_OFFLINE_ENGINE_NOT_LOADED | 离线合成引擎未加载 |
合成错误
合成错误用BDSSynthesisError类型表示，具体如下：
| 参数 | 含义 |
|---|---|
| BDS_UNKNOWN_ERROR | 未知错误 |
| BDS_PLAYER_FAILED_GET_STREAM_PROPERTIES | 获取流属性失败 |
| BDS_PLAYER_FAILED_OPEN_DEVICE | 打开设备失败 |
| BDS_PLAYER_FAILED_OPEN_STREAM | 打开流失败 |
| BDS_PLAYER_ALLOC_FAIL | 资源申请失败 |
| BDS_PLAYER_BAD_STREAM | 音频流错误 |
| BDS_ONLINE_TTS_CONNECT_ERROR | 在线连接错误 |
| BDS_ONLINE_TTS_RESPONSE_PARSE_ERROR | 在线解析错误 |
| BDS_ONLINE_TTS_PARAM_ERROR | 在线参数错误 |
| BDS_ONLINE_TTS_TEXT_ENCODE_NOT_SUPPORTED | 文本编码格式不支持 |
| BDS_ONLINE_TTS_VERIFY_ERROR | 在线鉴权错误 |
| BDS_ONLINE_TTS_GET_ACCESS_TOKEN_FAILED | 获取token失败 |
| BDS_ETTS_ERR_PARTIAL_SYNTH | 离线部分合成错误 |
| BDS_ETTS_ERR_CONFIG | 离线配置错误 |
| BDS_ETTS_ERR_RESOURCE | 离线资源错误 |
| BDS_ETTS_ERR_HANDLE | 离线句柄错误 |
| BDS_ETTS_ERR_PARMAM | 离线参数错误 |
| BDS_ETTS_ERR_MEMORY | 离线内存错误 |
| BDS_ETTS_ERR_TOO_MANY_TEXT | 离线文本过长 |
| BDS_ETTS_ERR_RUN_TIME | 离线运行时错误 |
| BDS_ETTS_ERR_NO_TEXT | 离线空文本错误 |
| BDS_ETTS_ERR_LICENSE | 离线授权错误 |