تخصيص الشاشة باستخدام الصور

ملاحظة: تتوفّر هذه الميزة في الإصدار 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:

  1. تسمح سمة change للمطوّر بتحديد الأحداث التي يجب أن تؤدي إلى التبديل بين الصور المتاحة.

في المثال السابق، تم تحديد كل من TAP وON_VISIBLE، ما يعني أنّ الصورة تتغيّر استجابةً إما للنقر على الصورة أو استجابةً لظهور الصورة.

  1. لا تنطبق سمة changeAfterEvery إلا على حدث ON_VISIBLE التغيير، الذي يحدّد عدد المرات التي كان من المفترض أن تظهر فيها الصورة قبل تغييرها. على سبيل المثال، قد تعتقد أنّ تغيير الصورة في كل مرة يوقِظ فيها المستخدم ساعته أمر متكرّر جدًا. القيمة التلقائية هنا هي 3.

لمزيد من التفاصيل حول استخدام PhotosConfiguration، اطّلِع على النماذج على GitHub.