أحداث مراحل النشاط والإحصاءات

TileService هي خدمة ربط. يتم ربط TileService نتيجةً لطلب تطبيقك أو إذا كان النظام بحاجة إلى التواصل معه. تحتوي دورة حياة الخدمة المرتبطة النموذجية على طُرق الاستدعاء الأربعة التالية: onCreate() وonBind() وonUnbind() و onDestroy(). يستدعي النظام هذه الطرق في كل مرة تدخل فيها الخدمة في مرحلة جديدة من دورة الحياة.

بالإضافة إلى وظائف الاستدعاء التي تتحكّم في دورة حياة الخدمة المرتبطة، يمكنك تنفيذ طرق أخرى خاصة بدورة حياة TileService. يجب أن تنفِّذ جميع خدمات الشاشة المفردة onTileRequest() وonTileResourcesRequest() لتلقّي طلبات التحديثات من النظام والردّ عليها.

  • onTileAddEvent(): لا يستدعي النظام هذه الطريقة إلا عندما يُضيف المستخدم شاشة العرض للمرة الأولى، وإذا أزال المستخدم شاشة العرض وأعاد إضافتها. هذا هو أفضل وقت لإجراء أي عملية إعداد لمرة واحدة.

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

  • onTileRemoveEvent(): لا يستدعي النظام هذه الطريقة إلا إذا أزال المستخدم مربّعك.

  • onTileEnterEvent(): يستدعي النظام هذه الطريقة عندما يظهر مربّع يقدّمه هذا الموفِّر على الشاشة.

  • onTileLeaveEvent(): يستدعي النظام هذه الطريقة عندما يختفي مربّع يقدّمه هذا الموفِّر عن الشاشة.

  • onTileRequest(): يستدعي النظام هذه الطريقة عندما يطلب مخططًا زمنيًا جديدًا من هذا الموفِّر.

  • onTileResourcesRequest(): يستدعي النظام هذه الطريقة عندما يطلب النظام حزمة موارد من هذا الموفِّر. ويمكن أن يحدث ذلك في المرة الأولى التي يتم فيها تحميل مربّع أو عند تغيُّر إصدار المرجع.

طلب عرض المربّعات النشطة

البطاقات النشطة هي البطاقات التي تمت إضافتها للعرض على الساعة. استخدِم الأسلوب الثابت TileServicegetActiveTilesAsync() لطلب البحث عن المربّعات التي تنتمي إلى تطبيقك النشطة.