توجه : این ویژگی در نسخه ۴ و بالاتر از فرمت 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 مراجعه کنید.