فئة خيارات للتحكّم في سلوك المترجم الفوري في وقت التشغيل.
الإنشاء العام
Options()
|
|
Options(خيارات InterpreterApi.Options)
|
الطرق العامة
Interpreter.Options | |
Interpreter.Options |
addDelegateFactory(DelegateFactory delegateمصانع)
إضافة عنصر
DelegateFactory الذي سيتم استدعاؤه لتطبيق Delegate الذي تم إنشاؤه أثناء إنشاء مترجم فوري. |
Interpreter.Options |
setAllowBufferHandleOutput(boolean allow)
إعدادات متقدّمة: يتم ضبط هذه السياسة في حال السماح بإخراج مقبض المخزن المؤقت.
|
Interpreter.Options |
setAllowFp16PrecisionForFp32(boolean allow)
تم إيقاف هذه الطريقة نهائيًا. يُفضَّل استخدام NnApiDelegate.Options#setAllowFp16(boolean
enable).
|
Interpreter.Options |
setCancellable(boolean allow)
إعدادات متقدّمة: يمكنك ضبط ما إذا كان بالإمكان إلغاء خدمة "الترجمة الفورية".
|
Interpreter.Options |
setNumThreads(int numThreads)
لضبط عدد سلاسل المحادثات التي سيتم استخدامها للعمليات التي تدعم سلاسل التعليمات المتعددة.
|
Interpreter.Options |
setRuntime(وقت تشغيل InterpreterApi.Options.TfLiteRuntime)
حدِّد من أين يمكن الحصول على تنفيذ وقت تشغيل TF Lite.
|
Interpreter.Options |
setUseNNAPI(استخدام منطقي useNNAPI)
لضبط ما إذا كان سيتم استخدام واجهة برمجة تطبيقات NN (إن توفرت) لتنفيذ العملية.
|
Interpreter.Options |
setUseXNNPACK(استخدام منطقيXNNPACK)
تفعيل أو إيقاف مجموعة محسّنة من نواة وحدة المعالجة المركزية (CPU) (المتوفّرة من خلال XNNPACK).
|
الطرق المكتسَبة
الإنشاء العام
عامة خيارات ()
الطرق العامة
public 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 delegateFix)
إضافة عنصر DelegateFactory
الذي سيتم استدعاؤه لتطبيق Delegate
الذي تم إنشاؤه أثناء إنشاء مترجم فوري.
يتم تطبيق التفويضات من مصنع مفوَّض تمت إضافته هنا بعد إضافة أي مفوَّضين من خلال addDelegate(Delegate)
.
المَعلمات
delegateFactory |
---|
Public Interpreter.Options setAllowBufferHandleOutput (boolean allow)
إعدادات متقدّمة: يتم ضبط هذه السياسة في حال السماح بإخراج مقبض المخزن المؤقت.
عندما يتوافق Delegate
مع ميزة تسريع الأجهزة، سيجعل الترجمة الفورية بيانات مشدّدات الإخراج
متاحة تلقائيًا في المخازن المؤقتة التي تخصّصها وحدة المعالجة المركزية (CPU). وإذا تمكّن العميل من استهلاك مقبض المخزن المؤقت مباشرةً (على سبيل المثال، قراءة الناتج من زخرفة OpenGL)، يمكنه ضبط هذه
العلامة على "خطأ"، ما يؤدي إلى تجنُّب نسخ البيانات إلى المخزن المؤقت لوحدة المعالجة المركزية (CPU). ويجب أن توضح المستندات المفوَّضة
ما إذا كان هذا الإجراء متاحًا وطريقة استخدامه.
تحذير: هذه واجهة تجريبية عرضة للتغيير.
المَعلمات
سماح |
---|
public Interpreter.Options setAllowFp16PrecisionForFp32 (boolean allow)
تم إيقاف هذه الطريقة نهائيًا.
أفضّل استخدام NnApiDelegate.Options#setAllowFp16(boolean
enable).
لتعيين ما إذا كان سيتم السماح بدقة float16 لحساب FP32 عندما يكون ذلك ممكنًا. ويتم ضبطها تلقائيًا على "خطأ" (disallow).
المَعلمات
سماح |
---|
متاح للجميع Interpreter.Options setCancellable (boolean allow)
إعدادات متقدّمة: يمكنك ضبط ما إذا كان بالإمكان إلغاء خدمة "الترجمة الفورية".
قد يستخدِم المترجمون الفوريين واجهة برمجة تطبيقات تجريبية setCancelled(boolean).
إذا كان هذا المترجم الفوري قابلاً للإلغاء وتم استدعاء هذه الطريقة، سيتم ضبط علامة إلغاء
على "صحيح". سيتحقّق المترجم الفوري من العلامة في استدعاءات عمليات التشغيل، وإذا كانت هي true
، سيتوقّف المترجم الفوري عن التنفيذ. ستظل خدمة الترجمة الفورية ملغية إلى أن يتم "إلغاء الإلغاء" بشكل صريح بحلول setCancelled(false)
.
المَعلمات
سماح |
---|
public 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 (إن توفرت) لتنفيذ العملية. يكون الإعداد التلقائي بالقيمة "خطأ" (غير مفعَّل).
المَعلمات
useNNAPI |
---|
public Interpreter.Options setUseXNNPACK (boolean useXNNPACK)
تفعيل أو إيقاف مجموعة محسّنة من نواة وحدة المعالجة المركزية (CPU) (المتوفّرة من خلال XNNPACK). يتم تفعيلها تلقائيًا.
المَعلمات
useXNNPACK |
---|