Interpreter.Options

فئة ثابتة عامة Interpreter.Options

فئة خيارات للتحكّم في سلوك المترجم الفوري في وقت التشغيل.

الإنشاء العام

الطرق العامة

Interpreter.Options
addDelegate(مفوَّض)
لإضافة Delegate ليتم تطبيقها أثناء إنشاء مترجم فوري.
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).

الطرق المكتسَبة

الإنشاء العام

عامة خيارات ()

متاح للجميع الخيارات (خيارات InterpreterApi.Options)

المَعلمات
الخيارات

الطرق العامة

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