ภาวะแทรกซ้อนของหน้าปัดนาฬิกาจะแสดงข้อมูลจากแหล่งข้อมูล เมื่อใช้รูปแบบหน้าปัดนาฬิกา คุณจะเลือกแหล่งข้อมูลเพื่อรับข้อมูลพื้นฐานได้ ซึ่งจะช่วยให้หน้าปัดแสดงข้อมูลอื่นๆ นอกเหนือจากเวลาของวันได้ โดยไม่ต้องใช้โค้ดเพื่อรับข้อมูล
ใช้ 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 ด้วยเหตุนี้ เราจึงขอแนะนำให้คุณย้ายข้อมูลไปใช้ รูปแบบหน้าปัดนาฬิกา
แนะนำสำหรับคุณ
- หมายเหตุ: ข้อความลิงก์จะแสดงเมื่อ JavaScript ปิดอยู่
- การเปิดเผยข้อมูลต่อข้อมูลแทรกของหน้าปัดนาฬิกาใน Wear OS
- ข้อมูลแทรก
- DefaultProviderPolicy