من المهم تسجيل وقت تنفيذ لعبتك لأحداث التحميل لسببين:
- لتجنُّب التأثير سلبًا على بيانات وقت عرض اللقطة أثناء التحميل
- لتحليل أوقات التحميل لمعرفة متى وأين تكون أوقات التحميل أطول من المقبول.
يمكن أن يتضمّن حدث التحميل بيانات وصفية مرتبطة به:
typedef struct TuningFork_LoadingTimeMetadata {
enum LoadingState {
UNKNOWN_STATE = 0,
// The first time the game is run
FIRST_RUN = 1,
// App is not backgrounded
COLD_START = 2,
// App is backgrounded
WARM_START = 3,
// App is backgrounded, least work needed
HOT_START = 4,
// Asset loading between levels
INTER_LEVEL = 5
} state;
enum LoadingSource {
UNKNOWN_SOURCE = 0,
// Uncompressing data.
MEMORY = 1,
// Reading assets from APK bundle.
APK = 2,
// Reading assets from device storage.
DEVICE_STORAGE = 3,
// Reading assets from external storage, e.g. SD card.
EXTERNAL_STORAGE = 4,
// Loading assets from the network.
NETWORK = 5,
// Shader compilation.
SHADER_COMPILATION = 6,
// Time spent between process starting and onCreate.
PRE_ACTIVITY = 7,
// Total time spent between process starting and first render frame.
FIRST_TOUCH_TO_FIRST_FRAME = 8
} source;
int32_t compression_level; // 0 = no compression, 100 = max compression
enum NetworkConnectivity {
UNKNOWN = 0,
WIFI = 1,
CELLULAR_NETWORK = 2
} network_connectivity;
uint64_t network_transfer_speed_bps; // bandwidth in bits per second
uint64_t network_latency_ns; // latency in nanoseconds
} TuningFork_LoadingTimeMetadata;
يمكن أن تكون قيمة أي حقول غير ذات صلة باحتياجاتك صفرًا.
يمكن أن يتضمّن حدث التحميل أيضًا تعليقًا توضيحيًا مرتبطًا به. ويتم تحديد ذلك بالطريقة نفسها التي يتم بها تحديد التعليقات التوضيحية لوقت عرض اللقطة، وذلك باستخدام حقل واحد أو أكثر في رسالة Annotation في ملف dev_tuningfork.proto.
تبدأ هذه الدالة في تسجيل حدث وقت التحميل المرتبط بالبيانات الوصفية والتعليقات التوضيحية المحدّدة، وتملأ handle لاستخدامه في دالة TuningFork_stopRecordingLoadingTime().
TuningFork_ErrorCode TuningFork_stopRecordingLoadingTime(
TuningFork_LoadingEventHandle handle);
توقف هذه الدالة تسجيل حدث تم بدؤه سابقًا بواسطة
TuningFork_startRecordingLoadingTime(). يتم تحميل الحدث عند تفريغ الجلسة التالية.
ننصح بشدة باستخدام دالتي البدء والإيقاف الموضحتين سابقًا بشكل مباشر. إذا لم تتمكّن من إجراء ذلك، يمكنك استدعاء هذه الدالة لتسجيل مدة والبيانات الوصفية والتعليقات التوضيحية المرتبطة بها.
جارٍ تحميل وظائف المجموعة
في لعبتك، يمكنك تسجيل عدة أحداث تحميل لفترة تحميل واحدة يراها المستخدم. تشمل بعض الأمثلة (على سبيل المثال لا الحصر) تحميل الملفات وإلغاء الضغط وتجميع أدوات التظليل.
من المهم إبلاغ Tuning Fork بأنّ أحداث التحميل هي جزء من هذه المجموعة حتى تتمكّن من تقديم إحصاءات أفضل. أحِط أحداث التحميل بدالتي البدء والإيقاف التاليتين لتنفيذ ذلك.
تبدأ هذه الدالة مجموعة تحميل مرتبطة بالبيانات الوصفية والتعليقات التوضيحية المحدّدة، وتملأ handle لاستخدامه في الدالة TuningFork_stopLoadingGroup. لا يتم استخدام البيانات الوصفية والتعليقات التوضيحية
من خلال الواجهة الخلفية في Play ويمكن ضبطها على nullptr. يتم وضع علامة على جميع أحداث التحميل اللاحقة
باستخدام معرّف مجموعة فريد.
TuningFork_ErrorCode TuningFork_stopLoadingGroup(
TuningFork_LoadingEventHandle handle);
توقف هذه الدالة مجموعة تحميل تم تشغيلها مسبقًا بواسطة
TuningFork_startLoadingGroup(). لن تتضمّن أحداث التحميل اللاحقة رقم تعريف مجموعة إلى أن يتم استدعاء TuningFork_startLoadingGroup() مرة أخرى.