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