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

این صفحه نسخه قدیمی از Translation APIکه بخشی از ML Kit برای Firebase بود. توسعه این API به SDK مستقل ML Kit منتقل شده است که می‌توانید با یا بدون Firebase از آن استفاده کنید. اطلاعات بیشتر .

ببینید Translate text with ML Kit on Android برای دریافت آخرین مستندات.

شما می‌توانید از ML Kit برای ترجمه متن بین زبان‌ها استفاده کنید. ML Kit در حال حاضر از ترجمه بین ۵۹ زبان پشتیبانی می‌کند.

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

1. اگر هنوز Firebase را به پروژه اندروید خود اضافه نکرده‌اید، آن را اضافه کنید.
2. وابستگی‌های کتابخانه‌های اندروید ML Kit را به فایل Gradle ماژول (سطح برنامه) خود (معمولاً app/build.gradle ) اضافه کنید:

   apply plugin: 'com.android.application'
   apply plugin: 'com.google.gms.google-services'
   
   dependencies {
     // ...
   
     implementation 'com.google.firebase:firebase-ml-natural-language:22.0.0'
     implementation 'com.google.firebase:firebase-ml-natural-language-translate-model:20.0.8'
   }

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

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

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

   Java

   // Create an English-German translator:
   FirebaseTranslatorOptions options =
           new FirebaseTranslatorOptions.Builder()
                   .setSourceLanguage(FirebaseTranslateLanguage.EN)
                   .setTargetLanguage(FirebaseTranslateLanguage.DE)
                   .build();
   final FirebaseTranslator englishGermanTranslator =
           FirebaseNaturalLanguage.getInstance().getTranslator(options);
   

   Kotlin

   // Create an English-German translator:
   val options = FirebaseTranslatorOptions.Builder()
           .setSourceLanguage(FirebaseTranslateLanguage.EN)
           .setTargetLanguage(FirebaseTranslateLanguage.DE)
           .build()
   val englishGermanTranslator = FirebaseNaturalLanguage.getInstance().getTranslator(options)
   

   اگر زبان متن ورودی را نمی‌دانید، می‌توانید ابتدا از API شناسایی زبان استفاده کنید. (اما مطمئن شوید که مدل‌های زبانی زیادی را به طور همزمان روی دستگاه نگه نمی‌دارید.)

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

   Java

   FirebaseModelDownloadConditions conditions = new FirebaseModelDownloadConditions.Builder()
       .requireWifi()
       .build();
   englishGermanTranslator.downloadModelIfNeeded(conditions)
         .addOnSuccessListener(
             new OnSuccessListener<Void>() {
               @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.
                 // ...
               }
             });
   

   Kotlin

   englishGermanTranslator.downloadModelIfNeeded()
           .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.
               // ...
           }
   

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

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

   Java

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

   Kotlin

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

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

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

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

Java

FirebaseModelManager modelManager = FirebaseModelManager.getInstance();

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

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

// Download the French model.
FirebaseTranslateRemoteModel frModel =
        new FirebaseTranslateRemoteModel.Builder(FirebaseTranslateLanguage.FR).build();
FirebaseModelDownloadConditions conditions = new FirebaseModelDownloadConditions.Builder()
        .requireWifi()
        .build();
modelManager.download(frModel, conditions)
        .addOnSuccessListener(new OnSuccessListener<Void>() {
            @Override
            public void onSuccess(Void v) {
                // Model downloaded.
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                // Error.
            }
        });

Kotlin

val modelManager = FirebaseModelManager.getInstance()

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

// Delete the German model if it's on the device.
val deModel = FirebaseTranslateRemoteModel.Builder(FirebaseTranslateLanguage.DE).build()
modelManager.deleteDownloadedModel(deModel)
    .addOnSuccessListener {
        // Model deleted.
    }
    .addOnFailureListener {
        // Error.
    }

// Download the French model.
val frModel = FirebaseTranslateRemoteModel.Builder(FirebaseTranslateLanguage.FR).build()
val conditions = FirebaseModelDownloadConditions.Builder()
    .requireWifi()
    .build()
modelManager.download(frModel, conditions)
    .addOnSuccessListener {
        // Model downloaded.
    }
    .addOnFailureListener {
        // Error.
    }