สคีมาลักษณะของ Smart Home ColorSetting
action.devices.traits.ColorSetting
- ลักษณะนี้ใช้กับอุปกรณ์ต่างๆ เช่น หลอดไฟอัจฉริยะ ที่สามารถเปลี่ยนสีหรืออุณหภูมิสีได้
RGB, HSV และอุณหภูมิสี
RGB แสดงสีเป็น 3 สี (แดง เขียว น้ำเงิน) RGB คือโมเดลสีเริ่มต้น สามค่า RGB อาจแสดงเป็นรหัสฐานสิบหก เทียบเท่ากับค่าเลขฐานสิบหกสำหรับสามค่าต่อกัน 3 ตัว ตัวอย่างเช่น "สีน้ำเงิน" คือ (0, 0, 255) และ #0000FF คุณสามารถใช้ค่าใดก็ได้ภายในพื้นที่สี RGB นั่นคือ RGB(x, y, z) โดยที่ x, y, z อยู่ภายในช่วง [0, 255] เท่านั้น
HSV แสดงสีเป็น 3 ค่า (โทนสี ความอิ่มตัว ค่า) ระบบอาจแปลงค่าสีใน HSV เป็น RGB และในทางกลับกันด้วย Hue มีช่วง [0, 360) องศา (ไม่รวม 360 องศาเพราะเป็นแบบหมุนรอบ 0 องศา) ความอิ่มตัวและค่าจะแสดงด้วยทศนิยมในช่วง [0.0, 1.0]
อุณหภูมิสีแสดงสีบางค่าเป็นค่าทศนิยมที่ไม่ติดลบในหน่วยเคลวิน แอตทริบิวต์นี้อธิบายไฟ "สีขาว" หรือ "อบอุ่น" โดยมีชื่อสี เช่น "คูลไวท์" หรือ "กลางวันมืดครึ้ม" หลอดไฟอัจฉริยะที่รองรับอุณหภูมิสีมักมีช่วงเคลวิน [2000, 9000] ซึ่งสอดคล้องกับแสงแบบเดิมที่มีเคลวินคงที่ อุณหภูมิสีเป็นค่าเชิงเส้นและส่วนหนึ่งของโมเดลสีเต็มสเปกตรัมแบบ RGB/HSV ดูตัวอย่างอุณหภูมิและชื่อสีที่เกี่ยวข้องในตารางด้านล่าง
อุณหภูมิ (เคลวิน) | ชื่อสี |
---|---|
2000 | แสงเทียน |
2500 | ขาวอุ่นพิเศษ |
3,000 | สีขาวซอฟต์ ไวท์มอร์นิง ไวท์รีดดิ้งไวท์ |
4000 | คูลไวท์ |
5000 | แสงกลางวัน สีขาว |
6000 | สีขาวดอกไม้ |
7000 | แสงวันมีเมฆมาก ควันสีขาว |
8000 | บลูโอเวอร์แคสต์ |
9000 | ฟ้าสด |
ATTRIBUTES ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC
ได้ที่Fulfillment Intent
Attributes | ประเภท | คำอธิบาย |
---|---|---|
commandOnlyColorSetting |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ไม่สามารถตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ |
มีรายการดังต่อไปนี้ | ||
0
|
ออบเจ็กต์ |
การรองรับโมเดลสี |
colorModel |
String |
ต้องระบุ อุปกรณ์รองรับโมเดลสีแบบสเปกตรัมเต็มรูปแบบ ค่าที่รองรับ
|
1
|
ออบเจ็กต์ |
รองรับอุณหภูมิสี |
colorTemperatureRange |
ออบเจ็กต์ |
ต้องระบุ ช่วงอุณหภูมิสีที่รองรับในหน่วยเคลวิน |
temperatureMinK |
จำนวนเต็ม |
ต้องระบุ อุณหภูมิสีต่ำสุดที่รองรับในหน่วยเคลวิน |
temperatureMaxK |
จำนวนเต็ม |
ต้องระบุ อุณหภูมิสีสูงสุดที่รองรับในหน่วยเคลวิน |
ตัวอย่าง
อุปกรณ์ที่รองรับทั้งรูปแบบสีสเปกตรัม RGB และอุณหภูมิสี
{ "colorModel": "rgb", "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
อุปกรณ์ที่รองรับเฉพาะรุ่นสีสเปกตรัม HSV เท่านั้น
{ "colorModel": "hsv" }
อุปกรณ์ที่รองรับเฉพาะอุณหภูมิสี
{ "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
อุปกรณ์ที่รองรับเฉพาะคำสั่งรูปแบบสี HSV เท่านั้น
{ "colorModel": "hsv", "commandOnlyColorSetting": true }
สถานะอุปกรณ์
เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY
ได้ที่Fulfillment Intent
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
color |
ออบเจ็กต์ |
ต้องระบุ การตั้งค่าสีที่ใช้อยู่ในอุปกรณ์ในตอนนี้ |
มีสิ่งใดสิ่งหนึ่งต่อไปนี้ | ||
0
|
ออบเจ็กต์ |
รองรับอุณหภูมิสี |
temperatureK |
จำนวนเต็ม |
ต้องระบุ ค่าอุณหภูมิในหน่วยเคลวิน |
1
|
ออบเจ็กต์ |
สนับสนุนสีสเปกตรัม RGB |
spectrumRgb |
จำนวนเต็ม |
ต้องระบุ ให้ค่า RGB ของสเปกตรัมเป็นเลขจำนวนเต็มทศนิยม |
2
|
ออบเจ็กต์ |
การสนับสนุนสีสเปกตรัม HSV |
spectrumHsv |
ออบเจ็กต์ |
ต้องระบุ ค่า Spectrum HSV |
hue |
Number |
Hue |
saturation |
Number |
ความอิ่มตัว |
value |
Number |
มูลค่า |
ตัวอย่าง
ไฟสีอะไร (ขาวอุ่น)
{ "color": { "temperatureK": 3000 } }
ไฟสีอะไร (สีม่วงแดง)
{ "color": { "spectrumRgb": 16711935 } }
ไฟสีอะไร (สีม่วงแดง)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
COMMANDS ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจตอบสนองต่อคำสั่งต่อไปนี้โดยเป็นส่วนหนึ่งของการดำเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE
ได้ที่Fulfillment Intent
action.devices.commands.ColorAbsolute
กำหนดค่าสีสัมบูรณ์
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
color |
ออบเจ็กต์ |
ต้องระบุ สีที่ต้องการตั้งค่า |
name |
String |
ชื่อสีที่แยกวิเคราะห์จากคำสั่งของผู้ใช้ อาจใช้ไม่ได้เสมอไป (เช่น เมื่อใช้คำสั่งที่เกี่ยวข้อง) |
มีสิ่งใดสิ่งหนึ่งต่อไปนี้ | ||
0
|
ออบเจ็กต์ |
รองรับอุณหภูมิสี |
temperature |
จำนวนเต็ม |
ต้องระบุ ค่าอุณหภูมิในหน่วยเคลวิน ดูรายละเอียดได้ที่ RGB, HSV และอุณหภูมิสี |
1
|
ออบเจ็กต์ |
สนับสนุนสีสเปกตรัม RGB |
spectrumRGB |
จำนวนเต็ม |
ต้องระบุ ให้ค่า RGB ของสเปกตรัมเป็นเลขจำนวนเต็มทศนิยม ดูรายละเอียดได้ที่ RGB, HSV และอุณหภูมิสี |
2
|
ออบเจ็กต์ |
การสนับสนุนสีสเปกตรัม HSV |
spectrumHSV |
ออบเจ็กต์ |
ต้องระบุ ค่า Spectrum HSV ดูรายละเอียดได้ที่ RGB, HSV และอุณหภูมิสี |
hue |
Number |
Hue |
saturation |
Number |
ความอิ่มตัว |
value |
Number |
มูลค่า |
ตัวอย่าง
ทำให้แสงไฟเป็นสีขาวโทนอุ่น
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } }
ทำให้เป็นสีม่วงแดงอ่อน
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumRGB": 16711935 } } }
ทำให้เป็นสีม่วงแดงอ่อน
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumHSV": { "hue": 300, "saturation": 1, "value": 1 } } } }
โปรดทราบว่าชื่อพารามิเตอร์ระหว่างพารามิเตอร์คําสั่งและพารามิเตอร์สถานะจะแตกต่างกันเล็กน้อย การดำเนินการนี้จะหลีกเลี่ยงการชนกับพารามิเตอร์สถานะสำหรับลักษณะ ColorSpectrum และ ColorTemperature ที่เลิกใช้งานแล้ว
คำสั่ง | รัฐ |
---|---|
temperature |
temperatureK |
spectrumRGB |
spectrumRgb |
spectrumHSV |
spectrumHsv |
ตัวอย่างการเปล่งเสียง
de-DE
- Stell die Farbe der Lampe auf blau
- Stelle die Farbtemperatur auf 3000 Kelvin ein.
en-US
- can you adjust my lights color to 4000 kelvins
- set the lights to blue
es-ES
- pon azul la luz de la cocina
- pon la luz a 2000 k de temperatura de color
fr-FR
- Allume la lampe de la chambre à 3500 kelvins .
- mets les lampes en rose dans la chambre
hi-IN
- तुम लाइट को ब्लू कर दो
- लैम्प 2000 केल्विन पर लगाओ।
it-IT
- Imposta la lampada a 2000 K .
- metti la luce gialla
ja-JP
- 照明 の色を 青 にして
- 照明 の色温度を 5000K にセットして
ko-KR
- 조명 색깔 흰색 으로 바꿔 줘
- 주방 전등 색 온도를 5000 켈빈 으로 설정해
nl-NL
- Zet de keukenlamp op 2000 Kelvin .
- maak het licht rood
pt-BR
- Colocar a lâmpada em 2000 K .
- Define a lâmpada para 2000 K .
- colocar a luz da sala em azul
- põe a luz da sala a vermelho
sv-SE
- Ställ in lampan på 2000 Kelvin
- tänd blått ljus i köket