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