機器學習服務助應用內文字語種線上和離線檢測

HMSCore發表於2022-06-13
機器學習

當使用者有跨語種交流或內容翻譯的需求時，應用需要能自動檢測文字的語種再進行翻譯。

HMS Core機器學習服務的語種檢測服務提供線上語種檢測和離線語種檢測，既支援檢測單語種文字，也支援檢測混合語種文字，涵蓋南非荷蘭語、阿拉伯語等百種語言。接入語種檢測服務，App可以輕鬆實現翻譯語種檢測、網頁語種檢測，混合語種場景中語種檢測等，幫助App提升使用者體驗。

語種檢測流程

輸入文字，機器學習服務語種對該文字自動進行語種進行檢測，然後返回對應語種編碼和相應的置信度，或者返回一個置信度最高的語種編碼給開發者的應用。最終在開發app頁面呈現出翻譯出的文字。

效果演示

1.開發準備

在進行開發前需要配置HMS Core SDK的Maven倉地址

repositories {
    maven { 
url'https://cmc.centralrepo.rnd.huawei.com/artifactory/product_maven/' }
}

整合線上語種檢測服務SDK，示例程式碼如下

dependencies{
    implementation 'com.huawei.hms:ml-computer-language-detection:3.4.0.301'
}

2. 編輯工程整合

2.1設定應用的鑑權資訊

可以通過api_key或者Access Token來設定應用鑑權資訊。

通過setAccessToken方法設定Access Token，在應用啟動時初始化設定一次即可，無需多次設定。
MLApplication.getInstance().setAccessToken("your access token");

通過setApiKey方法設定api_key，在應用啟動時初始化設定一次即可，無需多次設定。
MLApplication.getInstance().setApiKey("your ApiKey");

2.2 建立語種檢測器

// 方式一：使用預設的引數配置建立語種檢測器。
MLRemoteLangDetector mlRemoteLangDetector = MLLangDetectorFactory.getInstance()
    .getRemoteLangDetector();
// 方式二：使用自定義的引數配置建立語種檢測器。
MLRemoteLangDetectorSetting setting = new MLRemoteLangDetectorSetting.Factory()
    // 設定語種檢測的最低置信度閾值。
    .setTrustedThreshold(0.01f)
    .create();
MLRemoteLangDetector mlRemoteLangDetector = MLLangDetectorFactory.getInstance()
    .getRemoteLangDetector(setting);

2.3 進行語種檢測

非同步方法示例程式碼

// 方式一：返回多個語種檢測結果，包括語種編碼以及置信度，sourceText表示待檢測的文字，長度需小於5000個字元。
Task<List<MLDetectedLang>> probabilityDetectTask = mlRemoteLangDetector.probabilityDetect(sourceText);
probabilityDetectTask.addOnSuccessListener(new OnSuccessListener<List<MLDetectedLang>>() {
    @Override
    public void onSuccess(List<MLDetectedLang> result) {
        // 成功的處理邏輯。
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
        // 失敗的處理邏輯。
        // Recognition failure.
        try {
            MLException mlException = (MLException)e;
            // 獲取錯誤碼，開發者可以對錯誤碼進行處理，根據錯誤碼進行差異化的頁面提示。
            int errorCode = mlException.getErrCode();
            // 獲取報錯資訊，開發者可以結合錯誤碼，快速定位問題。
            String errorMessage = mlException.getMessage();
        } catch (Exception error) {
           // 轉換錯誤處理。
        }
    }
});
// 方式二：返回置信度最高的語種編碼，sourceText表示待檢測的文字，長度需小於5000個字元。
Task<String> firstBestDetectTask = mlRemoteLangDetector.firstBestDetect(sourceText);
firstBestDetectTask.addOnSuccessListener(new OnSuccessListener<String>() {
    @Override
    public void onSuccess(String s) {
        // 成功的處理邏輯。
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
        // 失敗的處理邏輯。
        // Recognition failure.
        try {
            MLException mlException = (MLException)e;
            // 獲取錯誤碼，開發者可以對錯誤碼進行處理，根據錯誤碼進行差異化的頁面提示。
            int errorCode = mlException.getErrCode();
            // 獲取報錯資訊，開發者可以結合錯誤碼，快速定位問題。
            String errorMessage = mlException.getMessage();
        } catch (Exception error) {
            // 轉換錯誤處理。
        }
    }
});

同步方法示例程式碼

// 方式一：返回多個語種檢測結果，包括語種編碼以及置信度，sourceText表示待檢測的文字，長度需小於5000個字元。
try {
    List<MLDetectedLang> result= mlRemoteLangDetector.syncProbabilityDetect(sourceText);
} catch (MLException mlException) {
    // 失敗的處理邏輯。
    // 獲取錯誤碼，開發者可以對錯誤碼進行處理，根據錯誤碼進行差異化的頁面提示。
    int errorCode = mlException.getErrCode();
    // 獲取報錯資訊，開發者可以結合錯誤碼，快速定位問題。
    String errorMessage = mlException.getMessage();
}
// 方式二：返回置信度最高的語種編碼，sourceText表示待檢測的文字，長度需小於5000個字元。
try {
    String language = mlRemoteLangDetector.syncFirstBestDetect(sourceText);
} catch (MLException mlException) {
    // 失敗的處理邏輯。
    // 獲取錯誤碼，開發者可以對錯誤碼進行處理，根據錯誤碼進行差異化的頁面提示。
    int errorCode = mlException.getErrCode();
    // 獲取報錯資訊，開發者可以結合錯誤碼，快速定位問題。
    String errorMessage = mlException.getMessage();
}

2.4 檢測完成後，釋放資源。

if (mlRemoteLangDetector != null) {
    mlRemoteLangDetector.stop();
}

語種檢測功能包含端側和雲側，以上示例僅為雲側功能。

瞭解更多詳情>>

訪問華為開發者聯盟官網
獲取開發指導文件
華為移動服務開源倉庫地址：GitHub、Gitee

關注我們，第一時間瞭解 HMS Core 最新技術資訊~

相關文章