图片翻译 Android SDK 简介

概述

(1) 概念解释

图片翻译：基于文字识别与文本翻译技术，结合组段和渲染技术，满足用户翻译图片文字的需求，提升输入效率

(2) 说明

Hi，您好，欢迎使用有道智云图片翻译 Android SDK。

如果您想快速体验服务，建议您前往 图片翻译体验中心或者在体验中心右下侧找到小程序二维码，扫描进行体验。

本文档主要针对需要集成图片翻译服务 Android SDK 的开发工程师，详细描述有道图片翻译能力及集成过程。

如果您有与我们商务合作的需求，可以通过以下方式联系我们：

商务邮箱： AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

客服 QQ：1906538062

智云翻译技术交流 QQ 1 群: 652880659

智云翻译技术交流 QQ 2 群: 669384425

智云翻译技术交流 QQ 3 群: 807539209

智云翻译技术交流 QQ 4 群: 936752411

联系邮箱： zhiyun@corp.youdao.com

温馨提示：
本文档主要针对开发人员，接入测试前需要在后台创建 Android 应用，并绑定图片翻译实例；如果您还没有，请按照 新手指南操作。
平台向每个账户赠送 50 元的体验金，供用户集成前测试所用，具体资费规则详见 图片翻译服务报价 。

功能介绍

图片翻译 SDK 是有道在线图片翻译服务进行封装。提供快速的接入方式；同时提供数据统计能力，方便了解用户翻译使用情况。

兼容性

支持设备：运行了 Android 4.0.3 以及以上系统的 Android 设备

图片翻译 Android SDK 集成指南

集成前提

开始集成 SDK 之前开发者需要登录有道智云平台 ，创建应用获取应用 ID（或者通过运营人员获取应用 ID），以便使用翻译服务。

翻译 sdk 由如下几个 sdk 组成，用户可根据需要组合使用：

说明：无论使用何种功能，都需要加入 YoudaoBase_v20230803.jar，so 包和相应功能的 sdk，可组合使用。

集成步骤

(1) SDK 包导入

请在工程文件根目录下创建一个名为 libs 的子目录(有的话则不需要创建)，并将 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状态 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 获取网络信息状态，如当前的网络连接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 往SDCard读写数据权限   storage group -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

(3) 代码混淆配置

代码混淆文件 proguard-project.txt，添加如下内容：

-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，请在程序的 Application 中调用 SDK 初始化代码，可以参考 demo 中 DemoApplication。
注：appKey 即应用 ID

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

功能集成

说明：请参考 demo 中 OcrTranslateActivity 的使用

(1) 参数说明

from：表示源语言

to：表示目标语言

source：设置为 app 对应的名称（英文字符串）

timeout：表示超时时间

注意：输入图片数据需要转换为 Base64 编码。

(2) 构造图片翻译查词对象

代码如下：

      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)//超时时间
                .from(langFrom)//源语言
                .to(langTo)//目标语言，目标语言不可以为auto
                .serverRender(true) //使用server的图片渲染，直接返回渲染图片
                .build();

(3) 设置回调和开始翻译

通过 OcrTranslate，设置上一步构造的查词对象，调用 lookup 方法传入图片 base64 编码的数据和回调接口开始查询，方法中最后一个参数"requestId"，SDK 并未使用，在回调中会再返回给开发者，用于区分每次调用，开发者可传 null 或者任意字符串。

识别回调接口包含两个方法：onResult 表示识别成功，相关结果存储在 result 参数中，onError 表示失败，失败信息放在 TranslateErrorCode 枚举类中。

注意：整个识别是异步的，回调在子线程进行，若涉及到界面操作，请切回主线程。

        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() 为服务端渲染好的图片的 base64

支持语言

下表为各语言对应代码：

错误代码列表

常见问题及注意事项

1.运行程序崩溃？
检查下是否对应的 so 是否放到当前工程目录下。

2.翻译没结果？
检查下翻译接口回调的错误信息，保证申请的应用 ID 是有效且提前绑定了。

3.如何获得应用 ID
注册账号， 登录后台创建应用和实例并完成绑定， 可获得应用 ID 和应用密钥等信息。

4.出现错误HTTP_REQUEST_ERROR("Http requesterror.",1)
在确保有网情况下，若调用过程中出现这个错误，HTTP_REQUEST_ERROR("Http requesterror.",1) ,请检查是否是在主线程中调用的翻译识别方法，请确保在主线程调用。

版本更新记录