หมายเหตุ: ฟีเจอร์นี้พร้อมใช้งานใน Watch Face Format เวอร์ชัน 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>
ตัวอย่างก่อนหน้านี้แสดง 2 ตัวเลือกที่ใช้เมื่อใช้ MULTIPLE ดังนี้
- แอตทริบิวต์
changeช่วยให้นักพัฒนาซอฟต์แวร์ระบุได้ว่าเหตุการณ์ใดควรทำให้รูปภาพวนไปตามรูปภาพที่มีอยู่
ในตัวอย่างก่อนหน้านี้ มีการระบุทั้ง TAP และ ON_VISIBLE ซึ่งหมายความว่า
รูปภาพจะเปลี่ยนไปเมื่อผู้ใช้แตะรูปภาพหรือ
เมื่อรูปภาพปรากฏขึ้น
- แอตทริบิวต์
changeAfterEveryใช้กับเหตุการณ์การเปลี่ยนแปลงON_VISIBLEเท่านั้น โดยระบุจำนวนครั้งที่รูปภาพควรปรากฏก่อนที่จะมีการเปลี่ยนรูปภาพ เช่น คุณอาจรู้สึกว่าการเปลี่ยนรูปภาพทุกครั้งที่ผู้ใช้ปลุกนาฬิกาให้ทำงานนั้นถี่เกินไป ค่าเริ่มต้นที่นี่คือ 3
ดูรายละเอียดเพิ่มเติมเกี่ยวกับการทำงานกับ PhotosConfiguration ได้ที่ตัวอย่างใน GitHub