แปลข้อความด้วย ML Kit บน iOS

คุณใช้ ML Kit เพื่อแปลข้อความระหว่างภาษาได้ ชุดอุปกรณ์ ML ขณะนี้ สนับสนุนการแปลระหว่าง 59 ภาษา

ก่อนเริ่มต้น

  1. หากยังไม่ได้เพิ่ม Firebase ลงในแอป ให้ดำเนินการดังนี้ ขั้นตอนในคู่มือเริ่มต้นใช้งาน
  2. รวมไลบรารี ML Kit ไว้ใน Podfile ดังนี้ 
    pod 'Firebase/MLNLTranslate', '6.25.0'
    หลังจากติดตั้งหรืออัปเดตพ็อดของโปรเจ็กต์แล้ว อย่าลืมเปิด Xcode โดยใช้ .xcworkspace
  3. ในแอป ให้นำเข้า Firebase ดังนี้

    Swift

    import Firebase

    Objective-C

    @import Firebase;

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

หากต้องการแปลสตริงระหว่าง 2 ภาษา ให้ทำดังนี้

  1. สร้างออบเจ็กต์ Translator โดยกำหนดค่าด้วยต้นทางและเป้าหมาย ภาษา:

    Swift

    // Create an English-German translator:
let options = TranslatorOptions(sourceLanguage: .en, targetLanguage: .de)
let englishGermanTranslator = NaturalLanguage.naturalLanguage().translator(options: options)

    Objective-C

    // Create an English-German translator:
FIRTranslatorOptions *options =
    [[FIRTranslatorOptions alloc] initWithSourceLanguage:FIRTranslateLanguageEN
                                          targetLanguage:FIRTranslateLanguageDE];
FIRTranslator *englishGermanTranslator =
    [[FIRNaturalLanguage naturalLanguage] translatorWithOptions:options];

    หากคุณไม่ทราบภาษาของข้อความที่ป้อน คุณสามารถใช้ภาษา API การระบุก่อน (แต่ต้องแน่ใจว่า อย่าเก็บโมเดลภาษาหลายรายการไว้ในอุปกรณ์พร้อมกัน)

  2. ตรวจดูว่าได้ดาวน์โหลดโมเดลการแปลที่กำหนดลงในอุปกรณ์แล้ว อย่าโทรหา translate(_:completion:) จนกว่าจะทราบว่าโมเดลพร้อมใช้งาน

    Swift

    let conditions = ModelDownloadConditions(
    allowsCellularAccess: false,
    allowsBackgroundDownloading: true
)
englishGermanTranslator.downloadModelIfNeeded(with: conditions) { error in
    guard error == nil else { return }

    // Model downloaded successfully. Okay to start translating.
}

    Objective-C

    FIRModelDownloadConditions *conditions =
    [[FIRModelDownloadConditions alloc] initWithAllowsCellularAccess:NO
                                         allowsBackgroundDownloading:YES];
[englishGermanTranslator downloadModelIfNeededWithConditions:conditions
                                                  completion:^(NSError *_Nullable error) {
  if (error != nil) {
    return;
  }
  // Model downloaded successfully. Okay to start translating.
}];

    โมเดลภาษามีขนาดประมาณ 30 MB ดังนั้นโปรดอย่าดาวน์โหลดโดยไม่จำเป็น และ ให้ดาวน์โหลดโดยใช้ Wi-Fi เท่านั้น ยกเว้นกรณีที่ผู้ใช้ระบุไว้เป็นอย่างอื่น คุณ ควรลบโมเดลที่ไม่จำเป็นออกด้วย ดูจัดการโมเดลการแปลอย่างชัดแจ้ง

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

    Swift

    englishGermanTranslator.translate(text) { translatedText, error in
    guard error == nil, let translatedText = translatedText else { return }

    // Translation succeeded.
}

    Objective-C

    [englishGermanTranslator translateText:text
                            completion:^(NSString *_Nullable translatedText,
                                         NSError *_Nullable error) {
  if (error != nil || translatedText == nil) {
    return;
  }

  // Translation succeeded.
}];

    ML Kit แปลข้อความเป็นภาษาเป้าหมายที่คุณกำหนดค่าไว้และ ผ่านข้อความที่แปลไปยังเครื่องจัดการการเสร็จสิ้น

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

เมื่อคุณใช้ API การแปลตามที่อธิบายไว้ข้างต้น ML Kit จะทำงานโดยอัตโนมัติ ดาวน์โหลดโมเดลการแปลเฉพาะภาษาลงในอุปกรณ์ตามที่จำเป็น คุณ ยังสามารถจัดการโมเดลการแปล ที่คุณต้องการให้มีอยู่ใน โดยใช้ API การจัดการโมเดลการแปลของ ML Kit ได้ ประเภท มีประโยชน์ในกรณีที่คุณต้องการดาวน์โหลดโมเดลล่วงหน้า หรือลบโมเดลที่ไม่จำเป็น จากอุปกรณ์

หากต้องการรับโมเดลการแปลที่จัดเก็บไว้ในอุปกรณ์ ให้ทำดังนี้

Swift

let localModels = ModelManager.modelManager().downloadedTranslateModels

Objective-C

NSSet<FIRTranslateRemoteModel *> *localModels =
    [FIRModelManager modelManager].downloadedTranslateModels;

วิธีลบโมเดล

Swift

// Delete the German model if it's on the device.
let deModel = TranslateRemoteModel.translateRemoteModel(language: .de)
ModelManager.modelManager().deleteDownloadedModel(deModel) { error in
    guard error == nil else { return }
    // Model deleted.
}

Objective-C

// Delete the German model if it's on the device.
FIRTranslateRemoteModel *deModel =
    [FIRTranslateRemoteModel translateRemoteModelWithLanguage:FIRTranslateLanguageDE];
[[FIRModelManager modelManager] deleteDownloadedModel:deModel
                                           completion:^(NSError * _Nullable error) {
                                               if (error != nil) {
                                                   return;
                                               }
                                               // Model deleted.
                                           }];

วิธีดาวน์โหลดโมเดล

Swift

// Download the French model.
let frModel = TranslateRemoteModel.translateRemoteModel(language: .fr)

// Keep a reference to the download progress so you can check that the model
// is available before you use it.
progress = ModelManager.modelManager().download(
    frModel,
    conditions: ModelDownloadConditions(
        allowsCellularAccess: false,
        allowsBackgroundDownloading: true
    )
)

หากต้องการรับสถานะการดาวน์โหลดจาก NotificationCenter ให้ลงทะเบียน ผู้สังเกตการณ์สำหรับfirebaseMLModelDownloadDidSucceedและ firebaseMLModelDownloadDidFail โปรดใช้การอ้างอิงที่ไม่รัดกุมไปยัง self ไว้ในบล็อกผู้สังเกตการณ์ เนื่องจากการดาวน์โหลด อาจใช้เวลาพอสมควร และ สามารถปล่อยอิสระเมื่อการดาวน์โหลดเสร็จสิ้น เช่น

NotificationCenter.default.addObserver(
    forName: .firebaseMLModelDownloadDidSucceed,
    object: nil,
    queue: nil
) { [weak self] notification in
    guard let strongSelf = self,
        let userInfo = notification.userInfo,
        let model = userInfo[ModelDownloadUserInfoKey.remoteModel.rawValue]
            as? TranslateRemoteModel,
        model == frModel
        else { return }
    // The model was downloaded and is available on the device
}

NotificationCenter.default.addObserver(
    forName: .firebaseMLModelDownloadDidFail,
    object: nil,
    queue: nil
) { [weak self] notification in
    guard let strongSelf = self,
        let userInfo = notification.userInfo,
        let model = userInfo[ModelDownloadUserInfoKey.remoteModel.rawValue]
            as? TranslateRemoteModel
        else { return }
    let error = userInfo[ModelDownloadUserInfoKey.error.rawValue]
    // ...
}

Objective-C

// Download the French model.
FIRModelDownloadConditions *conditions =
    [[FIRModelDownloadConditions alloc] initWithAllowsCellularAccess:NO
                                         allowsBackgroundDownloading:YES];
FIRTranslateRemoteModel *frModel =
    [FIRTranslateRemoteModel translateRemoteModelWithLanguage:FIRTranslateLanguageFR];

// Keep a reference to the download progress so you can check that the model
// is available before you use it.
self.downloadProgress = [[FIRModelManager modelManager] downloadModel:frModel
                                                           conditions:conditions];

หากต้องการรับสถานะการดาวน์โหลดจาก NSNotificationCenter ให้ลงทะเบียน ผู้สังเกตการณ์สำหรับFIRModelDownloadDidSucceedNotificationและ FIRModelDownloadDidFailNotification อย่าลืมใช้การอ้างอิงที่ไม่รัดกุมเพื่อ self ในบล็อกผู้สังเกตการณ์ เนื่องจากการดาวน์โหลดอาจใช้เวลาสักครู่ และ ออบเจ็กต์ต้นฉบับสามารถได้รับการปล่อยว่างเมื่อการดาวน์โหลดเสร็จสิ้น

__block MyViewController *weakSelf = self;

[NSNotificationCenter.defaultCenter
 addObserverForName:FIRModelDownloadDidSucceedNotification
 object:nil
 queue:nil
 usingBlock:^(NSNotification * _Nonnull note) {
     if (weakSelf == nil | note.userInfo == nil) {
         return;
     }

     FIRTranslateRemoteModel *model = note.userInfo[FIRModelDownloadUserInfoKeyRemoteModel];
     if ([model isKindOfClass:[FIRTranslateRemoteModel class]]
         && model == frModel) {
         // The model was downloaded and is available on the device
     }
 }];

[NSNotificationCenter.defaultCenter
 addObserverForName:FIRModelDownloadDidFailNotification
 object:nil
 queue:nil
 usingBlock:^(NSNotification * _Nonnull note) {
     if (weakSelf == nil | note.userInfo == nil) {
         return;
     }

     NSError *error = note.userInfo[FIRModelDownloadUserInfoKeyError];
 }];