ช่องข้อมูลแทรกคือพื้นที่บนหน้าปัดที่ผู้ใช้สามารถเพิ่มข้อมูลแทรกได้ ช่องข้อมูลแทรกประกอบด้วยองค์ประกอบข้อมูลแทรก ซึ่งจะกำหนดวิธีแสดงผลข้อมูลแทรกสำหรับข้อมูลแทรกประเภทต่างๆ และในโหมดหน้าปัดต่างๆ
เปิดตัวใน Wear OS 4
วากยสัมพันธ์
<ComplicationSlot x="integer" y="integer" width="integer" height="integer" pivotX="float" pivotY="float" angle="float-degrees" alpha="integer" slotId="integer" name="string" displayName="string" scaleX="float" scaleY="float" supportedTypes="string" isCustomizable="boolean" tintColor="argb-color | rgb-color" />
แอตทริบิวต์
ComplicationSlot มีแอตทริบิวต์ต่อไปนี้
แอตทริบิวต์ที่จำเป็น
คุณต้องระบุแอตทริบิวต์ต่อไปนี้
x,y,width,height- คอลเล็กชันจำนวนเต็มซึ่งระบุขนาดและตำแหน่งขององค์ประกอบ
slotId- ตัวระบุตัวเลขที่ไม่ซ้ำกันสำหรับช่อง
supportedTypes- รายการประเภทข้อมูลแทรกที่รองรับซึ่งจะแสดงในช่องได้
ค่าที่รองรับคือ
SHORT_TEXT,LONG_TEXT,MONOCHROMATIC_IMAGE,SMALL_IMAGE,PHOTO_IMAGE,RANGED_VALUEและEMPTYระบบรองรับข้อมูลแทรกหลายประเภทโดยคั่นด้วยเว้นวรรค (เช่นSHORT_TEXT RANGED_VALUE)
แอตทริบิวต์ที่ไม่บังคับ
คุณจะใช้แอตทริบิวต์ต่อไปนี้หรือไม่ก็ได้
pivotX,pivotY- จุดหมุน 2 มิติที่องค์ประกอบหมุนรอบ ค่าทั้ง 2 ค่าเป็นจํานวนทศนิยมที่มีการปรับขนาดให้พอดีกับช่วง $ [0, 1] $
angle- จำนวนองศาตามเข็มนาฬิกาที่ควรหมุนองค์ประกอบรอบจุดหมุน
alpha- ตั้งค่าระดับความโปร่งใสที่องค์ประกอบนี้ควรมี ค่า
0บ่งบอกว่าองค์ประกอบควรมีความโปร่งใสทั้งหมด ค่า255บ่งบอกว่าองค์ประกอบควรทึบแสงทั้งหมด scaleX- ค่าตัวคูณมาตราส่วนแนวนอนที่จะใช้กับองค์ประกอบนี้
scaleY- ค่าตัวคูณมาตราส่วนแนวตั้งที่จะใช้กับองค์ประกอบนี้
tintColor- ใช้ฟิลเตอร์สีกับองค์ประกอบ คุณต้องระบุสีโดยใช้รูปแบบ ARGB (
#ff000000= สีดําทึบ) หรือรูปแบบ RGB (#000000= สีดํา) displayName- รหัสทรัพยากรที่สอดคล้องกับชื่อที่แปลแล้วสำหรับช่องข้อมูลแทรก ซึ่งจะแสดงในเครื่องมือแก้ไขหน้าปัด
isCustomizable- กำหนดว่าผู้ใช้จะเปลี่ยนผู้ให้บริการสำหรับช่องนี้ได้หรือไม่ในเครื่องมือแก้ไขหน้าปัด ค่าเริ่มต้นคือ
TRUE
องค์ประกอบภายใน
องค์ประกอบ ComplicationSlot ต้องมีองค์ประกอบ Bounding Area เพียง 1 รายการ
องค์ประกอบ ComplicationSlot ต้องมีองค์ประกอบ Complication อย่างน้อย 1 รายการต่อการคอมพิลิเคชัน 1 ประเภทที่รองรับ องค์ประกอบ ComplicationSlot อาจประกอบด้วยองค์ประกอบ Complication เพิ่มเติมเพื่อรองรับการเปลี่ยนแปลงลักษณะที่ปรากฏด้วยองค์ประกอบ Variant
องค์ประกอบ ComplicationSlot อาจมีองค์ประกอบภายในต่อไปนี้ด้วย