הערה: התכונה הזו זמינה בגרסה 4 ומעלה של פורמט תצוגת השעון.
האפשרות לבחור תמונות שיוצגו בתצוגת השעון יכולה להוסיף מגע אישי לחוויית השימוש בתצוגת השעון.
בקטע עבודה עם תמונות כבר מוסבר איך להציג תמונות בתצוגת השעון. אם רוצים לאפשר למשתמש לבחור מתוך מגוון של תמונות מוגדרות מראש, משתמשים ב-ListConfiguration כמו שמוסבר בקטע הגדרת תצורות משתמש.
כדי להשתמש בתמונות בתצוגת השעון שהמשתמש יכול להגדיר, משתמשים ברכיב <PhotosConfiguration>, לדוגמה:
<!-- Under WatchFace element --> <UserConfigurations> <PhotosConfiguration id="photoConfig" configType="SINGLE"/> </UserConfigurations>
הערך של configType יכול להיות SINGLE או MULTIPLE, שמציינים אם המשתמש יוכל לבחור תמונה אחת מתוך התמונה הנלווית או אוסף של תמונות.
תמיכה בתמונה אחת
במקרה של תמונה אחת, אפשר להשתמש בתמונה בתוך רכיב PartImage באופן הבא:
<PartImage x="100" y="50" width="100" height="100"> <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/> </PartImage>
שימו לב למאפיין 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>
בדוגמה שלמעלה מוצגות שתי האפשרויות שמופיעות כשמשתמשים ב-MULTIPLE:
- המאפיין
changeמאפשר למפתח לציין אילו אירועים צריכים לגרום לתמונה לעבור בין התמונות הזמינות.
בדוגמה הקודמת, גם TAP וגם ON_VISIBLE מצוינים, כלומר התמונה משתנה בתגובה או להקשה של המשתמש על התמונה או בתגובה לכך שהתמונה הופכת לגלוי.
- המאפיין
changeAfterEveryחל רק על אירוע השינויON_VISIBLE, ומציין כמה פעמים התמונה צריכה להיות גלויה לפני שהיא משתנה. לדוגמה, יכול להיות שתחשבו ששינוי התמונה בכל פעם שהמשתמש מעיר את השעון הוא תדיר מדי. ערך ברירת המחדל כאן הוא 3.
לפרטים נוספים על עבודה עם PhotosConfiguration, אפשר לעיין בדוגמאות ב-GitHub.