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

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

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

องค์ประกอบ 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 ด้วยเหตุนี้ เราขอแนะนำให้คุณเปลี่ยนไปใช้ Watch Face Format