Skema Trait Setelan Warna Smart Home
action.devices.traits.ColorSetting
- Trait ini berlaku untuk perangkat, seperti lampu smart, yang dapat mengubah warna atau suhu warna.
RGB, HSV, dan suhu warna
RGB mewakili warna sebagai triplet (merah, hijau, biru). RGB adalah model warna default. Setiap triplet RGB dapat direpresentasikan sebagai kode heksadesimal, setara dengan nilai heksadesimal untuk gabungan triplet. Misalnya, "biru" adalah (0, 0, 255) dan #0000FF. Anda dapat menggunakan nilai apa pun dalam ruang warna RGB; yaitu, RGB(x, y, z) di mana x, y, z berada dalam rentang [0, 255], inklusif.
HSV mewakili warna sebagai triplet (hue, saturasi, nilai). Nilai warna apa pun di HSV dapat dikonversi menjadi RGB, dan sebaliknya. Hue memiliki rentang [0, 360) derajat (tidak termasuk 360, karena melingkar ke 0 derajat). Saturasi dan nilai direpresentasikan oleh float dalam rentang [0,0, 1,0].
Suhu warna mewakili beberapa warna sebagai nilai desimal non-negatif dalam Kelvin. Atribut ini menjelaskan lampu "putih" atau "hangat", dengan nama warna seperti "putih sejuk" atau "siang mendung". Lampu smart yang mendukung suhu warna biasanya memiliki rentang [2000, 9000] Kelvin, yang sesuai dengan lampu konvensional dengan Kelvin tetap. Suhu warna adalah skala linear dan merupakan subset model warna spektrum penuh RGB/HSV. Lihat tabel di bawah ini untuk beberapa contoh suhu dan nama warna yang sesuai.
Suhu (Kelvin) | Nama Warna |
---|---|
2.000 | Lampu Lilin |
2500 | Putih Ultra Hangat |
3000 | Putih Lembut, Putih Pagi, Putih Membaca |
4.000 | Putih Sejuk |
5000 | Siang Terang, Putih |
6.000 | Putih Bunga |
7.000 | Berawan pada Hari Berawan, Asap Putih |
8.000 | Biru Mendung |
9.000 | Biru Langit |
ATTRIBUTE Perangkat
Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
Fulfillment intent.
Atribut | Type | Deskripsi |
---|---|---|
commandOnlyColorSetting |
Boolean |
(Default: Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Setel atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini. |
Berisi salah satu item berikut: | ||
0
|
Objek |
Dukungan model warna. |
colorModel |
String |
Wajib. Model warna spektrum penuh yang didukung oleh perangkat. Nilai yang didukung:
|
1
|
Objek |
Dukungan suhu warna. |
colorTemperatureRange |
Objek |
Wajib. Rentang suhu warna yang didukung dalam Kelvin. |
temperatureMinK |
Integer |
Wajib. Suhu warna minimum yang didukung dalam Kelvin. |
temperatureMaxK |
Integer |
Wajib. Suhu warna maksimum yang didukung dalam Kelvin. |
Contoh
Perangkat yang mendukung model warna spektrum RGB dan suhu warna.
{ "colorModel": "rgb", "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Perangkat yang hanya mendukung model warna spektrum HSV.
{ "colorModel": "hsv" }
Perangkat yang hanya mendukung suhu warna.
{ "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Perangkat yang hanya mendukung perintah model warna HSV.
{ "colorModel": "hsv", "commandOnlyColorSetting": true }
STATUS Perangkat
Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
Fulfillment intent.
Negara bagian | Type | Deskripsi |
---|---|---|
color |
Objek |
Wajib. Setelan warna saat ini yang sedang digunakan di perangkat. |
Berisi salah satu item berikut: | ||
0
|
Objek |
Dukungan suhu warna. |
temperatureK |
Integer |
Wajib. Nilai suhu dalam Kelvin. |
1
|
Objek |
Dukungan spektrum RGB warna. |
spectrumRgb |
Integer |
Wajib. Nilai spektrum RGB sebagai bilangan bulat desimal. |
2
|
Objek |
Dukungan spektrum HSV warna. |
spectrumHsv |
Objek |
Wajib. Nilai spektrum HSV. |
hue |
Number |
Rona. |
saturation |
Number |
Saturasi. |
value |
Number |
Nilai. |
Contoh
Apa warna lampunya? (Putih Hangat)
{ "color": { "temperatureK": 3000 } }
Apa warna lampunya? (Magenta)
{ "color": { "spectrumRgb": 16711935 } }
Apa warna lampunya? (Magenta)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
Perangkat COMMAND
Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
penanganan intent EXECUTE
lebih lanjut, lihat
Fulfillment intent.
action.devices.commands.ColorAbsolute
Tetapkan nilai warna absolut.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
color |
Objek |
Wajib. Warna yang akan ditetapkan. |
name |
String |
Nama warna yang diuraikan dari perintah pengguna; mungkin tidak selalu tersedia (yaitu saat menggunakan perintah relatif). |
Berisi salah satu item berikut: | ||
0
|
Objek |
Dukungan suhu warna. |
temperature |
Integer |
Wajib. Nilai suhu dalam Kelvin. Lihat RGB, HSV, dan suhu warna untuk mengetahui detailnya. |
1
|
Objek |
Dukungan spektrum RGB warna. |
spectrumRGB |
Integer |
Wajib. Nilai spektrum RGB sebagai bilangan bulat desimal. Lihat RGB, HSV, dan suhu warna untuk mengetahui detailnya. |
2
|
Objek |
Dukungan spektrum HSV warna. |
spectrumHSV |
Objek |
Wajib. Nilai spektrum HSV. Lihat RGB, HSV, dan suhu warna untuk mengetahui detailnya. |
hue |
Number |
Rona. |
saturation |
Number |
Saturasi. |
value |
Number |
Nilai. |
Contoh
Buat cahaya menjadi putih hangat.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } }
Buat warna magenta terang.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumRGB": 16711935 } } }
Buat warna magenta terang.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumHSV": { "hue": 300, "saturation": 1, "value": 1 } } } }
Perhatikan bahwa nama parameter sedikit berbeda antara parameter perintah dan status. Ini akan menghindari konflik dengan parameter status untuk trait ColorSpectrum dan ColorTemperature yang tidak digunakan lagi.
Perintah | Negara Bagian |
---|---|
temperature |
temperatureK |
spectrumRGB |
spectrumRgb |
spectrumHSV |
spectrumHsv |
Contoh ucapan
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