الاستخدام المتقدم

توضح الأقسام التالية موضوعات استخدام متقدمة ليست ضرورية للتشغيل العادي للمكتبة.

أدوات التتبُّع الأخرى المتوافقة

الشوكة الرنانة متوافقة مع أدوات التتبع المتعددة. تتوفر أجهزة التتبع بمفاتيح الأدوات التالية:

• الوقت بين بدء عرض اللقطة (يُسمى PACED_FRAME_TIME)
• وقت وحدة المعالجة المركزية: الوقت بين بداية الإطار وانتهاء عمل وحدة المعالجة المركزية (CPU) للإطار (يُسمى CPU_TIME)
• وقت وحدة معالجة الرسومات: الوقت اللازم لمعالجة الإطار السابق بواسطة وحدة معالجة الرسومات (يُسمى GPU_TIME)
• وقت عرض اللقطة الأولي، وهو الحد الأقصى لوقت وحدة المعالجة المركزية (CPU) ووحدة معالجة الرسومات (يُسمّى RAW_FRAME_TIME). الفرق بين هذا الخيار وPACED_FRAME_TIME هو أنّ هذا الخيار لا يتضمّن أي وقت انتظار يتضمّنه Swappy أو VSync.

يمكنك العثور على مفاتيح الأدوات هذه في المستندات المرجعية. ويتم استخدام بعض هذه المفاتيح تلقائيًا عند تمكين مكتبة معدّل خطوات "Android Frame"، ولكن إذا لم يتم تفعيل هذه المكتبة، يجب استخدامها بصراحة.

الحصول على معلَمات الدقة

TFErrorCode TuningFork_getFidelityParameters(const CProtobufSerialization* defaultParams, CProtobufSerialization* params, uint32_t timeout_ms);

إذا ضبطت fidelity_params_callback إلى TuningFork_init في الإعدادات أو كانت المكتبة في وضع القياس، لن تحتاج إلى استدعاء هذه الدالة.

تتصل هذه الدالة بالخادم لاسترداد معلمات الدقة. يتم حظره حتى يحدث أحد ما يلي:

• يتم استرداد معلَمات الدقة، مع قيمة معروضة تبلغ TFERROR_OK وتخزّن returnedParams المعلَمات. في هذه الحالة، يتم ربط جميع بيانات علامة المؤشرات اللاحقة بـ returnedParams.
• عدد الملي ثانية يساوي timeout_ms، وتكون القيمة المعروضة هي TFERROR_TIMEOUT. في هذه الحالة، يتم ربط جميع بيانات التجزئة اللاحقة بـ defaultFidelityParams.

يجب استدعاء الدالة TuningFork_init() قبل هذه الدالة، كما يجب استدعائها عبر سلسلة تعليمات منفصلة عن سلسلة التعليمات الرئيسية (راجع TuningFork_startFidelityParamDownloadThread() للاطّلاع على دالة تنفيذية تتيح لك تنفيذ هذا الإجراء). يمكنك استدعاء هذه الدالة مرة أخرى، على سبيل المثال في وقت التحميل على المستوى، لاسترداد معلمات الدقة من الخادم مرة أخرى. ويتيح لك ذلك تحديث المعلمات ديناميكيًا بدلاً من الاضطرار إلى إعادة تحميلها عند بدء التشغيل فقط. إذا تم تنزيل معلمات الدقة الجديدة أو تم استخدام إعداد تلقائي جديد، سيتم إرسال جميع بيانات التجزئة السابقة.