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