ให้ข้อมูลที่เป็นประโยชน์ผ่านข้อมูลแทรก

ข้อมูลแทรกเป็นฟีเจอร์ของทั้งหน้าปัดนาฬิกาจริงและสมาร์ทวอทช์ ที่แสดงข้อมูลเพิ่มเติม โดยปกติแล้วผู้ใช้จะเลือกข้อมูลที่จะแสดงใน Complication

โดยทั่วไปแล้ว 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>watchface_complications.xml

คุณสามารถใช้แนวทางที่คล้ายกันกับรูปร่างขอบเขตอื่นๆ เช่น สี่เหลี่ยมผืนผ้า และวงรี

ตั้งค่าประเภทข้อมูลแทรกและค่าเริ่มต้น

ระบบแทรกข้อมูลมีหลายประเภท ซึ่งช่วยให้หน้าปัดแสดงประเภทข้อมูลที่แสดงบนหน้าจอได้ ตัวอย่างเช่น ภาวะแทรกซ้อนแบบอาร์คดังที่แสดงก่อนหน้านี้ไม่เหมาะกับประเภทข้อมูลภาวะแทรกซ้อนที่อิงตามรูปภาพ เช่น 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>watchface_complications.xml

นอกเหนือจากการระบุผู้ให้บริการระบบแล้ว คุณยังระบุผู้ให้บริการที่ไม่ใช่ระบบได้ด้วย (ไม่บังคับ) เช่น ผู้ให้บริการบุคคลที่สามที่จะใช้โดยค่าเริ่มต้น หากมีการติดตั้งไว้แล้ว

แสดงข้อมูลแทรก

หลังจากกำหนด ComplicationSlot ขอบเขต และองค์ประกอบ Complication ที่มีแล้ว ให้ใช้คอมโพเนนต์ WFF มาตรฐาน เช่น PartDraw, PartImage และ PartText เพื่อแสดงข้อมูลภาวะแทรกซ้อน

องค์ประกอบภายใน Complication มีสิทธิ์เข้าถึงแหล่งข้อมูลพิเศษ COMPLICATION ซึ่งมีพร็อพเพอร์ตี้ข้อมูลต่างๆ ที่กำหนดโดย แหล่งข้อมูลแทรกซ้อน

เช่น SMALL_IMAGE คอมพลิเคชันสามารถตั้งค่า COMPLICATION.SMALL_IMAGE และ COMPLICATION.SMALL_IMAGE_AMBIENT ได้ คุณใช้รายการต่อไปนี้แทน แหล่งข้อมูลในองค์ประกอบ Image ได้

<Complication type="SMALL_IMAGE">
    <PartImage x="0" y="0" width="100" height="100">
        <Image resource="[COMPLICATION.SMALL_IMAGE]" />
    </PartImage>
</Complication>watchface_complications.xml

การแสดงข้อมูลแทรกแต่ละประเภทจะมีชุดพร็อพเพอร์ตี้ที่ใช้ได้แตกต่างกัน ซึ่งสามารถตั้งค่าได้ ดูรายการทั้งหมดของแต่ละประเภทได้ในข้อมูลอ้างอิงของ 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>watchface_complications.xml

เพิ่มประโยชน์สูงสุดเมื่อแสดงข้อมูลแทรก

การเพิ่ม ComplicationSlots ลงในหน้าปัดนาฬิกา มีข้อจำกัดหลายประการดังนี้

ข้อมูลแทรกมีหลายประเภท แอปต่างๆ อาจมีฟีเจอร์เหล่านี้อย่างน้อย 1 รายการ
ข้อมูลแทรกแต่ละประเภทนอกเหนือจากพร็อพเพอร์ตี้ที่จำเป็นแล้วยังมีพร็อพเพอร์ตี้ที่ไม่บังคับอีกมากมาย ตรวจสอบว่าการแสดงผลที่มีประโยชน์มากที่สุดสร้างขึ้นจากพร็อพเพอร์ตี้ที่มีอยู่ โดยคำนึงถึง การผสมผสานต่างๆ

กลยุทธ์บางอย่างในการแก้ไขปัญหาเหล่านี้ ได้แก่

รองรับการแสดงข้อมูลแทรกหลายประเภทสำหรับแต่ละช่อง เช่น แหล่งข้อมูลแทรกซ้อนส่วนใหญ่รองรับ SHORT_TEXT ดังนั้นการรองรับตัวเลข ประเภทต่างๆ เช่น SHORT_TEXT RANGED_VALUE สำหรับแทรกซ้อนวงกลมขนาดเล็ก จะช่วยเพิ่มความเข้ากันได้
เสนอประเภทข้อมูลแทรกที่แตกต่างกันในหน้าปัด เช่น คุณ อาจรองรับ RANGED_VALUE และ GOAL_PROGRESS ในข้อมูลแทรก Arc ที่วางไว้ที่ขอบ และ SHORT_TEXT กับ SMALL_IMAGE ในข้อมูลแทรกแบบวงกลมใน ส่วนเนื้อหาของหน้าปัด
ตรวจสอบองค์ประกอบที่ไม่บังคับสำหรับข้อมูลแต่ละประเภท เช่น SHORT_TEXT รองรับพร็อพเพอร์ตี้ชื่อและรูปภาพโดยไม่บังคับ เลย์เอาต์สำหรับการแสดงผล ข้อมูลที่ใช้ได้อาจแตกต่างกันไปตามว่ามีรูปภาพหรือชื่อ หรือไม่