Interpreter.Options

คลาสแบบคงที่สาธารณะ Interpreter.Options

คลาสตัวเลือกสำหรับการควบคุมลักษณะการทำงานของอินเตอร์พรีเตอร์รันไทม์

บริษัทก่อสร้าง

Options(ตัวเลือก InterpreterApi.Options)

วิธีการสาธารณะ

Interpreter.Options
addDelegate(มอบสิทธิ์Delegate)
เพิ่ม Delegate เพื่อนำไปใช้ระหว่างการสร้างล่าม
Interpreter.Options
addDelegateFactory(DelegateFactory delegateโรงงาน)
เพิ่ม DelegateFactory ซึ่งจะเรียกใช้เพื่อใช้ Delegate ที่สร้างขึ้นระหว่างการสร้างล่าม
Interpreter.Options
setAllowBufferHandleOutput(boolean allow)
ขั้นสูง: ตั้งค่าว่าอนุญาตให้ใช้เอาต์พุตของแฮนเดิลบัฟเฟอร์หรือไม่
Interpreter.Options
setAllowFp16PrecisionForFp32(boolean allow)
วิธีนี้เลิกใช้งานแล้ว โปรดใช้ NnApiDelegate.Options#setAllowFp16(boolean enabled)
Interpreter.Options
setCancellable(boolean allow)
ขั้นสูง: ตั้งค่าว่ายกเลิกล่ามได้หรือไม่
Interpreter.Options
setNumThreads(int numThreads)
ตั้งค่าจำนวนชุดข้อความที่จะใช้ในการดำเนินการที่รองรับชุดข้อความแบบหลายรายการ
Interpreter.Options
setRuntime(รันไทม์ InterpreterApi.Options.TfLiteRuntime)
ระบุตำแหน่งที่จะเริ่มใช้งานรันไทม์ของ TF Lite
Interpreter.Options
setUseNNAPI(บูลีน useNNAPI)
ตั้งค่าว่าจะใช้ NN API (หากมี) สำหรับการดำเนินการหรือไม่
Interpreter.Options
setUseXNNPACK(บูลีน useXNNPACK)
เปิดหรือปิดใช้ชุดเคอร์เนลของ CPU ที่เพิ่มประสิทธิภาพ (ให้บริการโดย XNNPACK)

วิธีการที่รับช่วงมา

บริษัทก่อสร้าง

สาธารณะ ตัวเลือก ()

สาธารณะ ตัวเลือก (ตัวเลือก InterpreterApi.Options

พารามิเตอร์
ตัวเลือก

วิธีการสาธารณะ

สาธารณะ Interpreter.Options addDelegate (มอบสิทธิ์ มอบสิทธิ์)

เพิ่ม Delegate เพื่อนำไปใช้ระหว่างการสร้างล่าม

ระบบจะนำผู้รับมอบสิทธิ์ที่เพิ่มที่นี่ไปใช้ก่อนผู้รับมอบสิทธิ์ทุกคนที่สร้างจาก DelegateFactory ที่เพิ่มด้วย addDelegateFactory(DelegateFactory)

โปรดทราบว่า TF Lite ในบริการ Google Play (ดู setRuntime(InterpreterApi.Options.TfLiteRuntime)) ไม่รองรับผู้รับมอบสิทธิ์ภายนอก (จากนักพัฒนาแอป) และไม่อนุญาตให้เพิ่ม Delegate นอกเหนือจาก ERROR(/NnApiDelegate) ที่นี่เมื่อใช้ TF Lite ในบริการ Google Play

พารามิเตอร์
ผู้รับมอบสิทธิ์

สาธารณะ Interpreter.Options addDelegateFactory (DelegateFactory มอบสิทธิ์โรงงาน)

เพิ่ม DelegateFactory ซึ่งจะเรียกใช้เพื่อใช้ Delegate ที่สร้างขึ้นระหว่างการสร้างล่าม

ระบบจะนำผู้ที่ได้รับมอบสิทธิ์จากโรงงานที่ได้รับมอบสิทธิ์ซึ่งเพิ่มเข้ามาที่นี่ไปใช้หลังจากเพิ่มผู้รับมอบสิทธิ์ด้วย addDelegate(Delegate)

พารามิเตอร์
delegateFactory

สาธารณะ Interpreter.Options setAllowBufferHandleOutput (boolean allow)

ขั้นสูง: ตั้งค่าว่าอนุญาตให้ใช้เอาต์พุตของแฮนเดิลบัฟเฟอร์หรือไม่

เมื่อ Delegate รองรับการเร่งฮาร์ดแวร์ อินเตอร์พรีเตอร์จะทำให้ข้อมูล Tensor เอาต์พุตพร้อมใช้งานในบัฟเฟอร์ tensor ที่จัดสรรของ CPU ตามค่าเริ่มต้น หากไคลเอ็นต์ใช้แฮนเดิลบัฟเฟอร์ได้โดยตรง (เช่น การอ่านเอาต์พุตจากพื้นผิว OpenGL) ไคลเอ็นต์จะตั้งแฟล็กนี้เป็น false ได้ เพื่อหลีกเลี่ยงสำเนาข้อมูลไปยังบัฟเฟอร์ของ CPU เอกสารที่ได้รับมอบสิทธิ์ควรระบุว่าระบบรองรับหรือไม่ รวมถึงวิธีใช้

คำเตือน: อินเทอร์เฟซนี้เป็นอินเทอร์เฟซทดลองและอาจมีการเปลี่ยนแปลง

พารามิเตอร์
allow

สาธารณะ Interpreter.Options setAllowFp16PrecisionForFp32 (boolean allow)

วิธีนี้เลิกใช้งานแล้ว
โปรดใช้ NnApiDelegate.Options#setAllowFp16(boolean enabled)

ตั้งค่าว่าจะอนุญาตให้ใช้ความแม่นยำ Float16 สําหรับการคํานวณ FP32 หรือไม่เมื่อเป็นไปได้ ค่าเริ่มต้นคือ false (ไม่อนุญาต)

พารามิเตอร์
allow

สาธารณะ Interpreter.Options setCancellable (boolean allow)

ขั้นสูง: ตั้งค่าว่ายกเลิกล่ามได้หรือไม่

ล่ามอาจมี API ทดลอง setCancelled(boolean) ได้ หากล่ามนี้ยกเลิกได้และมีการเรียกใช้เมธอดดังกล่าว ระบบจะตั้งค่าแฟล็กการยกเลิกเป็น "จริง" ล่ามจะตรวจสอบแฟล็กระหว่างการเรียกใช้ Op และหากเป็น true ล่ามจะหยุดการดำเนินการ ล่ามจะยังคงมีสถานะเป็นยกเลิกจนกว่า setCancelled(false) จะ "ยกเลิก" อย่างชัดเจน

พารามิเตอร์
allow

สาธารณะ Interpreter.Options setNumThreads (int numThreads)

ตั้งค่าจำนวนชุดข้อความที่จะใช้ในการดำเนินการที่รองรับชุดข้อความแบบหลายรายการ

numThreads ควรเป็น >= -1 การตั้งค่า numThreads เป็น 0 จะส่งผลต่อการปิดใช้ชุดข้อความแบบหลายรายการ ซึ่งเทียบเท่ากับการตั้งค่า numThreads เป็น 1 หากไม่ระบุหรือตั้งค่าเป็น -1 จำนวนชุดข้อความที่ใช้จะ กำหนดการติดตั้งใช้งานและขึ้นอยู่กับแพลตฟอร์ม

พารามิเตอร์
numThreads

สาธารณะ Interpreter.Options setRuntime (InterpreterApi.Options.TfLiteRuntime)

ระบุตำแหน่งที่จะเริ่มใช้งานรันไทม์ของ TF Lite

พารามิเตอร์
รันไทม์

สาธารณะ Interpreter.Options setUseNNAPI (boolean useNNAPI)

ตั้งค่าว่าจะใช้ NN API (หากมี) สำหรับการดำเนินการหรือไม่ ค่าเริ่มต้นคือ "เท็จ" (ปิดใช้)

พารามิเตอร์
useNNAPI

สาธารณะ Interpreter.Options setUseXNNPACK (boolean useXNNPACK)

เปิดหรือปิดใช้ชุดเคอร์เนลของ CPU ที่เพิ่มประสิทธิภาพ (ให้บริการโดย XNNPACK) เปิดใช้โดยค่าเริ่มต้น

พารามิเตอร์
useXNNPACK