ترجمة النص باستخدام حزمة تعلُّم الآلة على Android

يمكنك استخدام حزمة تعلّم الآلة لترجمة النص بين اللغات. يمكن لـ حزمة تعلّم الآلة الترجمة بين أكثر من 50 لغة.

تتيح واجهة برمجة التطبيقات هذه تنزيل النماذج المتغيّرة عند الطلب. راجِع هذا الدليل لمزيد من المعلومات.

للتجربة:

• يمكنك تجربة التطبيق النموذجي للاطّلاع على مثال على استخدام واجهة برمجة التطبيقات هذه.

قبل البدء

تتطلّب واجهة برمجة التطبيقات هذه المستوى 23 من واجهة برمجة تطبيقات Android أو مستوى أعلى. تأكَّد من أنّ ملف الإصدار في تطبيقك يستخدم قيمة minSdkVersion تبلغ 23 أو أعلى.

1. في ملف build.gradle على مستوى المشروع، تأكَّد من تضمين مستودع Maven من Google في كلّ من قسمَي buildscript و allprojects.
2. أضِف الاعتماديات لحزمة تعلّم الآلة على Android إلى ملف Gradle على مستوى التطبيق في وحدتك، والذي يكون عادةً app/build.gradle:

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

ترجمة سلسلة نصية

لترجمة سلسلة نصية بين لغتين:

1. أنشِئ كائن Translator ، واضبطه على اللغتَين المصدر والهدف:

   Kotlin

   // 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);

   إذا كنت لا تعرف لغة النص المُدخَل، يمكنك استخدام Language Identification API التي تمنحك رمز لغة. بعد ذلك، حوِّل الرمز إلى TranslateLanguage باستخدام TranslateLanguage.fromLanguageTag().

   تجنَّب الاحتفاظ بالكثير من نماذج اللغة على الجهاز في الوقت نفسه.

2. تأكَّد من تنزيل نموذج الترجمة المطلوب على الجهاز. لا تستدعِ الدالة translate() إلى أن تتأكّد من توفّر النموذج.

   Kotlin

   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.
               // ...
             }
           });

   يبلغ حجم نماذج اللغة حوالي 30 ميغابايت، لذا لا تنزِّلها بدون داعٍ، ولا تنزِّلها إلا باستخدام شبكة Wi-Fi ما لم يحدّد المستخدم خلاف ذلك. عليك أيضًا حذف النماذج غير الضرورية. راجِع المقالة إدارة نماذج الترجمة بشكلٍ صريح.

3. بعد التأكّد من تنزيل النموذج، مرِّر سلسلة نصية باللغة المصدر إلى translate():

   Kotlin

   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 مستخدَمًا.

   إذا كنت تستخدم أداة الترجمة في عنصر `Fragment` أو `AppCompatActivity`، إحدى الطرق السهلة للقيام بذلك هي استدعاء LifecycleOwner.getLifecycle() على `Fragment` أو `AppCompatActivity`، ثم استدعاء Lifecycle.addObserver. على سبيل المثال:

   Kotlin

   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`).

إدارة نماذج الترجمة بشكلٍ صريح

عند استخدام واجهة برمجة التطبيقات للترجمة كما هو موضّح أعلاه، تنزِّل حزمة تعلّم الآلة تلقائيًا نماذج الترجمة الخاصة باللغة على الجهاز حسب الحاجة. يمكنك أيضًا إدارة نماذج الترجمة التي تريد توفّرها على الجهاز بشكلٍ صريح باستخدام واجهة برمجة التطبيقات لإدارة نماذج الترجمة في ML Kit. قد يكون هذا مفيدًا إذا كنت تريد تنزيل النماذج مسبقًا أو حذف النماذج غير الضرورية من الجهاز.

Kotlin

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.
        }
    });