ข้อมูลแทรกเป็นฟีเจอร์ของทั้งหน้าปัดนาฬิกาแบบทั่วไปและสมาร์ทวอทช์ ซึ่งแสดงข้อมูลเพิ่มเติม โดยปกติแล้วผู้ใช้จะเลือกข้อมูลที่ แสดงในภาวะแทรกซ้อน
โดยทั่วไปแล้ว Complication จะมีหลายรูปแบบดังนี้
- สี่เหลี่ยมผืนผ้า
- เป็นวงกลม
- ส่วนโค้งตามขอบของหน้าปัด
- พื้นหลังที่ครอบคลุมทั้งหน้าปัด
ใน Wear OS ระบบแทรกข้อมูลแบ่งออกเป็น 2 ส่วน ดังนี้
- แหล่งข้อมูลของภาวะแทรกซ้อน
- การแสดงผลข้อมูลแทรก
ตัวอย่างเช่น แอปฟิตเนสอาจใช้แหล่งข้อมูลของข้อมูลแทรกจำนวนก้าวรายวัน ซึ่งอาจแสดงโดยหน้าปัด WFF
แหล่งข้อมูลในข้อมูลแทรก
แหล่งข้อมูลแทรกจะระบุเฉพาะข้อมูลที่จะแสดงผลและประเภทของ แทรก แหล่งข้อมูลไม่มีส่วนเกี่ยวข้องในการกำหนดวิธีแสดงข้อมูลบนหน้าปัด
เช่น แหล่งข้อมูลความซับซ้อนของจำนวนก้าวรายวันด้านสุขภาพและการออกกำลังกายอาจ สร้างข้อมูลต่อไปนี้เพื่อระบุว่าผู้ใช้เดินได้ 2,400 จากเป้าหมาย 10,000 ก้าวในวันนี้
- ประเภท:
GOAL_PROGRESS - ค่า:
2400 - TargetValue:
10000
โปรดทราบว่าไม่มีข้อมูลใดในข้อมูลนี้ที่บ่งบอกว่าควรแสดงผลอย่างไร
หน้าปัดจะระบุประเภทของข้อมูลแทรกที่แสดงได้ ซึ่งจะกําหนดแหล่งข้อมูลที่ผู้ใช้เลือกได้
ในกรณีของตัวอย่างจำนวนก้าวรายวัน คุณจะตัดสินใจในคำจำกัดความของหน้าปัด
ว่าจะแสดง Value และ TargetValue อย่างไร จะเป็นข้อความหรือ
ตัวบ่งชี้ความคืบหน้า ซึ่งเป็นสิ่งที่คุณในฐานะผู้ออกแบบหน้าปัดต้องตัดสินใจ
กำหนดข้อมูลแทรก
การให้ความสามารถในการแสดงข้อมูลแทรกบนหน้าปัดนาฬิกาอาจมีประโยชน์ต่อผู้ใช้ เนื่องจากช่วยให้ผู้ใช้ดูข้อมูลได้หลากหลายมากขึ้นในทันทีและปรับแต่งให้ตรงกับความต้องการได้
ตัดสินใจว่าจะรองรับข้อมูลแทรกในหน้าปัดหรือไม่และรองรับกี่รายการ รูปร่างและตำแหน่งของข้อมูลแทรกจะเป็นอย่างไร และข้อมูลประเภทใดที่ รองรับ
พื้นที่แต่ละส่วนบนหน้าปัดสำหรับคอมพลิเคชันจะกำหนดเป็น
ComplicationSlot ซึ่งจะกำหนดพื้นที่ล้อมรอบสำหรับการแสดงผล
คอมพลิเคชัน
<ComplicationSlot slotId="1" supportedTypes="SHORT_TEXT SMALL_IMAGE EMPTY" x="100" y="100" width="100" height="100"> <BoundingOval x="0" y="0" width="100" height="100" /> <Complication type="SHORT_TEXT"> <!-- Complication content for rendering SHORT_TEXT data goes here --> </Complication> <Complication type="SMALL_IMAGE"> <!-- Complication content for rendering SMALL_IMAGE data goes here --> </Complication> </ComplicationSlot>
คุณสามารถใช้แนวทางที่คล้ายกันกับรูปร่างขอบเขตอื่นๆ เช่น สี่เหลี่ยมผืนผ้า และวงรี
ตั้งค่าประเภทและค่าเริ่มต้นของข้อมูลแทรก
ระบบแทรกข้อมูลมีหลายประเภท ซึ่งช่วยให้หน้าปัดแสดงประเภทข้อมูลที่แสดงบนหน้าจอได้ ตัวอย่างเช่น ภาวะแทรกซ้อนแบบอาร์คตามที่แสดงก่อนหน้านี้ไม่เหมาะกับประเภทข้อมูลภาวะแทรกซ้อนที่อิงตามรูปภาพ เช่น SMALL_IMAGE แต่จะทำงานได้ดีกับข้อมูลตัวเลข เช่น RANGED_VALUE
ในComplicationSlotประกาศ ให้ตั้งค่า supportedTypes เป็น
รายการประเภทที่คั่นด้วยช่องว่างซึ่งแสดงในช่องนี้ได้
คุณต้องตั้งค่าแหล่งที่มาเริ่มต้นสำหรับ ComplicationSlot ด้วย เว้นแต่คุณจะอนุญาตประเภท EMPTY ซึ่งในกรณีนี้การตั้งค่าเริ่มต้นจะเป็นตัวเลือก
<ComplicationSlot slotId="2" supportedTypes="SHORT_TEXT SMALL_IMAGE EMPTY" x="250" y="100" width="100" height="100"> <DefaultProviderPolicy defaultSystemProvider="STEP_COUNT" defaultSystemProviderType="SHORT_TEXT" /> <!-- ... --> </ComplicationSlot>
นอกเหนือจากการระบุผู้ให้บริการระบบแล้ว คุณยังระบุผู้ให้บริการที่ไม่ใช่ระบบได้ด้วย (ไม่บังคับ) เช่น ผู้ให้บริการบุคคลที่สามที่จะใช้โดยค่าเริ่มต้น หากมีการติดตั้งไว้แล้ว
แสดงข้อมูลแทรก
หลังจากกำหนด ComplicationSlot ขอบเขต และองค์ประกอบ Complication
ที่มีแล้ว ให้ใช้คอมโพเนนต์ WFF มาตรฐาน เช่น PartDraw, PartImage และ
PartText เพื่อแสดงข้อมูลแทรก
องค์ประกอบภายในComplicationมีสิทธิ์เข้าถึงแหล่งข้อมูลพิเศษ
COMPLICATION ซึ่งมีพร็อพเพอร์ตี้ข้อมูลต่างๆ ที่กำหนดโดย
แหล่งข้อมูลของคอมพลิเคชัน
เช่น SMALL_IMAGE สามารถตั้งค่า COMPLICATION.SMALL_IMAGE
และ COMPLICATION.SMALL_IMAGE_AMBIENT ได้ คุณใช้สิ่งต่อไปนี้แทน
resource ในองค์ประกอบ Image ได้
<Complication type="SMALL_IMAGE"> <PartImage x="0" y="0" width="100" height="100"> <Image resource="[COMPLICATION.SMALL_IMAGE]" /> </PartImage> </Complication>
การแสดงข้อมูลแทรกแต่ละประเภทจะมีชุดพร็อพเพอร์ตี้ที่ใช้ได้แตกต่างกัน
ซึ่งสามารถตั้งค่าได้ หากต้องการดูรายการทั้งหมดของแต่ละประเภท โปรดดูข้อมูลอ้างอิงของ Complication
ตัวอย่างนี้แสดงข้อความจากSHORT_TEXTภาวะแทรกซ้อน
<Complication type="SHORT_TEXT"> <PartText x="0" y="0" width="100" height="100"> <Text> <Font size="32"> <Template> <![CDATA[%s]]><Parameter expression="[COMPLICATION.TEXT]" /> </Template> </Font> </Text> </PartText> </Complication>
เพิ่มประโยชน์สูงสุดเมื่อแสดงข้อมูลแทรก
การเพิ่ม ComplicationSlots ลงในหน้าปัดนาฬิกา
มีข้อจำกัดหลายประการ ดังนี้
- ข้อมูลแทรกมีหลายประเภท แอปต่างๆ อาจมีฟีเจอร์เหล่านี้อย่างน้อย 1 รายการ
- ข้อมูล Complication แต่ละประเภทนอกเหนือจากพร็อพเพอร์ตี้ที่จำเป็นแล้วยังมีพร็อพเพอร์ตี้ที่ไม่บังคับอีกมากมาย ตรวจสอบว่าการแสดงผลที่มีประโยชน์มากที่สุดสร้างขึ้นจากพร็อพเพอร์ตี้ที่มีอยู่ โดยคำนึงถึงชุดค่าผสมต่างๆ
กลยุทธ์บางอย่างในการแก้ไขปัญหาเหล่านี้ ได้แก่
- รองรับการแสดงข้อมูลแทรกหลายประเภทสำหรับแต่ละช่อง เช่น แหล่งข้อมูลแทรกซ้อนส่วนใหญ่รองรับ
SHORT_TEXTดังนั้นการรองรับตัวเลข ประเภทต่างๆ เช่นSHORT_TEXT RANGED_VALUEสำหรับแทรกซ้อนวงกลมขนาดเล็ก จะช่วยเพิ่มความเข้ากันได้ - เสนอข้อมูลแทรกประเภทต่างๆ ในหน้าปัด ตัวอย่างเช่น คุณ
อาจรองรับ
RANGED_VALUEและGOAL_PROGRESSในข้อมูลแทรก Arc ที่อยู่ขอบ และSHORT_TEXTกับSMALL_IMAGEในข้อมูลแทรกวงกลมที่ ส่วนเนื้อหาของหน้าปัด - ตรวจสอบองค์ประกอบที่ไม่บังคับสำหรับข้อมูลแต่ละประเภท เช่น
SHORT_TEXTรองรับพร็อพเพอร์ตี้ชื่อและรูปภาพโดยไม่บังคับ เลย์เอาต์สำหรับการแสดงผล ข้อมูลที่ใช้ได้อาจแตกต่างกันไปตามว่ามีรูปภาพหรือชื่อ หรือไม่