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