ML Kit Android 翻译模型下载状态管理指南

import com.google.mlkit.nl.translate.TranslateLanguage;
import com.google.mlkit.nl.translate.Translation;
import com.google.mlkit.nl.translate.Translator;
import com.google.mlkit.nl.translate.TranslatorOptions;
import com.google.mlkit.common.model.DownloadConditions;
import com.google.android.gms.tasks.OnSuccessListener;
import com.google.android.gms.tasks.OnFailureListener;
import androidx.annotation.NonNull;
import android.util.Log; // 用于日志输出

public class TranslationManager {

    private static final String TAG = "TranslationManager";
    private Translator translator; // 翻译器实例
    private boolean isModelDownloaded = false; // 标志位，用于追踪模型下载状态

    /**
     * 构造函数：初始化翻译器实例。
     * @param sourceLanguage 源语言，使用 TranslateLanguage 定义的常量。
     * @param targetLanguage 目标语言，使用 TranslateLanguage 定义的常量。
     */
    public TranslationManager(@TranslateLanguage.LanguageType String sourceLanguage,
                              @TranslateLanguage.LanguageType String targetLanguage) {
        // 1. 初始化翻译器选项，指定源语言和目标语言
        TranslatorOptions options =
            new TranslatorOptions.Builder()
                .setSourceLanguage(sourceLanguage)
                .setTargetLanguage(targetLanguage)
                .build();
        translator = Translation.getClient(options);
    }

    /**
     * 检查并下载翻译模型（如果需要）。
     * 此方法是异步的，通过回调接口通知模型状态。
     * @param onStatusCheckedCallback 回调接口，用于通知模型状态。
     */
    public void checkAndDownloadModel(ModelStatusCallback onStatusCheckedCallback) {
        // 2. 定义下载条件
        // 示例：仅在 Wi-Fi 环境下下载。根据需求可以调整或移除。
        DownloadConditions conditions = new DownloadConditions.Builder()
            .requireWifi()
            .build();

        // 3. 检查并下载模型
        translator.downloadModelIfNeeded(conditions)
            .addOnSuccessListener(
                new OnSuccessListener<Void>() {
                    @Override
                    public void onSuccess(Void v) {
                        // 模型下载成功或已存在于设备上
                        isModelDownloaded = true;
                        if (onStatusCheckedCallback != null) {
                            onStatusCheckedCallback.onModelReady(true);
                        }
                        Log.d(TAG, "Translation model for " + translator.getOptions().getSourceLanguage() +
                                   " to " + translator.getOptions().getTargetLanguage() +
                                   " is ready (downloaded or already exists).");
                    }
                })
            .addOnFailureListener(
                new OnFailureListener() {
                    @Override
                    public void onFailure(@NonNull Exception e) {
                        // 模型下载失败或发生其他内部错误
                        isModelDownloaded = false;
                        if (onStatusCheckedCallback != null) {
                            onStatusCheckedCallback.onModelReady(false);
                        }
                        Log.e(TAG, "Translation model download failed for " + translator.getOptions().getSourceLanguage() +
                                   " to " + translator.getOptions().getTargetLanguage() + ": " + e.getMessage(), e);
                    }
                });
    }

    /**
     * 获取当前模型下载状态。
     * 注意：此方法返回的是上次 `checkAndDownloadModel` 调用后的状态，
     * 若需实时状态，请重新调用 `checkAndDownloadModel`。
     * @return 如果模型已下载或已准备好，则为 true；否则为 false。
     */
    public boolean isModelReady() {
        return isModelDownloaded;
    }

    /**
     * 释放翻译器资源，避免内存泄漏。
     * 在 Activity 或 Fragment 的 onDestroy() 方法中调用。
     */
    public void releaseTranslator() {
        if (translator != null) {
            translator.close();
            Log.d(TAG, "Translator resources released.");
        }
    }

    /**
     * 定义一个回调接口，用于通知调用者模型状态。
     */
    public interface ModelStatusCallback {
        void onModelReady(boolean isReady);
    }
}

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.ImageView;
import com.google.mlkit.nl.translate.TranslateLanguage;

public class MyTranslationActivity extends AppCompatActivity {

    private TranslationManager englishGermanTranslationManager;
    private ImageView translationIcon; // 假设有一个 ImageView 用于显示翻译状态

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main); // 假设你的布局文件是 activity_main.xml

        translationIcon = findViewById(R.id.translation_icon); // 假设你的 ImageView ID 是 translation_icon

        // 初始化翻译管理器，例如用于英语到德语的翻译
        englishGermanTranslationManager = new TranslationManager(
            TranslateLanguage.ENGLISH, TranslateLanguage.GERMAN);

        // 检查并下载模型，并根据结果更新 UI
        englishGermanTranslationManager.checkAndDownloadModel(new TranslationManager.ModelStatusCallback() {
            @Override
            public void onModelReady(boolean isReady) {
                // UI 更新必须在主线程进行
                runOnUiThread(() -> {
                    if (isReady) {
                        translationIcon.setVisibility(View.VISIBLE);
                        // Log.d("MyActivity", "English-German translation model is ready. Icon shown.");
                    } else {
                        translationIcon.setVisibility(View.GONE);
                        // Log.d("MyActivity", "English-German translation model is NOT ready. Icon hidden.");
                    }
                });
            }
        });
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 确保在 Activity 销毁时释放翻译器资源
        if (englishGermanTranslationManager != null) {
            englishGermanTranslationManager.releaseTranslator();
        }
    }
}