ปรับเปลี่ยนในแบบของคุณด้วยรูปภาพ

หมายเหตุ: ฟีเจอร์นี้พร้อมใช้งานใน 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 ดังนี้

  1. แอตทริบิวต์ change ช่วยให้นักพัฒนาซอฟต์แวร์ระบุได้ว่าเหตุการณ์ใดควรทำให้รูปภาพวนไปตามรูปภาพที่มีอยู่

ในตัวอย่างก่อนหน้านี้ มีการระบุทั้ง TAP และ ON_VISIBLE ซึ่งหมายความว่า รูปภาพจะเปลี่ยนไปเมื่อผู้ใช้แตะรูปภาพหรือ เมื่อรูปภาพปรากฏขึ้น

  1. แอตทริบิวต์ changeAfterEvery ใช้กับเหตุการณ์การเปลี่ยนแปลง ON_VISIBLE เท่านั้น โดยระบุจำนวนครั้งที่รูปภาพควรปรากฏก่อนที่จะมีการเปลี่ยนรูปภาพ เช่น คุณอาจรู้สึกว่าการเปลี่ยนรูปภาพทุกครั้งที่ผู้ใช้ปลุกนาฬิกาให้ทำงานนั้นถี่เกินไป ค่าเริ่มต้นที่นี่คือ 3

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการทำงานกับ PhotosConfiguration ได้ที่ตัวอย่างใน GitHub