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

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

ใช้รูปแบบหน้าปัด

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

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

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

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





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

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

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

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