ข้อมูลแทรก คือฟีเจอร์ใดๆ ที่แสดงบนหน้าปัดนอกเหนือจากเวลา เช่น ตัวบ่งชี้แบตเตอรี่ เป็นข้อมูลแทรก Complications API ใช้ได้กับทั้งหน้าปัดและแอปแหล่งข้อมูล
ส่วนที่เหลือของเอกสารนี้จะอธิบายแหล่งข้อมูล หน้าปัด และ ประเภทข้อมูลแทรก
แหล่งข้อมูลข้อมูลแทรก
แอปที่ให้ข้อมูล เช่น ระดับแบตเตอรี่ สภาพอากาศ หรือจำนวนก้าวแก่หน้าปัดสำหรับ ข้อมูลแทรกเรียกว่า แหล่งข้อมูลข้อมูลแทรก แหล่งข้อมูลเหล่านี้จะให้ข้อมูลดิบและไม่มีหน้าที่ควบคุมวิธีแสดงข้อมูลบนหน้าปัด หากต้องการดูข้อมูลเกี่ยวกับการเขียนแอปที่ให้ข้อมูลแก่หน้าปัด โปรดดูหัวข้อ เปิดเผยข้อมูลต่อ ข้อมูลแทรก
แผนภาพต่อไปนี้แสดงวิธีที่ Wear OS by Google เป็นตัวกลางในการส่งข้อมูลจากแหล่งที่มาไปยังหน้าปัด
ข้อมูลแทรกบนหน้าปัด
หน้าปัดจะได้รับข้อมูลจากแหล่งข้อมูลข้อมูลแทรก ซึ่งช่วยให้หน้าปัดรวมข้อมูลแทรกได้โดยไม่ต้องใช้โค้ดเพื่อรับข้อมูลพื้นฐาน หน้าปัด จะยังคงควบคุมวิธีแสดงข้อมูลได้ จึงสามารถผสานรวมข้อมูล เข้ากับการออกแบบได้อย่างเป็นธรรมชาติ ดูข้อมูลเพิ่มเติมได้ที่คู่มือการออกแบบเกี่ยวกับ ข้อมูลแทรก.
หากต้องการดูวิธีเพิ่มข้อมูลแทรกลงในหน้าปัด โปรดดูหัวข้อ เพิ่มข้อมูลแทรกลงในหน้าปัด
ประเภทข้อมูลแทรก
ประเภทข้อมูลแทรกจะกำหนดประเภทข้อมูลที่แสดงในข้อมูลแทรก
หรือแหล่งข้อมูลได้
เช่น ใช้ประเภท SHORT_TEXT เมื่อข้อมูลประกอบด้วยสตริงสั้นๆ เป็นหลัก ออบเจ็กต์
ComplicationData จะมีข้อมูลแทรกประเภทเดียวเสมอ
ซึ่งกำหนดช่องที่ต้องระบุและช่องที่ไม่บังคับ ช่องที่ต้องระบุ
แสดงถึงข้อมูลหลัก และประเภทส่วนใหญ่จะใช้ชื่อจาก
ช่องที่ต้องระบุ
แหล่งข้อมูลใช้ประเภทข้อมูลแทรกแตกต่างจากหน้าปัด ดังนี้
- แหล่งข้อมูลจะเลือกประเภทข้อมูลแทรกที่จะให้
รวมถึงช่องที่ไม่บังคับของข้อมูลแทรกประเภทนั้นๆ ที่จะให้ และ
จำนวนประเภทต่างๆ ที่รองรับ เช่น แหล่งข้อมูลจำนวนก้าวอาจรองรับประเภท
RANGED_VALUEและSHORT_TEXTและแหล่งข้อมูลการประชุมครั้งถัดไปอาจรองรับประเภทSHORT_TEXTและLONG_TEXT - คุณเลือกจำนวนข้อมูลแทรกที่จะรวมไว้ในหน้าปัด
และประเภทข้อมูลแทรก
ที่จะรองรับได้ เช่น ข้อมูลแทรกแบบหน้าปัดบนหน้าปัดอาจรองรับประเภท
SHORT_TEXT,SMALL_IMAGEและRANGED_VALUEส่วนมาตรวัดบนหน้าปัดอาจรองรับเฉพาะประเภทRANGED_VALUE
ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทข้อมูลแทรกและช่องต่างๆ ที่แต่ละประเภทรองรับได้ที่ หัวข้อ ประเภทข้อมูลแทรก