แปลข้อความด้วย ML Kit ใน Android

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

คุณใช้ ML Kit เพื่อแปลข้อความระหว่างภาษาได้ ML Kit แปลได้มากกว่า 50 ภาษา

ลองใช้งาน

ข้อควรทราบก่อนที่จะเริ่มต้น

  1. ในไฟล์ build.gradle ระดับโปรเจ็กต์ อย่าลืมใส่ที่เก็บ Maven ของ Google ทั้งใน buildscript และ allprojects
  2. เพิ่มทรัพยากร Dependency สําหรับไลบรารี Android ของ ML Kit ไปยังไฟล์ Gradle ระดับแอปของโมดูล ซึ่งปกติจะเป็น app/build.gradle
    dependencies {
      // ...
    
      implementation 'com.google.mlkit:translate:17.0.1'
    }
    

แปลสตริงข้อความ

วิธีแปลสตริงระหว่าง 2 ภาษา

  1. สร้างออบเจ็กต์ Translator และกําหนดค่าด้วยภาษาต้นฉบับและภาษาเป้าหมาย ดังนี้

    Kotlin

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

    Java

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

    หากไม่ทราบภาษาของข้อความที่ป้อน ให้ใช้ Language Identization 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.
            // ...
        }

    Java

    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 MB ดังนั้น ห้ามดาวน์โหลดไม่จําเป็นและต้องดาวน์โหลดผ่าน Wi-Fi เท่านั้น เว้นแต่ว่าผู้ใช้จะระบุไว้เป็นอย่างอื่น คุณควรลบโมเดลที่ไม่จําเป็นออกด้วย โปรดดูหัวข้อจัดการโมเดลการแปลอย่างชัดแจ้ง

  3. หลังจากยืนยันว่าดาวน์โหลดโมเดลแล้ว ให้ส่งสตริงข้อความในภาษาต้นฉบับไปยัง translate() ดังนี้

    Kotlin

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

    Java

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

    ระบบจะส่งข้อความที่แปลในภาษาเป้าหมายที่กําหนดค่าไว้ไปยัง Listener ความสําเร็จ

  4. ตรวจสอบว่าเรียกเมธอด close() เมื่อไม่ได้ใช้ออบเจ็กต์ Translator อีกต่อไป

    หากคุณใช้เครื่องมือแปลภาษาใน Fragment หรือ AppCompatActivity วิธีง่ายๆ คือเรียกใช้ LifecycleOwner.getLifecycle() ใน Fragment หรือ AppCompatActivity แล้วเรียกใช้ Lifecycle.addObserver เช่น

    Kotlin

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

    Java

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

    โปรดทราบว่าโค้ดนี้ถือว่าโค้ดอยู่ในคลาสที่ติดตั้งใช้งาน LifeLifeOwner (เช่น Fragment หรือ AppCompatActivity)

จัดการโมเดลการแปลอย่างชัดแจ้ง

เมื่อคุณใช้ API การแปลตามที่อธิบายไว้ข้างต้น ML Kit จะดาวน์โหลดโมเดลการแปลเฉพาะภาษาลงในอุปกรณ์ตามที่จําเป็นโดยอัตโนมัติ นอกจากนี้ คุณยังจัดการโมเดลการแปลที่ต้องการให้พร้อมใช้งานบนอุปกรณ์อย่างชัดแจ้งได้โดยใช้ API การจัดการโมเดลการแปลของ 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.
    }

Java

RemoteModelManager modelManager = RemoteModelManager.getInstance();

// Get translation models stored on the device.
modelManager.getDownloadedModels(TranslateRemoteModel.class)
    .addOnSuccessListener(new OnSuccessListener>() {
        @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.
        }
    });