Interpreter.Options

公開靜態類別 Interpreter.Options

控制執行階段解譯器行為的選項類別。

公用建構函式

選項()

公用方法

Interpreter.Options
addDelegate(委派代表)
新增要在建立翻譯時套用的 Delegate
Interpreter.Options
addDelegateFactory(DelegateFactory委派 Factory)
新增 DelegateFactory,系統會叫用此項目,在解譯器建立期間套用已建立的 Delegate
Interpreter.Options
setAllowBufferHandleOutput(布林值允許)
進階:在允許緩衝區控制代碼的情況下設定。
Interpreter.Options
setAllowFp16PrecisionForFp32(允許布林值)
此方法已淘汰。建議使用 NnApiDelegate.Options#setAllowFp16(boolean enable)
Interpreter.Options
setCancellable(允許布林值)
進階:設定是否可取消翻譯器。
Interpreter.Options
setNumThreads(int numThreads)
設定用於支援多執行緒的運算的執行緒數量。
Interpreter.Options
setRuntime(InterpreterApi.Options.TfLiteRuntime 執行階段)
指定要從哪裡取得 TF Lite 執行階段實作。
Interpreter.Options
setUseNNAPI(boolean useNNAPI)
設定是否使用 NN API (如果有的話) 來執行運算。
Interpreter.Options
setUseXNNPACK(布林值 useXNNPACK)
啟用或停用經過最佳化的 CPU 核心組合 (由 XNNPACK 提供)。

繼承的方法

公用建構函式

public 選項 ()

public 選項 (InterpreterApi.Options 選項)

參數
選項

公用方法

public Interpreter.Options addDelegate (Delegate 委派)

新增要在建立翻譯時套用的 Delegate

透過 addDelegateFactory(DelegateFactory) 新增的 DelegateFactory 建立任何委派代表之前,系統會套用在這裡新增的委派代表。

請注意,Google Play 服務中的 TF Lite (請參閱 setRuntime(InterpreterApi.Options.TfLiteRuntime)) 不支援外部 (開發人員提供) 委派項目,因此在 Google Play 服務中使用 TF Lite 時,無法在這裡新增 ERROR(/NnApiDelegate) 以外的 Delegate

參數
delegate

public Interpreter.Options addDelegateFactory (DelegateFactory 委派工廠)

新增 DelegateFactory,系統會叫用此項目,在建立翻譯模式期間套用已建立的 Delegate

透過 addDelegate(Delegate) 新增的任何委派代表之後,系統會套用在這裡新增的委派工廠委派代表。

參數
delegateFactory

public Interpreter.Options setAllowBufferHandleOutput (boolean allow)

進階:在允許緩衝區控制代碼的情況下設定。

如果 Delegate 支援硬體加速,根據預設,在 CPU 分配的張量緩衝區中提供輸出張量資料。如果用戶端可以直接使用緩衝區控制代碼 (例如從 OpenGL 紋理讀取輸出內容),可將這個旗標設為「false」,避免資料複製到 CPU 緩衝區。委派說明文件應指出這項功能是否受支援,以及使用方式。

警告:此為實驗介面,可能會有變動。

參數
allow

public Interpreter.Options setAllowFp16PrecisionForFp32 (boolean allow)

此方法已淘汰
建議使用 NnApiDelegate.Options#setAllowFp16(布林值啟用)

設定是否允許 FP32 計算時是否允許 float16 精確度。預設值為 false (不允許)。

參數
allow

public Interpreter.Options setCancellable (boolean allow)

進階:設定是否可取消翻譯器。

解譯器可能會提供實驗性 API setCancelled(boolean)。 如果這個解譯器可以取消且叫用這類方法,取消標記會設為 true。解譯器會檢查運算元件叫用之間的旗標,如果是 true,翻譯器就會停止執行。解譯器會維持取消狀態,直到 setCancelled(false) 明確「已取消取消」。

參數
allow

public Interpreter.Options setNumThreads (int numThreads)

設定用於支援多執行緒的運算的執行緒數量。

numThreads 應為 >= -1。將 numThreads 設為 0 會停用多執行緒的效果,相當於將 numThreads 設為 1。如果未指定或設為 -1 值,則使用的執行緒數量將由實作定義,視平台而定。

參數
numThreads

公開Interpreter.Options setRuntimeInterpreterApi.Options.TfLiteRuntime

指定要從哪裡取得 TF Lite 執行階段實作。

參數
執行階段

public Interpreter.Options setUseNNAPI (boolean useNNAPI)

設定是否使用 NN API (如果有的話) 來執行運算。預設值為 False (停用)。

參數
useNNAPI

public Interpreter.Options setUseXNNPACK (boolean useXNNPACK)

啟用或停用經過最佳化的 CPU 核心組合 (由 XNNPACK 提供)。預設為啟用。

參數
useXNNPACK