ضبط تطبيق الهاتف لعرض خلفيات شاشة الساعة

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

بالنسبة إلى السوق الأساسي، يشكّل تطبيق الهاتف الطريقة الرئيسية التي يتفاعل بها المستخدِم مع التطبيق.

ضبط خلفية شاشة الساعة

عندما يختار المستخدم خلفية شاشة ساعة في تطبيق الهاتف، يتوفّر جزءان من المسار اللاحق لضبط خلفية شاشة الساعة:

1. التثبيت: يمكنك تثبيت خلفية شاشة الساعة باستخدام ميزة "دفع خلفية شاشة الساعة" التي يتم تفعيلها من خلال MessageClient. هذه الخطوة بسيطة، ويمكنك تنفيذها باستخدام addWatchFace أو updateWatchFace، وبدء الإجراء باستخدام MessageClient من الهاتف إلى الساعة.
2. التفعيل: ضبط خلفية شاشة الساعة المثبَّتة كخلفية نشطة تتضمّن هذه الخطوة عدة مسارات محتملة، استنادًا إلى حالة الإذن:
   • قد لا يكون عليك اتّخاذ أي إجراء. قد يكون السوق يدير خلفية شاشة الساعة النشطة.
   • قد لا يكون تدخل المستخدم مطلوبًا. يمتلك التطبيق التصاريح اللازمة لضبط خلفية شاشة الساعة النشطة، ويمكنه إجراء ذلك مباشرةً باستخدام setWatchFaceAsActive().
   • قد تكون هناك إرشادات مطلوبة، إما حول كيفية قبول طلبات منح الأذونات أو كيفية ضبط خلفية شاشة الساعة يدويًا باستخدام لفتة الضغط مع الاستمرار أو من خلال تطبيق مصاحب.

ردّ على عملية التثبيت

لتسهيل مرحلة التنشيط، يجب أن تعرض مرحلة التثبيت المعلومات التالية من الساعة إلى الهاتف:

• نتيجة محاولة التثبيت
• نتيجة isWatchFaceActive() - لتحديد ما إذا كان التطبيق يحتوي على خلفية شاشة الساعة النشطة
• سواء سبق أن تم استدعاء setWatchFaceAsActive() في السابق، يجب أن يتتبّع تطبيق Wear OS هذه المعلومات ويحفظها على الجهاز. لا يمكن استخدام طلب بيانات من واجهة برمجة التطبيقات إلا مرة واحدة.

التفعيل

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

السيناريو 1: استنفاد جميع محاولات ضبط خلفية شاشة الساعة النشطة

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

السيناريو 2: محاولة ضبط خلفية شاشة الساعة النشطة

من المفترض أن يطلب الهاتف من الساعة التحقّق من إذن SET_PUSHED_WATCH_FACE_AS_ACTIVE اللازم:

• إذا سبق للمستخدم منح الإذن، يمكنك المتابعة إلى استدعاء دالة setWatchFaceAsActive().
• إذا رفض المستخدم الإذن في السابق، من المفترض أن تُبلغ الساعة الهاتف بذلك، حيث يمكن عرض شاشة تعليمية توضّح الحاجة إلى الإذن وكيفية منحه يدويًا.

• إذا لم يسبق طلب الإذن، من المفترض أن تُوجّه الساعة الهاتف إلى عرض لحظة تعليمية ترشد المستخدم إلى كيفية قبول الأذونات على الساعة، ومن المفترض أن تطلب الساعة الإذن.

  • إذا منح المستخدم الإذن، من المفترض أن تتصل الساعة بعد ذلك بالرقم setWatchFaceAsActive().
  • بخلاف ذلك، من المفترض أن تطلب الساعة من الهاتف عرض شاشة توجيهية توضّح الحاجة إلى الإذن وكيفية منحه يدويًا.