با عکس ها شخصی سازی کنید

توجه : این ویژگی در نسخه ۴ و بالاتر قالب ساعت Watch Face موجود است.

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

بخش کار با تصاویر، نحوه نمایش تصاویر در صفحه ساعت شما را پوشش می‌دهد. اگر می‌خواهید به کاربر اجازه دهید از بین طیف وسیعی از تصاویر از پیش تعریف شده انتخاب کند، از 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 مراجعه کنید.