语音翻译-语音翻译Android_SDK文档-有道智云AI开放平台

语音翻译 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	翻译相关sdk基础库（必选）
online_auth.jar	翻译相关sdk基础库（必选）
zhiyun_offline_common.jar	翻译相关sdk基础库（必选）
YoudaoTranslateOnline_v2.0.1.jar	在线翻译sdk（必选）
YoudaotranslateDemo	sdk使用demo

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

(1) SDK包导入

请在工程文件根目录下创建一个名为 libs 的子目录(有的话则不需要创建)，并将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状态 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 获取网络信息状态，如当前的网络连接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 读取手机状态 phone group -->
<uses-permission android:name="android.permission.READ_PHONE_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 中 SpeachTranslateDemoActivity 的使用

(1) 参数说明

格式支持：wav（不压缩、pcm编码）。

采样率：16k。

编码：16bit位深的单声道

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

(2) 构造语音翻译查词对象

     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)//超时时间
        .build();

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

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

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

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

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");