شخصی‌سازی با عکس

توجه: این ویژگی در نسخه ۴ و بالاتر «قالب صفحه ساعت» دردسترس است.

اجازه دادن به کاربر برای انتخاب عکس جهت افزودن به صفحه ساعت می‌تواند به شخصی‌سازی تجربه صفحه ساعت کمک کند.

بخش کار با تصاویر قبلاً نحوه نمایش تصاویر در صفحه ساعت را پوشش داده است. اگر می‌خواهید به کاربر اجازه دهید از بین مجموعه‌ای از تصاویر ازپیش‌تعریف‌شده انتخاب کند، از ListConfiguration استفاده کنید، همان‌طور که در بخش تعریف پیکربندی‌های کاربر نشان داده شده است.

برای استفاده از تصاویری در صفحه ساعتی که کاربر می‌تواند پیکربندی کند، از عنصر <PhotosConfiguration> استفاده کنید، برای مثال:

<!-- Under WatchFace element -->
<UserConfigurations>
    <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>
watchface_photos.xml

configType می‌تواند SINGLE یا MULTIPLE باشد که نشان می‌دهد آیا کاربر می‌تواند یک تصویر واحد را در برنامه همراه یا مجموعه‌ای از عکس‌ها را انتخاب کند.

پشتیبانی از یک عکس

برای مورد تک‌تصویر، می‌توان از عکس در عنصر PartImage به‌صورت زیر استفاده کرد:

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

به 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>
watchface_photos_multi.xml

مثال قبلی دو گزینه‌ای را نشان می‌دهد که هنگام استفاده از MULTIPLEمعرفی می‌شوند:

1. ویژگی change به توسعه‌دهنده اجازه می‌دهد مشخص کند کدام رویدادها باید باعث شود عکس در میان تصاویر دردسترس بچرخد.

در مثال قبلی، هم TAP و هم ON_VISIBLE مشخص شده‌اند، یعنی عکس در پاسخ یا به تک‌ضرب کاربر روی عکس یا در پاسخ به نمایان شدن عکس تغییر می‌کند.

1. ویژگی changeAfterEvery فقط برای رویداد تغییر ON_VISIBLE اعمال می‌شود و مشخص می‌کند که عکس چند بار باید نمایان شود قبل‌از اینکه عکس تغییر کند. برای مثال، ممکن است احساس کنید که تغییر دادن عکس هر بار که کاربر ساعت را بیدار می‌کند خیلی زیاد است. مقدار پیش‌فرض در اینجا ۳ است.

برای جزئیات بیشتر درباره کار با PhotosConfiguration، نمونه‌ها را در GitHub ببینید.