ترجمه متن با ML Kit در اندروید

شما می‌توانید از ML Kit برای ترجمه متن بین زبان‌ها استفاده کنید. ML Kit می‌تواند بیش از ۵۰ زبان را ترجمه کند.

امتحانش کن.

• برای مشاهده‌ی نحوه‌ی استفاده از این API، با برنامه‌ی نمونه کار کنید.

قبل از اینکه شروع کنی

1. در فایل build.gradle سطح پروژه خود، مطمئن شوید که مخزن Maven گوگل را هم در بخش‌های buildscript و هم allprojects خود وارد کرده‌اید.
2. وابستگی‌های کتابخانه‌های اندروید ML Kit را به فایل gradle سطح app ماژول خود که معمولاً app/build.gradle است، اضافه کنید:

   dependencies {
     // ...
   
     implementation 'com.google.mlkit:translate:17.0.3'
   }

ترجمه یک رشته متن

برای ترجمه یک رشته بین دو زبان:

1. یک شیء Translator ایجاد کنید و آن را با زبان‌های مبدا و مقصد پیکربندی کنید:

   کاتلین

   // Create an English-German translator:
   val options = TranslatorOptions.Builder()
       .setSourceLanguage(TranslateLanguage.ENGLISH)
       .setTargetLanguage(TranslateLanguage.GERMAN)
       .build()
   val englishGermanTranslator = Translation.getClient(options)

   جاوا

   // Create an English-German translator:
   TranslatorOptions options =
       new TranslatorOptions.Builder()
           .setSourceLanguage(TranslateLanguage.ENGLISH)
           .setTargetLanguage(TranslateLanguage.GERMAN)
           .build();
   final Translator englishGermanTranslator =
       Translation.getClient(options);

   اگر زبان متن ورودی را نمی‌دانید، می‌توانید از API شناسایی زبان استفاده کنید که یک برچسب زبان به شما می‌دهد. سپس با استفاده از TranslateLanguage.fromLanguageTag() برچسب را به TranslateLanguage تبدیل کنید.

   از نگه‌داری همزمان تعداد زیادی مدل زبان روی دستگاه خودداری کنید.

2. مطمئن شوید که مدل ترجمه مورد نیاز در دستگاه دانلود شده است. تا زمانی که از در دسترس بودن مدل مطمئن نشده‌اید translate() فراخوانی نکنید.

   کاتلین

   var conditions = DownloadConditions.Builder()
       .requireWifi()
       .build()
   englishGermanTranslator.downloadModelIfNeeded(conditions)
       .addOnSuccessListener {
           // Model downloaded successfully. Okay to start translating.
           // (Set a flag, unhide the translation UI, etc.)
       }
       .addOnFailureListener { exception ->
           // Model couldn’t be downloaded or other internal error.
           // ...
       }

   جاوا

   DownloadConditions conditions = new DownloadConditions.Builder()
       .requireWifi()
       .build();
   englishGermanTranslator.downloadModelIfNeeded(conditions)
       .addOnSuccessListener(
           new OnSuccessListener() {
             @Override
             public void onSuccess(Void v) {
               // Model downloaded successfully. Okay to start translating.
               // (Set a flag, unhide the translation UI, etc.)
             }
           })
       .addOnFailureListener(
           new OnFailureListener() {
             @Override
             public void onFailure(@NonNull Exception e) {
               // Model couldn’t be downloaded or other internal error.
               // ...
             }
           });

   مدل‌های زبان حدود ۳۰ مگابایت حجم دارند، بنابراین آنها را بی‌جهت دانلود نکنید و فقط با استفاده از وای‌فای دانلود کنید، مگر اینکه کاربر طور دیگری تعیین کرده باشد. همچنین باید مدل‌های غیرضروری را حذف کنید. به مدیریت صریح مدل‌های ترجمه مراجعه کنید.

3. پس از تأیید دانلود مدل، یک رشته متن به زبان مبدا به translate() ارسال کنید:

   کاتلین

   englishGermanTranslator.translate(text)
       .addOnSuccessListener { translatedText ->
           // Translation successful.
       }
       .addOnFailureListener { exception ->
            // Error.
            // ...
       }

   جاوا

   englishGermanTranslator.translate(text)
       .addOnSuccessListener(
           new OnSuccessListener() {
             @Override
             public void onSuccess(@NonNull String translatedText) {
               // Translation successful.
             }
           })
       .addOnFailureListener(
           new OnFailureListener() {
             @Override
             public void onFailure(@NonNull Exception e) {
               // Error.
               // ...
             }
           });

   متن ترجمه شده، به زبان مقصدی که شما پیکربندی کرده‌اید، به شنونده‌ی موفقیت ارسال می‌شود.

4. مطمئن شوید که متد close() زمانی فراخوانی می‌شود که دیگر از شیء Translator استفاده نخواهد شد.

   اگر از یک مترجم در یک فرگمنت یا AppCompatActivity استفاده می‌کنید، یک راه آسان برای انجام این کار فراخوانی LifecycleOwner.getLifecycle() در فرگمنت یا AppCompatActivity و سپس فراخوانی Lifecycle.addObserver است. برای مثال:

   کاتلین

   val options = ...
   val translator = Translation.getClient(options)
   getLifecycle().addObserver(translator)

   جاوا

   TranslatorOptions options = ...
   Translator translator = Translation.getClient(options);
   getLifecycle().addObserver(translator);
   ... use translator ...

   توجه داشته باشید که این فرض را بر این می‌گذارد که کد درون کلاسی است که LifecycleOwner را پیاده‌سازی می‌کند (مثلاً یک Fragment یا AppCompatActivity).

مدیریت صریح مدل‌های ترجمه

وقتی از API ترجمه همانطور که در بالا توضیح داده شد استفاده می‌کنید، ML Kit به طور خودکار مدل‌های ترجمه مختص به زبان را در صورت نیاز روی دستگاه دانلود می‌کند. همچنین می‌توانید با استفاده از API مدیریت مدل ترجمه ML Kit، مدل‌های ترجمه‌ای را که می‌خواهید روی دستگاه موجود باشند، به طور صریح مدیریت کنید. این می‌تواند در صورتی مفید باشد که بخواهید مدل‌ها را از قبل دانلود کنید یا مدل‌های غیرضروری را از دستگاه حذف کنید.

val modelManager = RemoteModelManager.getInstance()

// Get translation models stored on the device.
modelManager.getDownloadedModels(TranslateRemoteModel::class.java)
    .addOnSuccessListener { models ->
        // ...
    }
    .addOnFailureListener {
        // Error.
    }

// Delete the German model if it's on the device.
val germanModel = TranslateRemoteModel.Builder(TranslateLanguage.GERMAN).build()
modelManager.deleteDownloadedModel(germanModel)
    .addOnSuccessListener {
        // Model deleted.
    }
    .addOnFailureListener {
        // Error.
    }

// Download the French model.
val frenchModel = TranslateRemoteModel.Builder(TranslateLanguage.FRENCH).build()
val conditions = DownloadConditions.Builder()
    .requireWifi()
    .build()
modelManager.download(frenchModel, conditions)
    .addOnSuccessListener {
        // Model downloaded.
    }
    .addOnFailureListener {
        // Error.
    }

RemoteModelManager modelManager = RemoteModelManager.getInstance();

// Get translation models stored on the device.
modelManager.getDownloadedModels(TranslateRemoteModel.class)
    .addOnSuccessListener(new OnSuccessListener<Set>() {
        @Override
        public void onSuccess(Set models) {
            // ...
        }
    })
    .addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            // Error.
        }
    });

// Delete the German model if it's on the device.
TranslateRemoteModel germanModel =
        new TranslateRemoteModel.Builder(TranslateLanguage.GERMAN).build();
modelManager.deleteDownloadedModel(germanModel)
    .addOnSuccessListener(new OnSuccessListener() {
        @Override
        public void onSuccess(Void v) {
            // Model deleted.
        }
    })
    .addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            // Error.
        }
    });

// Download the French model.
TranslateRemoteModel frenchModel =
        new TranslateRemoteModel.Builder(TranslateLanguage.FRENCH).build();
DownloadConditions conditions = new DownloadConditions.Builder()
    .requireWifi()
    .build();
modelManager.download(frenchModel, conditions)
    .addOnSuccessListener(new OnSuccessListener() {
        @Override
        public void onSuccess(Void v) {
            // Model downloaded.
        }
    })
    .addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            // Error.
        }
    });