MLKitTranslate 架構參考資料

MLKTranslator

@interface MLKTranslator : NSObject

這個類別可翻譯指定的輸入文字。

• +translatorWithOptions:

  針對指定選項取得 Translator 例項。此方法屬於執行緒安全。

  聲明

  Objective-C

  + (nonnull MLKTranslator *)translatorWithOptions:
      (nonnull MLKTranslatorOptions *)options;

  參數

  options

  供譯者的選項。

  傳回值

  提供含指定選項翻譯的 Translator 執行個體。

• -translateText:completion:

  將指定文字從來源語言翻譯成目標語言。

  如果模型檔案尚未下載，這個方法會傳回錯誤。

  聲明

  Objective-C

  - (void)translateText:(nonnull NSString *)text
             completion:(nonnull MLKTranslatorCallback)completion;

  參數

  text	原文語言的字串。
  completion	用於在主要佇列中回呼翻譯結果或錯誤的處理常式。

• -downloadModelIfNeededWithCompletion:

  下載翻譯所需的模型檔案 (如果尚未下載)。

  聲明

  Objective-C

  - (void)downloadModelIfNeededWithCompletion:
      (nonnull MLKTranslatorDownloadModelIfNeededCallback)completion;

  參數

  completion

  用於在主要佇列上回呼的處理常式 (如果有錯誤的話)。

• -downloadModelIfNeededWithConditions:completion:

  在符合特定條件時，下載翻譯作業所需的模型檔案。如果是模型 已完成下載，無需進行額外作業。

  聲明

  Objective-C

  - (void)
      downloadModelIfNeededWithConditions:
          (nonnull MLKModelDownloadConditions *)conditions
                               completion:
                                   (nonnull
                                        MLKTranslatorDownloadModelIfNeededCallback)
                                       completion;

  參數

  conditions	翻譯模型的下載條件。
  completion	用於在主要佇列上回呼的處理常式 (如果有錯誤的話)。

• -init

  無法使用。

  聲明

  Objective-C

  - (nonnull instancetype)init;