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