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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

โดยปกติแล้วข้อมูลแทรกจะมีหลายรูปแบบ ดังนี้

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="0" y="0" width="225" height="225">
    <BoundingArc centerX="225" centerY="225" width="450" height="450"
        startAngle="270" endAngle="360" thickness="50" />
  <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="1" ...>
    <BoundingArc .../>
    <DefaultProviderPolicy
        defaultSystemProvider="STEP_COUNT"
        defaultSystemProviderType="SHORT_TEXT" />
</ComplicationSlot>

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

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

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

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

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

<Complication type="SMALL_IMAGE">
  <PartImage ...>
    <Image resource="[COMPLICATION.SMALL_IMAGE]" />
  </PartImage>
</Complication>

ข้อมูลแทรกแต่ละประเภทจะมีชุดคุณสมบัติที่แตกต่างกันซึ่งสามารถตั้งค่าได้ ดูรายการทั้งหมดของข้อมูลแทรกแต่ละรายการได้ที่ข้อมูลอ้างอิง Complication ตัวอย่างนี้แสดงข้อความจากข้อมูลแทรก SHORT_TEXT

<Complication type="SHORT_TEXT">
  <PartText ...>
    <Text>
      <Font ...>
        <Template>
          <![CDATA[%s]]><Parameter expression="[COMPLICATION.TEXT]" />
        </Template>
      </Font>
  </PartImage>
</Complication>

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

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

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

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

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