เพิ่มข้อมูลแทรกไปยังหน้าปัด

ข้อมูลแทรกของหน้าปัดแสดงข้อมูลจากแหล่งข้อมูล การใช้ Watch Face Format คุณสามารถเลือกแหล่งข้อมูลเพื่อดาวน์โหลด การตั้งค่านี้ช่วยให้หน้าปัดแสดงข้อมูลหลังจากผ่านช่วงเวลาของวันได้ โดยไม่ต้องใช้โค้ดในการรับข้อมูล

ใช้ Watch Face Format

องค์ประกอบ Complication ให้คุณระบุข้อมูลแทรกได้สูงสุด 8 รายการภายใน หน้าปัดหน้าเดียว องค์ประกอบนี้ยังให้คุณกำหนดตำแหน่งบนหน้าปัดด้วย ข้อมูลแทรกแต่ละรายการจะปรากฏขึ้น

ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่าง WatchFaceFormat ใน GitHub

ประเภทและฟิลด์

ตารางต่อไปนี้อธิบายประเภทและฟิลด์ของ ComplicationData หากหน้าปัดขอช่องที่ไม่ถูกต้อง สำหรับประเภทข้อมูลแทรก ระบบจะแสดงผลค่าเริ่มต้นของช่อง ตัวอย่างเช่น หากหน้าปัดพยายามเข้าถึงช่อง LONG_TEXT ในประเภท SHORT_TEXT ค่าเริ่มต้นของฟิลด์ LONG_TEXT คือค่า Null ช่องที่ไม่บังคับของโน้ต ไม่รับประกันว่าจะมีการแสดง





ประเภท ช่องที่ต้องกรอก ช่องที่ไม่บังคับ หมายเหตุ
SHORT_TEXT ข้อความสั้น ไอคอน
ไอคอนป้องกันการเบิร์น
ชื่อย่อ
คำอธิบายเนื้อหา

แสดงไอคอนหรือชื่อย่อเพียงไอคอนเดียว หากมี ทั้ง 2 อย่าง
MONOCHROMATIC_IMAGE รูปภาพสีเดียว
 ไอคอนป้องกันการเบิร์น
คำอธิบายเนื้อหา

ใช้เมื่อไม่จำเป็นต้องใช้ข้อความ ไอคอนควรเป็นสีเดียว และอาจถูกแต้มสีโดยหน้าปัด
RANGED_VALUE ค่า
ค่าต่ำสุด
ค่าสูงสุด
 รูปภาพสีเดียว
ไอคอนป้องกันการเบิร์น
ข้อความสั้น
ชื่อย่อ
ระดับสี
ค่าแบบไดนามิก
คำอธิบายเนื้อหา

หากต้องการวาดแถบความคืบหน้าของตัวเอง คุณสามารถใช้ เมธอด isRangedValueProgressHidden() เพื่อซ่อนแถบความคืบหน้า โดย ComplicationDrawable
GOAL_PROGRESS ค่า
ค่าเป้าหมาย
รูปภาพสีเดียว
ไอคอนป้องกันการเบิร์น
ข้อความสั้น
ชื่อย่อ
ระดับสี
ค่าแบบไดนามิก
คำอธิบายเนื้อหา

GOAL_PROGRESS มีไว้สำหรับสิ่งต่างๆ เช่น จำนวนก้าวที่เริ่มใช้ค่า อยู่ที่ 0 และอนุญาตให้เกินค่า "เป้าหมาย"
LONG_TEXT ข้อความยาว
 ชื่อเต็ม
รูปภาพสีเดียว
ไอคอนป้องกันการเบิร์น
รูปภาพขนาดเล็ก
คำอธิบายเนื้อหา
แสดงชื่อยาว (หากมี)
SMALL_IMAGE รูปภาพขนาดเล็ก
 คำอธิบายเนื้อหา
รูปภาพขนาดเล็กมี 1 ใน 2 รูปแบบ ได้แก่ สไตล์รูปภาพหรือไอคอน style [รูปแบบ] รูปแบบรูปภาพหมายความว่าระบบควรจะเติมพื้นที่ทั้งหมด และ ครอบตัดแล้ว รูปแบบไอคอนหมายความว่าไม่สามารถครอบตัดและกันบุ๋มได้ ความแปรปรวนของรูปภาพอาจส่งผลให้รูปภาพไม่เหมาะกับการแสดงผล ในโหมดแอมเบียนท์ในอุปกรณ์ป้องกันภาพเบิร์นอินหรือโหมดบิตต่ำ โหมดแอมเบียนท์ เมื่อการป้องกันภาพค้างในหน้าจอหรือโหมดแอมเบียนท์บิตต่ำ เปิดใช้แล้ว หน้าปัดอาจใช้การป้องกันภาพเบิร์นขนาดเล็ก เนื่องจากปลอดภัย ไม่เช่นนั้น เนื่องจากนาฬิกาทำงานยาก เพื่อกำหนดความเหมาะสม รูปภาพจะไม่ปรากฏ
LARGE_IMAGE รูปภาพขนาดใหญ่
 คำอธิบายเนื้อหา
รูปภาพนี้ควรมีขนาดใหญ่พอที่จะแสดงเต็มหน้าปัด ความแปรปรวนของรูปภาพอาจส่งผลให้รูปภาพไม่เหมาะกับการแสดงผล ในโหมดแอมเบียนท์ในอุปกรณ์ป้องกันภาพเบิร์นอินหรือโหมดบิตต่ำ โหมดแอมเบียนท์ เนื่องจากระบุหน้าปัดได้ยาก ความเหมาะสมในการแสดง หน้าปัดไม่แสดงรูปภาพ ในโหมดแอมเบียนท์ หากเปิดใช้การป้องกันภาพค้างในหน้าจอหรือโหมดแอมเบียนท์บิตต่ำ
WEIGHTED_ELEMENTS รายการองค์ประกอบ
 รูปภาพสีเดียว
ไอคอนป้องกันการเบิร์น
ข้อความสั้น
ชื่อย่อ
คำอธิบายเนื้อหา
องค์ประกอบแต่ละรายการประกอบด้วยสีและน้ำหนัก (มากกว่า 0) ขนาดขององค์ประกอบเมื่อแสดงผลควรเป็นสัดส่วนตามน้ำหนักขององค์ประกอบ ไม่จำเป็นต้องใช้น้ำหนักเพื่อบวกเป็นค่าใดๆ โปรดทราบว่าหน้าปัดของโน้ตได้รับอนุญาตให้เปลี่ยนสี WEIGHTED_ELEMENTS

ตารางต่อไปนี้อธิบายประเภทข้อมูลแทรกสำหรับข้อมูลว่างที่ สามารถส่งสำหรับช่องข้อมูลแทรกใดๆ ก็ได้ ประเภทเหล่านี้ไม่มีช่อง และไม่จำเป็นต้องรวมไว้ในบัญชี รายการประเภทที่รองรับ ประเภทเหล่านี้ช่วยให้นาฬิกา ใบหน้าเพื่อแยกความแตกต่างระหว่าง 3 กรณีต่อไปนี้

  • ไม่ได้เลือกแหล่งที่มา
  • ผู้ใช้เลือก "ว่าง" สำหรับสล็อต
  • แหล่งที่มาไม่มีข้อมูลที่จะส่ง

แหล่งที่มาไม่สามารถส่ง TYPE_EMPTY เพื่อตอบสนองต่อ คำขออัปเดต โปรดส่ง TYPE_NO_DATA แทน

ประเภทข้อมูลแทรก คำอธิบาย
TYPE_NOT_CONFIGURED ส่งโดยระบบเมื่อข้อมูลแทรกเปิดใช้งาน แต่ผู้ใช้ ไม่ได้เลือกแหล่งที่มา และไม่มีการตั้งค่าเริ่มต้นไว้

ส่งตามแหล่งที่มาไม่ได้

TYPE_EMPTY ส่งโดยระบบเมื่อข้อมูลแทรกเปิดใช้งานและผู้ใช้ เลือก "ว่าง" แทนที่จะเป็นแหล่งที่มา หรือเมื่อหน้าปัด จะเลือกไม่มีแหล่งที่มาและประเภทข้อมูลแทรกนี้เป็นค่าเริ่มต้น

ส่งตามแหล่งที่มาไม่ได้

TYPE_NO_DATA ส่งโดยระบบเมื่อข้อมูลแทรกที่มีแหล่งที่มา เปิดใช้งานเพื่อล้างข้อมูลแทรกก่อนจะได้รับข้อมูลจริง จากแหล่งข้อมูล

สามารถส่งตามแหล่งที่มาหากไม่มีข้อมูลจริงที่จะส่ง

หน้าปัดและข้อมูลแทรกในอุปกรณ์บางรุ่นต้องใช้ Watch Face Format

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

  • อุปกรณ์ที่ใช้ Wear OS 4 หรือเก่ากว่า
  • อุปกรณ์ที่ได้รับการอัปเกรด OTA เป็น Wear OS 5

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

อย่างไรก็ตาม ในนาฬิกาใหม่เปิดตัวด้วย Wear OS 5 หน้าปัดต้องใช้ Watch Face Format ด้วยเหตุนี้ เราขอแนะนำให้คุณเปลี่ยนไปใช้ Watch Face Format