عند تفعيل analytics (وهو الإعداد الافتراضي)، تلتقط أداة التتبّع النقرات والسحبات وتغيّرات منفذ العرض (viewport) وأحداث الإدخال من تلقاء نفسها. أما الشاشات وطرق العرض الفردية فيتم الإبلاغ عنها عبر عنصرَي واجهة (widgets) مُصدَّرين.

أضف ORNavigatorObserver إلى أداة التنقّل (navigator) في تطبيقك لتسجيل الانتقالات بين المسارات (routes):

import 'package:openreplay/openreplay.dart';

MaterialApp(
  navigatorObservers: [ORNavigatorObserver()],
  // ...
)

يتم الإبلاغ عن عمليات الدفع (push) والإزالة (pop) والاستبدال والحذف جميعها. يُسمّى المسار وفقًا لـ route.settings.name؛ أما المسار غير المُسمّى فيُستخدم موضعه في المكدّس بديلًا (route/2)، لذا فإن المسارات المُسمّاة تجعل الخطوط الزمنية أسهل قراءة بكثير.

غلّف أي عنصر واجهة (widget) بـ ORTrackedView للإبلاغ عنه كطريقة عرض مُسمّاة وقابلة للمراقبة. يُطلَق حدث ظهور عند تركيبه (mount) وعند إزالة تركيبه (unmount)، ويُستخدم اسمه كتسمية للّمسات التي تقع داخله.

• screenName: String — عنوان الشاشة أو الميزة
• viewName: String — اسم طريقة العرض المتتبَّعة

import 'package:openreplay/openreplay.dart';

ORTrackedView(
  screenName: 'Checkout',
  viewName: 'Pay button',
  child: ElevatedButton(onPressed: _pay, child: const Text('Pay')),
)

تُلتقط النقرات والسحبات عبر المسار العام لموجّه المؤشر (pointer router)، لذا ترى أداة التتبّع كل حدث مؤشر دون أن تتنافس أبدًا في ساحة الإيماءات (gesture arena) — فلا يمكنها ابتلاع نقرة يحتاجها تطبيقك. يُسجَّل المؤشر الذي يقطع أكثر من 10 بكسلات منطقية على أنه سحبة مع اتجاهها الغالب، وأي حركة أقصر على أنها نقرة.

تأتي تسميات اللمسات من اختبار النقر (hit-testing) على النص الموجود تحت المؤشر، أو من ORTrackedView المحيط.

إذا كانت لديك أي أسئلة حول هذه العملية، فلا تتردد في التواصل معنا عبر Slack أو الاطلاع على المنتدى الخاص بنا.