語(yǔ)音翻譯 Android SDK 簡(jiǎn)介

概述

(1) 概念解釋

語(yǔ)音翻譯：將一段源語(yǔ)言音頻文件轉(zhuǎn)換成目標(biāo)語(yǔ)言文本/語(yǔ)音，大大減輕傳統(tǒng)文本翻譯的讀寫成本，翻譯更輕松

(2) 說明

Hi，您好，歡迎使用有道智云語(yǔ)音翻譯Android SDK。

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

如果您有與我們商務(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)用，并綁定語(yǔ)音翻譯實(shí)例；如果您還沒有，請(qǐng)按照新手指南 操作。
平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測(cè)試所用，具體資費(fèi)規(guī)則詳見 語(yǔ)音翻譯服務(wù)報(bào)價(jià) 。

功能介紹

有道語(yǔ)音翻譯SDK是對(duì)有道在線語(yǔ)音翻譯接口服務(wù)的封裝。提供給開發(fā)者快速的接入方式；同時(shí)提供數(shù)據(jù)統(tǒng)計(jì)服務(wù)，方便開發(fā)者了解用戶語(yǔ)音翻譯使用情況。

兼容性

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

語(yǔ)音翻譯 Android SDK集成指南

集成前提

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

集成步驟

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

說明：無論使用何種功能，都需要加入 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位深的單聲道

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

(2) 構(gòu)造語(yǔ)音翻譯查詞對(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)//輸出語(yǔ)音格式，支持wav
        .voice(SpeechTranslateParameters.VOICE_GIRL_US)//輸出聲音，支持美式女生、美式男生、英式女生、英式男生
        .timeout(100000)//超時(shí)時(shí)間
        .build();

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

通過SpeechTranslate，設(shè)置上一步構(gòu)造的查詞對(duì)象，調(diào)用lookup方法傳入語(yǔ)音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");

語(yǔ)音翻譯 Android SDK 簡(jiǎn)介

概述

(1) 概念解釋

語(yǔ)音翻譯：將一段源語(yǔ)言音頻文件轉(zhuǎn)換成目標(biāo)語(yǔ)言文本/語(yǔ)音，大大減輕傳統(tǒng)文本翻譯的讀寫成本，翻譯更輕松

(2) 說明

Hi，您好，歡迎使用有道智云語(yǔ)音翻譯Android SDK。

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

如果您有與我們商務(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)用，并綁定語(yǔ)音翻譯實(shí)例；如果您還沒有，請(qǐng)按照新手指南 操作。
平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測(cè)試所用，具體資費(fèi)規(guī)則詳見 語(yǔ)音翻譯服務(wù)報(bào)價(jià) 。

功能介紹

有道語(yǔ)音翻譯SDK是對(duì)有道在線語(yǔ)音翻譯接口服務(wù)的封裝。提供給開發(fā)者快速的接入方式；同時(shí)提供數(shù)據(jù)統(tǒng)計(jì)服務(wù)，方便開發(fā)者了解用戶語(yǔ)音翻譯使用情況。

兼容性

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

語(yǔ)音翻譯 Android SDK集成指南

集成前提

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

集成步驟

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

說明：無論使用何種功能，都需要加入 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位深的單聲道

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

(2) 構(gòu)造語(yǔ)音翻譯查詞對(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)//輸出語(yǔ)音格式，支持wav
        .voice(SpeechTranslateParameters.VOICE_GIRL_US)//輸出聲音，支持美式女生、美式男生、英式女生、英式男生
        .timeout(100000)//超時(shí)時(shí)間
        .build();

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

通過SpeechTranslate，設(shè)置上一步構(gòu)造的查詞對(duì)象，調(diào)用lookup方法傳入語(yǔ)音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");

支持語(yǔ)言

注意

1. 越南語(yǔ)和印尼語(yǔ)目前只支持和中文的互譯。
2. 支持自動(dòng)識(shí)別的語(yǔ)種包括：中文、英文。
3. 若列表語(yǔ)言出現(xiàn)不支持的問題，請(qǐng)參考產(chǎn)品定價(jià)列表語(yǔ)種互譯的限制

錯(cuò)誤代碼列表

常見問題及注意事項(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)用。

版本更新記錄

注意

1. 越南語(yǔ)和印尼語(yǔ)目前只支持和中文的互譯。
2. 支持自動(dòng)識(shí)別的語(yǔ)種包括：中文、英文。

錯(cuò)誤代碼列表

常見問題及注意事項(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)用。

版本更新記錄