語音翻譯 Android SDK 簡(jiǎn)介
概述
(1) 概念解釋
語音翻譯：將一段源語言音頻文件轉(zhuǎn)換成目標(biāo)語言文本/語音，大大減輕傳統(tǒng)文本翻譯的讀寫成本，翻譯更輕松
(2) 說明
Hi，您好，歡迎使用有道智云語音翻譯Android SDK。
本文檔主要針對(duì)需要集成語音翻譯服務(wù)Android SDK的開發(fā)工程師，詳細(xì)描述有道智云語音翻譯能力及集成過程。
如果您有與我們商務(wù)合作的需求，可以通過以下方式聯(lián)系我們：
商務(wù)郵箱： AIcloud_Business@corp.youdao.com
如果您對(duì)文檔內(nèi)容有任何疑問，可以通過以下幾種方式聯(lián)系我們：
客服QQ：1906538062
智云翻譯技術(shù)交流QQ 1群: 652880659
智云翻譯技術(shù)交流QQ 2群: 669384425
智云翻譯技術(shù)交流QQ 3群: 807539209
智云翻譯技術(shù)交流QQ 4群: 936752411
聯(lián)系郵箱： zhiyun@corp.youdao.com
溫馨提示：
本文檔主要針對(duì)開發(fā)人員，接入測(cè)試前需要在后臺(tái)創(chuàng)建Android應(yīng)用，并綁定語音翻譯實(shí)例；如果您還沒有，請(qǐng)按照新手指南 操作。
平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測(cè)試所用，具體資費(fèi)規(guī)則詳見 語音翻譯服務(wù)報(bào)價(jià) 。
功能介紹
有道語音翻譯SDK是對(duì)有道在線語音翻譯接口服務(wù)的封裝。提供給開發(fā)者快速的接入方式；同時(shí)提供數(shù)據(jù)統(tǒng)計(jì)服務(wù)，方便開發(fā)者了解用戶語音翻譯使用情況。
兼容性
支持設(shè)備：運(yùn)行了 Android 4.0.3以及以上系統(tǒng)的 Android 設(shè)備
語音翻譯 Android SDK集成指南
集成前提
開始集成SDK之前開發(fā)者需要登錄有道智云平臺(tái) ，創(chuàng)建應(yīng)用獲取應(yīng)用ID（或者通過運(yùn)營(yíng)人員獲取應(yīng)用ID），以便使用語音翻譯服務(wù)。
集成步驟
翻譯sdk由如下幾個(gè)sdk組成，用戶可根據(jù)需要組合使用：
| 文件 |
說明 |
| YoudaoBase_v20230803.jar |
翻譯相關(guān)sdk基礎(chǔ)庫(kù)（必選） |
| online_auth.jar |
翻譯相關(guān)sdk基礎(chǔ)庫(kù)（必選） |
| zhiyun_offline_common.jar |
翻譯相關(guān)sdk基礎(chǔ)庫(kù)（必選） |
| YoudaoTranslateOnline_v2.0.1.jar |
在線翻譯sdk（必選） |
| YoudaotranslateDemo |
sdk使用demo |
說明：無論使用何種功能，都需要加入 YoudaoBase_v20230803.jar so包和相應(yīng)功能的 sdk，可組合使用。
(1) SDK包導(dǎo)入
請(qǐng)?jiān)诠こ涛募夸浵聞?chuàng)建一個(gè)名為 libs 的子目錄(有的話則不需要?jiǎng)?chuàng)建)，并將YoudaoBase.jar和YoudaoTranslateOnline.jar拷貝到 libs 目錄下，并將以下代碼添加到app的build.gradle中：
android {
sourceSets.main.jniLibs.srcDirs = ['libs']
...
}
dependencies {
compile files('libs/YoudaoBase_v20230803.jar')
compile files('libs/online_auth.jar')
compile files('libs/zhiyun_offline_common.jar')
compile files('libs/YoudaoTranslateOnline_v2.0.1.jar')
}
(2) AndroidManifest配置
<uses-permission android:name="android.permission.INTERNET" />
<!-- 獲取WiFi狀態(tài) -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 獲取網(wǎng)絡(luò)信息狀態(tài)，如當(dāng)前的網(wǎng)絡(luò)連接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 讀取手機(jī)狀態(tài) phone group -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 往SDCard讀寫數(shù)據(jù)權(quán)限 storage group -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
(3) 代碼混淆配置
代碼混淆文件proguard-project.txt，添加如下內(nèi)容：
-ignorewarnings
-libraryjars libs/ YoudaoBase_v20230803.jar
-libraryjars libs/ YoudaoTranslateOnline_v2.0.1.jar
-keep class com.youdao.sdk.ydtranslate.** { *;}
-keep class com.youdao.sdk.ydonlinetranslate.** { *;}
(4) SDK初始化
使用圖片翻譯SDK，請(qǐng)?jiān)诔绦虻腁pplication中調(diào)用SDK初始化代碼，可以參考demo中DemoApplication。
注：appKey即應(yīng)用ID
//appKey即應(yīng)用ID
YouDaoApplication.init(this, appkey);
功能集成
說明：請(qǐng)參考 demo 中 SpeachTranslateDemoActivity 的使用
(1) 參數(shù)說明
格式支持：wav（不壓縮、pcm編碼）。
采樣率：16k。
編碼：16bit位深的單聲道
注意：輸入語音數(shù)據(jù)需要轉(zhuǎn)換為Base64編碼。
(2) 構(gòu)造語音翻譯查詞對(duì)象
SpeechTranslateParameters tps = new SpeechTranslateParameters.Builder().source("youdaovoicetranslate")
.from(Language.CHINESE)
.to(Language.ENGLISH)
.format(SpeechTranslateParameters.SOUND_INPUT_PCM)//輸入音頻格式，支持pcm和war
.rate(SpeechTranslateParameters.RATE_8000)//輸入音頻碼率，支持8000,16000
.sound(SpeechTranslateParameters.SOUND_OUTPUT_MP3)//輸出語音格式，支持wav
.voice(SpeechTranslateParameters.VOICE_GIRL_US)//輸出聲音，支持美式女生、美式男生、英式女生、英式男生
.timeout(100000)//超時(shí)時(shí)間
.build();
(3) 設(shè)置回調(diào)和開始翻譯
通過SpeechTranslate，設(shè)置上一步構(gòu)造的查詞對(duì)象，調(diào)用lookup方法傳入語音base64編碼的數(shù)據(jù)和回調(diào)接口開始查詢，方法中最后一個(gè)參數(shù)"requestId"，SDK并未使用，在回調(diào)中會(huì)再返回給開發(fā)者，用于區(qū)分每次調(diào)用，開發(fā)者可傳null或者任意字符串。
識(shí)別回調(diào)接口包含兩個(gè)方法：onResult表示識(shí)別成功，相關(guān)結(jié)果存儲(chǔ)在result參數(shù)中，onError表示失敗，失敗信息放在TranslateErrorCode枚舉類中。
注意：整個(gè)識(shí)別是異步的，回調(diào)在子線程進(jìn)行，若涉及到界面操作，請(qǐng)切回主線程。
SpeechTranslate.getInstance(tps).lookup(bases64,
new TranslateListener() {
@Override
public void onResult(final Translate result, String input, String requestId) {
handler.post(new Runnable() {
@Override
public void run() {
resultText.setText("翻譯完成:" + result.getQuery());
tr = result;
toDetail.setVisibility(View.VISIBLE);
}
});
}
@Override
public void onError(final TranslateErrorCode error, String requestId) {
handler.post(new Runnable() {
@Override
public void run() {
tr = null;
resultText.setText("翻譯失敗" + error.toString());
toDetail.setVisibility(View.GONE);
}
});
}
}, "requestId");
語音翻譯 Android SDK 簡(jiǎn)介
概述
(1) 概念解釋
語音翻譯：將一段源語言音頻文件轉(zhuǎn)換成目標(biāo)語言文本/語音，大大減輕傳統(tǒng)文本翻譯的讀寫成本，翻譯更輕松
(2) 說明
Hi，您好，歡迎使用有道智云語音翻譯Android SDK。
本文檔主要針對(duì)需要集成語音翻譯服務(wù)Android SDK的開發(fā)工程師，詳細(xì)描述有道智云語音翻譯能力及集成過程。
如果您有與我們商務(wù)合作的需求，可以通過以下方式聯(lián)系我們：
商務(wù)郵箱： AIcloud_Business@corp.youdao.com
如果您對(duì)文檔內(nèi)容有任何疑問，可以通過以下幾種方式聯(lián)系我們：
客服QQ：1906538062
智云翻譯技術(shù)交流QQ 1群: 652880659
智云翻譯技術(shù)交流QQ 2群: 669384425
智云翻譯技術(shù)交流QQ 3群: 807539209
智云翻譯技術(shù)交流QQ 4群: 936752411
聯(lián)系郵箱： zhiyun@corp.youdao.com
溫馨提示：
本文檔主要針對(duì)開發(fā)人員，接入測(cè)試前需要在后臺(tái)創(chuàng)建Android應(yīng)用，并綁定語音翻譯實(shí)例；如果您還沒有，請(qǐng)按照新手指南 操作。
平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測(cè)試所用，具體資費(fèi)規(guī)則詳見 語音翻譯服務(wù)報(bào)價(jià) 。
功能介紹
有道語音翻譯SDK是對(duì)有道在線語音翻譯接口服務(wù)的封裝。提供給開發(fā)者快速的接入方式；同時(shí)提供數(shù)據(jù)統(tǒng)計(jì)服務(wù)，方便開發(fā)者了解用戶語音翻譯使用情況。
兼容性
支持設(shè)備：運(yùn)行了 Android 4.0.3以及以上系統(tǒng)的 Android 設(shè)備
語音翻譯 Android SDK集成指南
集成前提
開始集成SDK之前開發(fā)者需要登錄有道智云平臺(tái) ，創(chuàng)建應(yīng)用獲取應(yīng)用ID（或者通過運(yùn)營(yíng)人員獲取應(yīng)用ID），以便使用語音翻譯服務(wù)。
集成步驟
翻譯sdk由如下幾個(gè)sdk組成，用戶可根據(jù)需要組合使用：
| 文件 |
說明 |
| YoudaoBase_v20230803.jar |
翻譯相關(guān)sdk基礎(chǔ)庫(kù)（必選） |
| online_auth.jar |
翻譯相關(guān)sdk基礎(chǔ)庫(kù)（必選） |
| zhiyun_offline_common.jar |
翻譯相關(guān)sdk基礎(chǔ)庫(kù)（必選） |
| YoudaoTranslateOnline_v2.0.1.jar |
在線翻譯sdk（必選） |
| YoudaotranslateDemo |
sdk使用demo |
說明：無論使用何種功能，都需要加入 YoudaoBase_v20230803.jar so包和相應(yīng)功能的 sdk，可組合使用。
(1) SDK包導(dǎo)入
請(qǐng)?jiān)诠こ涛募夸浵聞?chuàng)建一個(gè)名為 libs 的子目錄(有的話則不需要?jiǎng)?chuàng)建)，并將YoudaoBase.jar和YoudaoTranslateOnline.jar拷貝到 libs 目錄下，并將以下代碼添加到app的build.gradle中：
android {
sourceSets.main.jniLibs.srcDirs = ['libs']
...
}
dependencies {
compile files('libs/YoudaoBase_v20230803.jar')
compile files('libs/online_auth.jar')
compile files('libs/zhiyun_offline_common.jar')
compile files('libs/YoudaoTranslateOnline_v2.0.1.jar')
}
(2) AndroidManifest配置
<uses-permission android:name="android.permission.INTERNET" />
<!-- 獲取WiFi狀態(tài) -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 獲取網(wǎng)絡(luò)信息狀態(tài)，如當(dāng)前的網(wǎng)絡(luò)連接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 讀取手機(jī)狀態(tài) phone group -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 往SDCard讀寫數(shù)據(jù)權(quán)限 storage group -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
(3) 代碼混淆配置
代碼混淆文件proguard-project.txt，添加如下內(nèi)容：
-ignorewarnings
-libraryjars libs/ YoudaoBase_v20230803.jar
-libraryjars libs/ YoudaoTranslateOnline_v2.0.1.jar
-keep class com.youdao.sdk.ydtranslate.** { *;}
-keep class com.youdao.sdk.ydonlinetranslate.** { *;}
(4) SDK初始化
使用圖片翻譯SDK，請(qǐng)?jiān)诔绦虻腁pplication中調(diào)用SDK初始化代碼，可以參考demo中DemoApplication。
注：appKey即應(yīng)用ID
//appKey即應(yīng)用ID
YouDaoApplication.init(this, appkey);
功能集成
說明：請(qǐng)參考 demo 中 SpeachTranslateDemoActivity 的使用
(1) 參數(shù)說明
格式支持：wav（不壓縮、pcm編碼）。
采樣率：16k。
編碼：16bit位深的單聲道
注意：輸入語音數(shù)據(jù)需要轉(zhuǎn)換為Base64編碼。
(2) 構(gòu)造語音翻譯查詞對(duì)象
SpeechTranslateParameters tps = new SpeechTranslateParameters.Builder().source("youdaovoicetranslate")
.from(Language.CHINESE)
.to(Language.ENGLISH)
.format(SpeechTranslateParameters.SOUND_INPUT_PCM)//輸入音頻格式，支持pcm和war
.rate(SpeechTranslateParameters.RATE_8000)//輸入音頻碼率，支持8000,16000
.sound(SpeechTranslateParameters.SOUND_OUTPUT_MP3)//輸出語音格式，支持wav
.voice(SpeechTranslateParameters.VOICE_GIRL_US)//輸出聲音，支持美式女生、美式男生、英式女生、英式男生
.timeout(100000)//超時(shí)時(shí)間
.build();
(3) 設(shè)置回調(diào)和開始翻譯
通過SpeechTranslate，設(shè)置上一步構(gòu)造的查詞對(duì)象，調(diào)用lookup方法傳入語音base64編碼的數(shù)據(jù)和回調(diào)接口開始查詢，方法中最后一個(gè)參數(shù)"requestId"，SDK并未使用，在回調(diào)中會(huì)再返回給開發(fā)者，用于區(qū)分每次調(diào)用，開發(fā)者可傳null或者任意字符串。
識(shí)別回調(diào)接口包含兩個(gè)方法：onResult表示識(shí)別成功，相關(guān)結(jié)果存儲(chǔ)在result參數(shù)中，onError表示失敗，失敗信息放在TranslateErrorCode枚舉類中。
注意：整個(gè)識(shí)別是異步的，回調(diào)在子線程進(jìn)行，若涉及到界面操作，請(qǐng)切回主線程。
SpeechTranslate.getInstance(tps).lookup(bases64,
new TranslateListener() {
@Override
public void onResult(final Translate result, String input, String requestId) {
handler.post(new Runnable() {
@Override
public void run() {
resultText.setText("翻譯完成:" + result.getQuery());
tr = result;
toDetail.setVisibility(View.VISIBLE);
}
});
}
@Override
public void onError(final TranslateErrorCode error, String requestId) {
handler.post(new Runnable() {
@Override
public void run() {
tr = null;
resultText.setText("翻譯失敗" + error.toString());
toDetail.setVisibility(View.GONE);
}
});
}
}, "requestId");
支持語言
| 英文名 |
中文名 |
代碼 |
| Mandarin (China) |
中文 |
zh-CHS |
| English (US) |
英文 |
en |
| English (Australia) |
英文（澳大利亞） |
en-AUS |
| English (GB) |
英文（英國(guó)） |
en-GBR |
| English (India) |
英文（印度） |
en-IND |
| Japanese |
日文 |
ja |
| Korean |
韓文 |
ko |
| French |
法文 |
fr |
| Spanish |
西班牙文 |
es |
| Portuguese (Portugal) |
葡萄牙文 |
pt |
| Russian |
俄文 |
ru |
| German |
德文 |
de |
| Arabic |
阿拉伯文 |
ar |
| Indonesian |
印尼文 |
id |
| Catalan |
加泰隆語 |
ca |
| Czech |
捷克語 |
cs |
| Danish |
丹麥語 |
da |
| Greek |
希臘語 |
el |
| Finnish |
芬蘭語 |
fi |
| French (Canada) |
法語（加拿大） |
fr-CAN |
| Hebrew |
希伯來語 |
he |
| Hindi |
印地語 |
hi |
| Hungarian |
匈牙利語 |
hu |
| Italian |
意大利語 |
it |
| Dutch |
荷蘭語 |
nl |
| Norwegian |
挪威語 |
no |
| Polish |
波蘭語 |
pl |
| Portuguese (Brazil) |
葡萄牙語（巴西） |
pt-BRA |
| Romanian |
羅馬尼亞語 |
ro |
| Slovak |
斯洛伐克語 |
sk |
| Swedish |
瑞典語 |
sv |
| Thai |
泰語 |
th |
| Turkish |
土耳其語 |
tr |
| Cantonese |
粵語 |
yue |
| Mandarin (Taiwan) |
普通話（中國(guó)臺(tái)灣） |
zh-TWN |
注意
- 越南語和印尼語目前只支持和中文的互譯。
- 支持自動(dòng)識(shí)別的語種包括：中文、英文。
- 若列表語言出現(xiàn)不支持的問題，請(qǐng)參考產(chǎn)品定價(jià)列表語種互譯的限制
錯(cuò)誤代碼列表
| 錯(cuò)誤碼 |
含義 |
| 101 |
缺少必填的參數(shù) |
| 102 |
不支持的語言類型 |
| 103 |
翻譯文本過長(zhǎng) |
| 104 |
不支持的API類型 |
| 105 |
不支持的簽名類型 |
| 106 |
不支持的響應(yīng)類型 |
| 107 |
不支持的傳輸加密類型 |
| 108 |
應(yīng)用ID無效，注冊(cè)賬號(hào)，登錄后臺(tái)創(chuàng)建應(yīng)用和實(shí)例并完成綁定，可獲得應(yīng)用ID和應(yīng)用密鑰等信息 |
| 109 |
batchLog格式不正確 |
| 110 |
無相關(guān)服務(wù)的有效實(shí)例 |
| 111 |
開發(fā)者賬號(hào)無效 |
| 113 |
q不能為空 |
| 114 |
不支持的圖片傳輸方式 |
| 201 |
解密失敗，可能為DES,BASE64,URLDecode的錯(cuò)誤 |
| 202 |
簽名檢驗(yàn)失敗 |
| 203 |
訪問IP地址不在可訪問IP列表 |
| 205 |
請(qǐng)求的接口與應(yīng)用的平臺(tái)類型不一致，如有疑問請(qǐng)參考入門指南 |
| 206 |
因?yàn)闀r(shí)間戳無效導(dǎo)致簽名校驗(yàn)失敗 |
| 207 |
重放請(qǐng)求 |
| 301 |
辭典查詢失敗 |
| 302 |
翻譯查詢失敗 |
| 303 |
服務(wù)端的其它異常 |
| 304 |
會(huì)話閑置太久超時(shí) |
| 401 |
賬戶已經(jīng)欠費(fèi)停 |
| 402 |
offlinesdk不可用 |
| 411 |
訪問頻率受限,請(qǐng)稍后訪問 |
| 412 |
長(zhǎng)請(qǐng)求過于頻繁，請(qǐng)稍后訪問 |
| 1001 |
無效的OCR類型 |
| 1002 |
不支持的OCR image類型 |
| 1003 |
不支持的OCR Language類型 |
| 1004 |
識(shí)別圖片過大 |
| 1201 |
圖片base64解密失敗 |
| 1301 |
OCR段落識(shí)別失敗 |
| 1411 |
訪問頻率受限 |
| 1412 |
超過最大識(shí)別字節(jié)數(shù) |
| 2003 |
不支持的語音聲道 |
| 2004 |
不支持的語音上傳類型 |
| 2005 |
不支持的語言類型 |
| 2006 |
不支持的識(shí)別類型 |
| 2201 |
識(shí)別音頻文件過大 |
| 2301 |
識(shí)別音頻時(shí)長(zhǎng)過長(zhǎng) |
| 2411 |
不支持的音頻文件類型 |
| 2412 |
不支持的發(fā)音類型 |
| 3001 |
不支持的語音格式 |
| 3002 |
不支持的語音采樣率 |
| 3003 |
不支持的語音聲道 |
| 3004 |
不支持的語音上傳類型 |
| 3005 |
不支持的語言類型 |
| 3006 |
不支持的識(shí)別類型 |
| 3007 |
識(shí)別音頻文件過大 |
| 3008 |
識(shí)別音頻時(shí)長(zhǎng)過長(zhǎng) |
| 3009 |
不支持的音頻文件類型 |
| 3010 |
不支持的發(fā)音類型 |
| 3201 |
解密失敗 |
| 3301 |
語音識(shí)別失敗 |
| 3302 |
語音翻譯失敗 |
| 3303 |
服務(wù)的異常 |
| 3411 |
訪問頻率受限,請(qǐng)稍后訪問 |
| 3412 |
超過最大請(qǐng)求字符數(shù) |
| 5001 |
無效的OCR類型 |
| 5002 |
不支持的OCR image類型 |
| 5003 |
不支持的語言類型 |
| 5004 |
識(shí)別圖片過大 |
| 5005 |
不支持的圖片類型 |
| 5006 |
文件為空 |
| 5201 |
解密錯(cuò)誤，圖片base64解密失敗 |
| 5301 |
OCR段落識(shí)別失敗 |
| 5411 |
訪問頻率受限 |
| 5412 |
超過最大識(shí)別流量 |
| 9001 |
不支持的語音格式 |
| 9002 |
不支持的語音采樣率 |
| 9003 |
不支持的語音聲道 |
| 9004 |
不支持的語音上傳類型 |
| 9005 |
不支持的語音識(shí)別 Language類型 |
| 9301 |
ASR識(shí)別失敗 |
| 9303 |
服務(wù)器內(nèi)部錯(cuò)誤 |
| 9411 |
訪問頻率受限（超過最大調(diào)用次數(shù)） |
| 9412 |
超過最大處理語音長(zhǎng)度 |
| 10001 |
無效的OCR類型 |
| 10002 |
不支持的OCR image類型 |
| 10004 |
識(shí)別圖片過大 |
| 10201 |
圖片base64解密失敗 |
| 10301 |
OCR段落識(shí)別失敗 |
| 10411 |
訪問頻率受限 |
| 10412 |
超過最大識(shí)別流量 |
| 13001 |
不支持的角度類型 |
| 13002 |
不支持的文件類型 |
| 13003 |
表格識(shí)別圖片過大 |
| 13004 |
文件為空 |
| 13301 |
表格識(shí)別失敗 |
| 17001 |
需要圖片 |
| 17002 |
圖片過大（1M） |
| 17003 |
識(shí)別類型未找到 |
| 17004 |
不支持的識(shí)別類型 |
| 17005 |
服務(wù)調(diào)用失敗 |
| -1000 |
未知錯(cuò)誤 |
| -2000 |
查詢輸入為空 |
常見問題及注意事項(xiàng)
1.運(yùn)行程序崩潰？
檢查下是否對(duì)應(yīng)的 so 是否放到當(dāng)前工程目錄下。
2.翻譯沒結(jié)果？
檢查下翻譯接口回調(diào)的錯(cuò)誤信息，保證申請(qǐng)的應(yīng)用ID是有效且提前綁定了。
3.如何獲得應(yīng)用ID
注冊(cè)賬號(hào)， 登錄后臺(tái)創(chuàng)建應(yīng)用和實(shí)例并完成綁定， 可獲得應(yīng)用ID和應(yīng)用密鑰等信息。
4.出現(xiàn)錯(cuò)誤HTTP_REQUEST_ERROR("Http requesterror.",1)
在確保有網(wǎng)情況下，若調(diào)用過程中出現(xiàn)這個(gè)錯(cuò)誤，HTTP_REQUEST_ERROR("Http requesterror.",1) ,請(qǐng)檢查是否是在主線程中調(diào)用的翻譯識(shí)別方法，請(qǐng)確保在主線程調(diào)用。
版本更新記錄
| 上線日期 |
版本號(hào) |
更新內(nèi)容 |
| 2023.08.07 |
v2.0.1 |
兼容多個(gè)sdk |
注意
- 越南語和印尼語目前只支持和中文的互譯。
- 支持自動(dòng)識(shí)別的語種包括：中文、英文。
錯(cuò)誤代碼列表
| 錯(cuò)誤碼 |
含義 |
| 101 |
缺少必填的參數(shù) |
| 102 |
不支持的語言類型 |
| 103 |
翻譯文本過長(zhǎng) |
| 104 |
不支持的API類型 |
| 105 |
不支持的簽名類型 |
| 106 |
不支持的響應(yīng)類型 |
| 107 |
不支持的傳輸加密類型 |
| 108 |
應(yīng)用ID無效，注冊(cè)賬號(hào)，登錄后臺(tái)創(chuàng)建應(yīng)用和實(shí)例并完成綁定，可獲得應(yīng)用ID和應(yīng)用密鑰等信息 |
| 109 |
batchLog格式不正確 |
| 110 |
無相關(guān)服務(wù)的有效實(shí)例 |
| 111 |
開發(fā)者賬號(hào)無效 |
| 113 |
q不能為空 |
| 114 |
不支持的圖片傳輸方式 |
| 201 |
解密失敗，可能為DES,BASE64,URLDecode的錯(cuò)誤 |
| 202 |
簽名檢驗(yàn)失敗 |
| 203 |
訪問IP地址不在可訪問IP列表 |
| 205 |
請(qǐng)求的接口與應(yīng)用的平臺(tái)類型不一致，如有疑問請(qǐng)參考入門指南 |
| 206 |
因?yàn)闀r(shí)間戳無效導(dǎo)致簽名校驗(yàn)失敗 |
| 207 |
重放請(qǐng)求 |
| 301 |
辭典查詢失敗 |
| 302 |
翻譯查詢失敗 |
| 303 |
服務(wù)端的其它異常 |
| 304 |
會(huì)話閑置太久超時(shí) |
| 401 |
賬戶已經(jīng)欠費(fèi)停 |
| 402 |
offlinesdk不可用 |
| 411 |
訪問頻率受限,請(qǐng)稍后訪問 |
| 412 |
長(zhǎng)請(qǐng)求過于頻繁，請(qǐng)稍后訪問 |
| 1001 |
無效的OCR類型 |
| 1002 |
不支持的OCR image類型 |
| 1003 |
不支持的OCR Language類型 |
| 1004 |
識(shí)別圖片過大 |
| 1201 |
圖片base64解密失敗 |
| 1301 |
OCR段落識(shí)別失敗 |
| 1411 |
訪問頻率受限 |
| 1412 |
超過最大識(shí)別字節(jié)數(shù) |
| 2003 |
不支持的語音聲道 |
| 2004 |
不支持的語音上傳類型 |
| 2005 |
不支持的語言類型 |
| 2006 |
不支持的識(shí)別類型 |
| 2201 |
識(shí)別音頻文件過大 |
| 2301 |
識(shí)別音頻時(shí)長(zhǎng)過長(zhǎng) |
| 2411 |
不支持的音頻文件類型 |
| 2412 |
不支持的發(fā)音類型 |
| 3001 |
不支持的語音格式 |
| 3002 |
不支持的語音采樣率 |
| 3003 |
不支持的語音聲道 |
| 3004 |
不支持的語音上傳類型 |
| 3005 |
不支持的語言類型 |
| 3006 |
不支持的識(shí)別類型 |
| 3007 |
識(shí)別音頻文件過大 |
| 3008 |
識(shí)別音頻時(shí)長(zhǎng)過長(zhǎng) |
| 3009 |
不支持的音頻文件類型 |
| 3010 |
不支持的發(fā)音類型 |
| 3201 |
解密失敗 |
| 3301 |
語音識(shí)別失敗 |
| 3302 |
語音翻譯失敗 |
| 3303 |
服務(wù)的異常 |
| 3411 |
訪問頻率受限,請(qǐng)稍后訪問 |
| 3412 |
超過最大請(qǐng)求字符數(shù) |
| 5001 |
無效的OCR類型 |
| 5002 |
不支持的OCR image類型 |
| 5003 |
不支持的語言類型 |
| 5004 |
識(shí)別圖片過大 |
| 5005 |
不支持的圖片類型 |
| 5006 |
文件為空 |
| 5201 |
解密錯(cuò)誤，圖片base64解密失敗 |
| 5301 |
OCR段落識(shí)別失敗 |
| 5411 |
訪問頻率受限 |
| 5412 |
超過最大識(shí)別流量 |
| 9001 |
不支持的語音格式 |
| 9002 |
不支持的語音采樣率 |
| 9003 |
不支持的語音聲道 |
| 9004 |
不支持的語音上傳類型 |
| 9005 |
不支持的語音識(shí)別 Language類型 |
| 9301 |
ASR識(shí)別失敗 |
| 9303 |
服務(wù)器內(nèi)部錯(cuò)誤 |
| 9411 |
訪問頻率受限（超過最大調(diào)用次數(shù)） |
| 9412 |
超過最大處理語音長(zhǎng)度 |
| 10001 |
無效的OCR類型 |
| 10002 |
不支持的OCR image類型 |
| 10004 |
識(shí)別圖片過大 |
| 10201 |
圖片base64解密失敗 |
| 10301 |
OCR段落識(shí)別失敗 |
| 10411 |
訪問頻率受限 |
| 10412 |
超過最大識(shí)別流量 |
| 13001 |
不支持的角度類型 |
| 13002 |
不支持的文件類型 |
| 13003 |
表格識(shí)別圖片過大 |
| 13004 |
文件為空 |
| 13301 |
表格識(shí)別失敗 |
| 17001 |
需要圖片 |
| 17002 |
圖片過大（1M） |
| 17003 |
識(shí)別類型未找到 |
| 17004 |
不支持的識(shí)別類型 |
| 17005 |
服務(wù)調(diào)用失敗 |
| -1000 |
未知錯(cuò)誤 |
| -2000 |
查詢輸入為空 |
常見問題及注意事項(xiàng)
1.運(yùn)行程序崩潰？
檢查下是否對(duì)應(yīng)的 so 是否放到當(dāng)前工程目錄下。
2.翻譯沒結(jié)果？
檢查下翻譯接口回調(diào)的錯(cuò)誤信息，保證申請(qǐng)的應(yīng)用ID是有效且提前綁定了。
3.如何獲得應(yīng)用ID
注冊(cè)賬號(hào)， 登錄后臺(tái)創(chuàng)建應(yīng)用和實(shí)例并完成綁定， 可獲得應(yīng)用ID和應(yīng)用密鑰等信息。
4.出現(xiàn)錯(cuò)誤HTTP_REQUEST_ERROR("Http requesterror.",1)
在確保有網(wǎng)情況下，若調(diào)用過程中出現(xiàn)這個(gè)錯(cuò)誤，HTTP_REQUEST_ERROR("Http requesterror.",1) ,請(qǐng)檢查是否是在主線程中調(diào)用的翻譯識(shí)別方法，請(qǐng)確保在主線程調(diào)用。
版本更新記錄
| 上線日期 |
版本號(hào) |
更新內(nèi)容 |
| 2023.08.07 |
v2.0.1 |
兼容多個(gè)sdk |
