ملاحظة: تتوفّر هذه الميزة في الإصدار 4 والإصدارات الأحدث من تنسيق خلفية شاشة الساعة.
يمكن أن يساعد السماح للمستخدم باختيار الصور لتضمينها في خلفية شاشة الساعة في إضافة لمسة شخصية إلى تجربة خلفية شاشة الساعة.
يتضمّن القسم كيفية استخدام الصور معلومات حول كيفية عرض الصور في خلفية شاشة الساعة. إذا أردت السماح للمستخدم بالاختيار من بين مجموعة من الصور المحدّدة مسبقًا، استخدِم ListConfiguration كما هو موضّح في قسم تحديد إعدادات المستخدم.
لاستخدام صور يمكن للمستخدم ضبطها في خلفية شاشة الساعة، استخدِم العنصر <PhotosConfiguration>، على سبيل المثال:
<!-- Under WatchFace element --> <UserConfigurations> <PhotosConfiguration id="photoConfig" configType="SINGLE"/> </UserConfigurations>
يمكن أن تكون قيمة configType إما SINGLE أو MULTIPLE، ما يشير إلى ما إذا كان بإمكان المستخدم اختيار صورة واحدة ضمن التطبيق المصاحب أو مجموعة من الصور.
دعم صورة واحدة
في حالة الصورة الواحدة، يمكن استخدام الصورة ضمن العنصر PartImage على النحو التالي:
<PartImage x="100" y="50" width="100" height="100"> <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/> </PartImage>
لاحظ defaultImageResource، الذي يظهر عندما لم يحدّد المستخدم صورة في التطبيق المصاحب، وهو سمة مطلوبة.
إذا أراد المستخدم اختيار صورة مختلفة، عليه استخدام الجهاز المصاحب لاستبدال الصورة الحالية بصورة أخرى.
إتاحة صور متعددة
يتيح استخدام PhotosConfiguration مع configType="MULTIPLE" لوجه الساعة عرض صورة من مجموعة، ويمكن التنقّل بين الصور من خلال النقر أو تلقائيًا بعد عرض عدد معيّن من الصور.
<PartImage x="100" y="250" width="100" height="100"> <Photos change="ON_VISIBLE TAP" changeAfterEvery="5" source="[CONFIGURATION.galleryConfig]" defaultImageResource="default_image"/> </PartImage>
يوضّح المثال السابق الخيارَين اللذين يتم تقديمهما عند استخدام
MULTIPLE:
- تسمح السمة
changeللمطوّر بتحديد الأحداث التي يجب أن تؤدي إلى تصفّح الصور المتاحة.
في المثال السابق، تم تحديد كل من TAP وON_VISIBLE، ما يعني أنّ الصورة تتغيّر استجابةً إما لنقر المستخدم على الصورة أو استجابةً لظهور الصورة.
- لا تنطبق السمة
changeAfterEveryإلا على حدث التغييرON_VISIBLE، وهي تحدّد عدد المرات التي يجب أن تظهر فيها الصورة قبل تغييرها. على سبيل المثال، قد تشعر أنّ تغيير الصورة في كل مرة يوقظ فيها المستخدم ساعته هو أمر متكرّر جدًا. القيمة التلقائية هنا هي 3.
لمزيد من التفاصيل حول استخدام PhotosConfiguration، اطّلِع على النماذج على GitHub.