โครงสร้างลักษณะบ้านอัจฉริยะ
action.devices.traits.ColorSetting
- ลักษณะนี้มีผลกับอุปกรณ์ เช่น หลอดไฟอัจฉริยะที่เปลี่ยนสีหรืออุณหภูมิสีได้
RGB, HSV และอุณหภูมิสี
RGB แสดงสีเป็น 3 สี (แดง เขียว น้ําเงิน) RGB คือรูปแบบสีเริ่มต้น Trilet ใดๆ ใน RGB อาจแสดงเป็นเลขฐานสิบหกซึ่งเทียบเท่ากับค่าเลขฐาน 16 สําหรับ Trilet ที่ต่อกันไว้ เช่น "blue" คือ (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 ดูตารางด้านล่างสําหรับตัวอย่างอุณหภูมิและชื่อสีที่เกี่ยวข้อง
อุณหภูมิ (เคลวิน) | ชื่อสี |
---|---|
2,000 | แสงเทียน |
2500 | ขาวอบอุ่นพิเศษ |
3,000 | สีขาวนวล สีขาวเช้า สีขาวการอ่าน |
4,000 | คูลไวท์ |
5000 | แสงกลางวัน สีขาว |
6000 | ดอกไม้สีขาว |
7000 | เมฆหนา สีขาว มีควันสีขาว |
8000 | ฟ้าครึ้ม |
9000 | ฟ้าท้องฟ้า |
แอตทริบิวต์ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
โปรดดูการดําเนินการ Intent
แอตทริบิวต์ | Type | คำอธิบาย |
---|---|---|
commandOnlyColorSetting |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารแบบทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ไม่สามารถตอบสนองต่อความตั้งใจหรือสถานะรายงานสําหรับลักษณะเฉพาะนี้ได้ |
ประกอบด้วยรายการต่อไปนี้ | ||
0
|
ออบเจ็กต์ |
การสนับสนุนโมเดลสี |
colorModel |
สตริง |
ต้องระบุ อุปกรณ์รุ่นสีสเปกตรัมทั้งหมดสนับสนุน ค่าที่รองรับ:
|
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 }
อุปกรณ์ STATES
เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
โปรดดูการดําเนินการ Intent
รัฐ | Type | คำอธิบาย |
---|---|---|
color |
ออบเจ็กต์ |
ต้องระบุ การตั้งค่าสีที่ใช้อยู่ในปัจจุบันในอุปกรณ์ |
ประกอบด้วยรายการต่อไปนี้ | ||
0
|
ออบเจ็กต์ |
รองรับอุณหภูมิสี |
temperatureK |
จำนวนเต็ม |
ต้องระบุ ค่าอุณหภูมิในหน่วยเคลวิน |
1
|
ออบเจ็กต์ |
รองรับสีสเปคตรัม RGB |
spectrumRgb |
จำนวนเต็ม |
ต้องระบุ ค่า RGB ของสเปกตรัมเป็นจํานวนเต็มทศนิยม |
2
|
ออบเจ็กต์ |
รองรับสีสเปคตรัม HSV |
spectrumHsv |
ออบเจ็กต์ |
ต้องระบุ ค่า Spectrum HSV |
hue |
Number |
เดี๋ยวก่อนนะ |
saturation |
Number |
ความอิ่มตัว |
value |
Number |
ค่า |
ตัวอย่าง
สีของหลอดไฟคืออะไร (สีอบอุ่น)
{ "color": { "temperatureK": 3000 } }
สีของหลอดไฟคืออะไร (สีม่วงแดง)
{ "color": { "spectrumRgb": 16711935 } }
สีของหลอดไฟคืออะไร (สีม่วงแดง)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
อุปกรณ์ COMMANDS
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
โปรดดูการดําเนินการ Intent
action.devices.commands.ColorAbsolute
กําหนดค่าสีสัมบูรณ์
พารามิเตอร์
พารามิเตอร์ | Type | คำอธิบาย |
---|---|---|
color |
ออบเจ็กต์ |
ต้องระบุ สีที่จะกําหนด |
name |
สตริง |
ชื่อสีที่แยกวิเคราะห์จากคําสั่งของผู้ใช้ อาจไม่พร้อมใช้งานเสมอไป (เช่น เมื่อใช้คําสั่งสัมพัทธ์) |
ประกอบด้วยรายการต่อไปนี้ | ||
0
|
ออบเจ็กต์ |
รองรับอุณหภูมิสี |
temperature |
จำนวนเต็ม |
ต้องระบุ ค่าอุณหภูมิในหน่วยเคลวิน โปรดดูรายละเอียดใน RGB, HSV และอุณหภูมิสี |
1
|
ออบเจ็กต์ |
รองรับสีสเปคตรัม RGB |
spectrumRGB |
จำนวนเต็ม |
ต้องระบุ ค่า RGB ของสเปกตรัมเป็นจํานวนเต็มทศนิยม โปรดดูรายละเอียดใน RGB, HSV และอุณหภูมิสี |
2
|
ออบเจ็กต์ |
รองรับสีสเปคตรัม HSV |
spectrumHSV |
ออบเจ็กต์ |
ต้องระบุ ค่า Spectrum HSV โปรดดูรายละเอียดใน RGB, HSV และอุณหภูมิสี |
hue |
Number |
เดี๋ยวก่อนนะ |
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