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

ภาวะแทรกซ้อนของหน้าปัดนาฬิกาจะแสดงข้อมูลจากแหล่งข้อมูล เมื่อใช้รูปแบบหน้าปัดนาฬิกา คุณจะเลือกแหล่งข้อมูลเพื่อรับข้อมูลพื้นฐานได้ ซึ่งจะช่วยให้หน้าปัดแสดงข้อมูลอื่นๆ นอกเหนือจากเวลาของวันได้ โดยไม่ต้องใช้โค้ดเพื่อรับข้อมูล

ใช้ 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 รูปภาพขนาดเล็ก
 คำอธิบายเนื้อหา
 รูปภาพขนาดเล็กมี 2 รูปแบบ ได้แก่ รูปแบบรูปภาพหรือรูปแบบไอคอน รูปแบบรูปภาพหมายความว่ารูปภาพควรเติมเต็มพื้นที่และสามารถ ครอบตัดได้ รูปแบบไอคอนหมายความว่าไม่สามารถครอบตัดได้ แต่สามารถเพิ่มระยะขอบได้ ความแปรปรวนของรูปภาพอาจส่งผลให้รูปภาพไม่เหมาะสมที่จะแสดง ในโหมดแอมเบียนท์บนอุปกรณ์ที่มีการป้องกันภาพเบิร์นอินหรือมีโหมดแอมเบียนท์ แบบบิตต่ำ เมื่อเปิดใช้การป้องกันภาพคงค้างหรือโหมดรอบข้างแบบบิตต่ำ หน้าปัดอาจใช้รูปภาพขนาดเล็กสำหรับการป้องกันภาพคงค้าง เนื่องจากปลอดภัย มิเช่นนั้น ระบบจะไม่แสดงรูปภาพเนื่องจากหน้าปัด ระบุความเหมาะสมได้ยาก
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 Watch Face หรือ ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ ผู้ใช้จะยังคงเห็นข้อมูลจากแหล่งข้อมูลทั้งหมด ในข้อมูลแทรกของหน้าปัดในอุปกรณ์ต่อไปนี้

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

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

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