文本翻譯 Android SDK 簡介

概述

(1) 概念解釋

文本翻譯：將一段源語言文本轉換成目標語言文本，可根據(jù)語言參數(shù)的不同實現(xiàn)多國語音之間的互譯

(2) 說明

Hi，您好，歡迎使用有道智云文本翻譯Android SDK。如果您想快速體驗服務，建議您前往翻譯體驗中心 或者在體驗中心右下側找到小程序二維碼，掃描進行體驗。

本文檔主要針對需要集成文本翻譯服務Android SDK的開發(fā)工程師，詳細描述有道文本翻譯能力及集成過程。

如果您有與我們商務合作的需求，可以通過以下方式聯(lián)系我們：

商務郵箱： AIcloud_Business@corp.youdao.com

如果您對文檔內(nèi)容有任何疑問，可以通過以下幾種方式聯(lián)系我們：

客服QQ：1906538062

智云翻譯技術交流QQ 1群: 652880659

智云翻譯技術交流QQ 2群: 669384425

智云翻譯技術交流QQ 3群: 807539209

智云翻譯技術交流QQ 4群: 936752411

聯(lián)系郵箱： zhiyun@corp.youdao.com

溫馨提示：
本文檔主要針對開發(fā)人員，接入測試前需要在后臺創(chuàng)建Android應用，并綁定文本翻譯實例；如果您還沒有，請按照 新手指南操作。
平臺向每個賬戶贈送50元的體驗金，供用戶集成前測試所用，具體資費規(guī)則詳見 文本翻譯服務報價 。

功能介紹

文本翻譯SDK是有道在線文本翻譯服務進行封裝，提供快速的接入方式。

兼容性

支持設備：運行了 Android 4.0.3以及以上系統(tǒng)的 Android 設備

文本翻譯 Android SDK集成指南

集成前提

開始集成SDK之前開發(fā)者需要登錄 有道智云平臺，創(chuàng)建應用獲取應用ID（或者通過運營人員獲取應用ID），以便使用翻譯服務。

集成步驟

(1) SDK包導入

請在工程文件根目錄下創(chuàng)建一個名為 libs 的子目錄(有的話則不需要創(chuàng)建)，并將以下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')
    compile files('libs/YoudaoCnDictOffline.jar')
    compile files('libs/YoudaoTranslateOffline.jar')
}

(2) AndroidManifest配置

<uses-permission android:name="android.permission.INTERNET" />
        <!-- 獲取WiFi狀態(tài) -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
        <!-- 獲取網(wǎng)絡信息狀態(tài)，如當前的網(wǎng)絡連接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
        <!-- 讀取手機狀態(tài) phone group -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
        <!-- 往SDCard讀寫數(shù)據(jù)權限   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/ YoudaoCnDictOffline.jar
-libraryjars libs/ YoudaoTranslateOnline_v2.0.1.jar
-libraryjars libs/ YoudaoTranslateOffline.jar

-keep class com.youdao.sdk.ydtranslate.** { *;}
-keep class com.youdao.sdk.chdict.** { *;}
-keep class com.youdao.localtransengine.** { *;}
-keep class com.youdao.sdk.ydonlinetranslate.** { *;}

(4) SDK初始化

使用圖片翻譯SDK，請在程序的Application中調(diào)用SDK初始化代碼，可以參考demo中DemoApplication。
注：appKey即應用ID

//appKey即應用ID
YouDaoApplication.init(this, appkey,appSecret);

功能集成

1.漢語詞典翻譯功能集成

(1) 構造查詞對象

提供了兩種初始化方法，如下所示：

/*
 * 可以查詞之前設置詞庫路徑，則采用默認路徑Environment
 *   .getExternalStorageDirectory().getPath() + "/yuwen/backup/"
 * 請確保設置的路徑或者默認路徑下包含漢語詞典的包
 */
chDictor = new ChDictor();
/*
*表*示Environment.getExternalStorageDirectory().getAbsolutePath()* + dictFilePath路徑下存在庫
*/
chDictor = new ChDictor(dictFilePath);

(2) 查詞對象初始化和查詢

//注意，每次查詢之前都需要初始化
chDictor.init();
chDictor.lookup(text, new DictListener() {
       @Override
       public void onResult(final List<ChDictTranslate> chTs) {
         //針對多音字的情況，可能返回多個ChDictTranslate對象，比如查詢“會”
         // 注意：回調(diào)是在子線程中進行，拿到查詢結果之后若有更新UI操作，請切換到主線程執(zhí)行
         MainHandler.getInstance().post(new Runnable() {
             @Override
             public void run() {
             }
         });
       }
       @Override
       public void onError(String q, String info) {
         // TODO Auto-generated method stub
       }
});

注意： 使用漢語詞典前，請確認 最新漢語詞庫v1.1\最新漢語詞庫\hh 在設置的路徑或者默認路徑下

2.在線查詞和翻譯功能（支持小語種）功能集成

說明：請參考 demo 中 TranslateActivity 的使用

(1) 參數(shù)說明

from：表示源語言

to：表示目標語言

source：設置為app對應的名稱（英文字符串）

注意：若from設置為自動，則查詢自動識別源語言，自動識別不能保證完全正確，最好傳源語言類型

(2) 構造查詞參數(shù)對象

Language langFrom = LanguageUtils.getLangByName("中文");
Language langTo = LanguageUtils.getLangByName("英文");

TranslateParameters tps = new TranslateParameters.Builder()
       .source("ydtranslate-demo")
       .from(langFrom)
       .to(langTo)
       .build();

(3) 設置回調(diào)和開始翻譯

通過Translator，設置上一步構造的查詞對象，調(diào)用lookup方法傳入文本數(shù)據(jù)和回調(diào)接口開始查詢，方法中參數(shù)"requestId"，SDK并未使用，在回調(diào)中會再返回給開發(fā)者，用于區(qū)分每次調(diào)用，開發(fā)者可傳null或者任意字符串。

識別回調(diào)接口包含兩個方法：onResult表示識別成功，相關結果存儲在result參數(shù)中，onError表示失敗，失敗信息放在TranslateErrorCode枚舉類中。

注意：整個識別是異步的，回調(diào)在子線程進行，若涉及到界面操作，請切回主線程。

Translator.getInstance(tps).lookup(input, "requestId", new TranslateListener() {

        @Override
        public void onResult(Translate result, String input, String requestId) {//查詢成功

        }

        @Override
        public void onError(TranslateErrorCode error, String requestId) {//查詢失敗

        }

        @Override
        public void onResult(List<Translate> results, List<String> input, List<TranslateErrorCode> errors, String requestId) {//查詢成功

        }
});

3.查詞和句子翻譯功能集成

(1) 查詞對象初始化

translatorOffline = new TranslatorOffline();

(2) 初始化詞庫

若使用查詞，請通過方式一、方式二或者方式三初始化詞庫，三種方式只能選擇一種；

初始化詞庫方式一，詞庫在assets/dict目錄下,不支持直接放在assets目錄下

translatorOffline.initWordDict("dict", true, new EnWordTranslator.EnWordInitListener() {
            @Override
            public void success() {

            }
            public void fail(TranslateErrorCode errorCode){
                Log.d("translatorOffline","init false");
            }
        });

初始化詞庫方式二，指定詞庫絕對路徑,比如sd卡下：

translatorOffline.initWordDict(Environment.getExternalStorageDirectory().getAbsolutePath() + "/Youdao/localdict1/", false, new EnWordTranslator.EnWordInitListener() {
            @Override
            public void success() {
                Log.d("translatorOffline", "init success");
                long end = System.currentTimeMillis();
                long time = end - start;
                Log.i("1111111111111111", "111111111初始化時間" + time);
            }

            public void fail(TranslateErrorCode errorCode) {
                Log.d("translatorOffline", "init false");
            }
        });

初始化詞庫方式三，分別指定每個詞庫的路徑：

//初始化中日詞庫，若使用日中還需要初始化日中詞庫
       translatorOffline.initWordDictWithWordConvert("dict", true, WordConvert.CH2JA, new EnWordTranslator.EnWordInitListener() {
            @Override
            public void success() {
            }
            public void fail(TranslateErrorCode errorCode){

            }
        });
//初始化韓中詞庫，若使用中韓，還需要初始化中韓詞庫
        translatorOffline.initWordDictWithWordConvert(Environment.getExternalStorageDirectory().getAbsolutePath() + "/Youdao/localdict2/", false, WordConvert.KO2CH, new EnWordTranslator.EnWordInitListener() {
            @Override
            public void success() {
            }
            public void fail(TranslateErrorCode errorCode){
            }
        });
//初始化中英、英中詞庫
        translatorOffline.initWordDictWithWordConvert("dict", true, WordConvert.EN2CH, new EnWordTranslator.EnWordInitListener() {
            @Override
            public void success() {
            }
            public void fail(TranslateErrorCode errorCode){

            }
        });

(3) 初始化句子庫

translatorOffline.initLineDict(Environment.getExternalStorageDirectory().getAbsolutePath() + "/Youdao/Translator/transdata/data/ce2");

(4) 獲取詞庫和句子庫是否初始化成功

translatorOffline.isLineInited();        translatorOffline.isWordInited();

(5) 執(zhí)行查詢

String from = "中文";
String to = "英文";
Language langFrom = LanguageUtils.getLangByName(from);
Language langTo = LanguageUtils.getLangByName(to);
TranslateParameters parameters = new TranslateParameters.Builder().
        from(langFrom).to(langTo).useAutoConvertWord(true).useAutoConvertLine(false).build();
translatorOffline.lookupNative(input, parameters, "requestId", new TranslateListener() {
    @Override
    public void onResult(final Translate result, String input, String requestId) {
        handler.post(new Runnable() {
            @Override
            public void run() {

            }
        });
    }

    @Override
    public void onError(final TranslateErrorCode error, String requestId) {
        handler.post(new Runnable() {
            @Override
            public void run() {
                T
            }
        });
    }
});

注意：

1.若查詞和查句子都初始化了，則每次查詢，先去詞庫中找，若找不到去句子庫中查詢

2.查詞功能，詞庫支持放在assets目錄下，此時需要將詞庫localdict.datx解壓到對應目錄下（解壓得到三個文件），若是sd卡路徑，開發(fā)者可以直接放置解壓前或者解壓后的文件。使用句子翻譯前，請確定"句子\ce"文件夾下的2個文件夾，e2c和c2e在設置的路徑中或者默認路徑下是存在的。

3.useAutoConvertWord和useAutoConvertLine參數(shù)是指定是否自動識別中英文，若設置為true，則查詢時自動忽略from和to參數(shù)，根據(jù)實際輸入查詢，若設置為false，則嚴格按照from和to參數(shù)返回查詢結果

4.若想查詢不常見的變形詞，如，countries，請使用擴展詞庫。將wordlib.zip中的文件解壓到中英詞庫同級目錄。wordlib下的文件跟localdict.datx在同一級目錄，不需要wordlib文件夾。當查詢countries有查詢結果時，說明擴展詞庫生效。

4.deeplink功能

說明：請參考 demo 中 TranslateDetailActivity、HanyuActivity 查看更多功能的使用

SDK中查詢結果 Translate（英語單詞、句子在線、查詢返回結果類）和 ChDictTranslate（漢語詞典查詢結果類）中提供了 openMore(Context context)方法來實現(xiàn)查看更多的跳轉，若用戶安裝詞典則打開詞典 app，否則打開詞典移動 web 頁面。

代碼使用:

translate.openMore(context);

注意：若上面跳轉邏輯不能滿足開發(fā)需求，可調(diào)用

translate.getDictWebUrl() 方法得到對應的查詞 web 頁面地址

translate.openDict(context) 方法跳轉到詞典，若跳轉成功，返回 true，否則返回 false

支持語言

下表為各語言對應代碼：

注意：
其中auto可以識別中文、英文、日文、韓文、法文、西班牙文、葡萄牙文、俄文、越南文、德文、阿拉伯文、印尼文、意大利文，其他語種無法識別，為提高準確率，請指定語種。

錯誤代碼列表

常見問題及注意事項

1.運行程序崩潰？
檢查下是否對應的 so 是否放到當前工程目錄下。

2.翻譯沒結果？
檢查下翻譯接口回調(diào)的錯誤信息，保證申請的應用ID是有效且提前綁定了。

3.如何獲得應用ID
注冊賬號， 登錄后臺創(chuàng)建應用和實例并完成綁定， 可獲得應用ID和應用密鑰等信息。

4.出現(xiàn)錯誤HTTP_REQUEST_ERROR("Http requesterror.",1)
在確保有網(wǎng)情況下，若調(diào)用過程中出現(xiàn)這個錯誤，HTTP_REQUEST_ERROR("Http requesterror.",1) ,請檢查是否是在主線程中調(diào)用的翻譯識別方法，請確保在主線程調(diào)用。

版本更新記錄