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

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

โดยทั่วไปแล้ว Complication จะมีหลายรูปแบบดังนี้

  1. สี่เหลี่ยมผืนผ้า
  2. เป็นวงกลม
  3. ส่วนโค้งตามขอบของหน้าปัด
  4. พื้นหลังที่ครอบคลุมทั้งหน้าปัด

ใน Wear OS ระบบแทรกข้อมูลแบ่งออกเป็น 2 ส่วน ดังนี้

  1. แหล่งข้อมูลของภาวะแทรกซ้อน
  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. ข้อมูลแทรกมีหลายประเภท แอปต่างๆ อาจมีฟีเจอร์เหล่านี้อย่างน้อย 1 รายการ
  2. ข้อมูล Complication แต่ละประเภทนอกเหนือจากพร็อพเพอร์ตี้ที่จำเป็นแล้วยังมีพร็อพเพอร์ตี้ที่ไม่บังคับอีกมากมาย ตรวจสอบว่าการแสดงผลที่มีประโยชน์มากที่สุดสร้างขึ้นจากพร็อพเพอร์ตี้ที่มีอยู่ โดยคำนึงถึงชุดค่าผสมต่างๆ

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

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