ข้อมูลแทรกของหน้าปัดแสดงข้อมูลจากแหล่งข้อมูล การใช้ 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
แนะนำสำหรับคุณ
(Deprecated) Exposing data to watch face complications on Wear OS
In this codelab, you’ll learn how to expose your data to watch face complications while keeping best practices for the platform in mind.