توجه : این ویژگی در نسخه ۴ و بالاتر از فرمت Watch Face موجود است.
اجازه دادن به کاربر برای انتخاب عکسها برای درج در صفحه ساعت میتواند به شما کمک کند تا حس شخصی را به تجربه صفحه ساعت شما بیاورد.
بخش کار با تصاویر قبلاً نحوه نمایش تصاویر در صفحه ساعت شما را پوشش می دهد. اگر می خواهید به کاربر اجازه دهید از بین طیف وسیعی از تصاویر از پیش تعریف شده انتخاب کند، از یک ListConfiguration
همانطور که در قسمت define user configurations نشان داده شده است استفاده کنید.
برای استفاده از تصاویر در صفحه ساعت خود که کاربر می تواند پیکربندی کند، از عنصر <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 مراجعه کنید.