圖片翻譯 Android SDK 簡介

概述

(1) 概念解釋

圖片翻譯：基于文字識別與文本翻譯技術(shù)，結(jié)合組段和渲染技術(shù)，滿足用戶翻譯圖片文字的需求，提升輸入效率

(2) 說明

Hi，您好，歡迎使用有道智云圖片翻譯 Android SDK。

如果您想快速體驗(yàn)服務(wù)，建議您前往 圖片翻譯體驗(yàn)中心或者在體驗(yàn)中心右下側(cè)找到小程序二維碼，掃描進(jìn)行體驗(yàn)。

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

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

商務(wù)郵箱： AIcloud_Business@corp.youdao.com

如果您對文檔內(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

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

功能介紹

圖片翻譯 SDK 是有道在線圖片翻譯服務(wù)進(jìn)行封裝。提供快速的接入方式；同時(shí)提供數(shù)據(jù)統(tǒng)計(jì)能力，方便了解用戶翻譯使用情況。

兼容性

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

圖片翻譯 Android SDK 集成指南

集成前提

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

翻譯 sdk 由如下幾個(gè) sdk 組成，用戶可根據(jù)需要組合使用：

說明：無論使用何種功能，都需要加入 YoudaoBase_v20230803.jar，so 包和相應(yīng)功能的 sdk，可組合使用。

集成步驟

(1) SDK 包導(dǎo)入

請?jiān)诠こ涛募夸浵聞?chuàng)建一個(gè)名為 libs 的子目錄(有的話則不需要?jiǎng)?chuàng)建)，并將 YoudaoBase_v20230803.jar，so 包和 YoudaoTranslateOnline_v2.0.1.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" />
<!-- 往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，請?jiān)诔绦虻?Application 中調(diào)用 SDK 初始化代碼，可以參考 demo 中 DemoApplication。
注：appKey 即應(yīng)用 ID

//appKey即應(yīng)用ID
YouDaoApplication.init(this, appkey);

功能集成

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

(1) 參數(shù)說明

from：表示源語言

to：表示目標(biāo)語言

source：設(shè)置為 app 對應(yīng)的名稱（英文字符串）

timeout：表示超時(shí)時(shí)間

注意：輸入圖片數(shù)據(jù)需要轉(zhuǎn)換為 Base64 編碼。

(2) 構(gòu)造圖片翻譯查詞對象

代碼如下：

      String from = languageSelectFrom.getText().toString();
        String to = languageSelectTo.getText().toString();
        LanguageOcrTranslate langFrom = LanguageUtils.getLangByName_OCRTranslate(from);
        LanguageOcrTranslate langTo = LanguageUtils.getLangByName_OCRTranslate(to);
        OcrTranslateParameters ocrP = new OcrTranslateParameters.Builder()
                .timeout(6000)//超時(shí)時(shí)間
                .from(langFrom)//源語言
                .to(langTo)//目標(biāo)語言，目標(biāo)語言不可以為auto
                .serverRender(true) //使用server的圖片渲染，直接返回渲染圖片
                .build();

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

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

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

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

        OcrTranslate.getInstance(ocrP).lookup(base64, "requestid", new OcrTranslateListener() {
            @Override
            public void onError(TranslateErrorCode error, String requestId) {

            }

            @Override
            public void onResult(OCRTranslateResult result, String input, String requestId) {

            }
        });

注：OCRTranslateResult.getRenderImage() 為服務(wù)端渲染好的圖片的 base64

支持語言

下表為各語言對應(yīng)代碼：

錯(cuò)誤代碼列表

常見問題及注意事項(xiàng)

1.運(yùn)行程序崩潰？
檢查下是否對應(yīng)的 so 是否放到當(dāng)前工程目錄下。

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

3.如何獲得應(yīng)用 ID
注冊賬號， 登錄后臺創(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) ,請檢查是否是在主線程中調(diào)用的翻譯識別方法，請確保在主線程調(diào)用。

版本更新記錄