Skema Fitur Smart Home ColorSetting
action.devices.traits.ColorSetting
- Ciri 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 heksadesimal, setara dengan nilai heksadesimal untuk triplet yang digabungkan. Misalnya, "biru" adalah (0, 0, 255) dan #0000FF. Anda dapat menggunakan nilai apa pun dalam ruang warna RGB; yaitu, RGB(x, y, z) tempat x, y, z berada dalam rentang [0, 255], inklusif.
HSV merepresentasikan warna sebagai triplet (hue, saturasi, nilai). Setiap nilai warna dalam HSV dapat dikonversi menjadi RGB, dan sebaliknya. Hue memiliki rentang [0, 360) derajat (eksklusif 360, karena mengelilingi 0 derajat). Saturasi dan nilai direpresentasikan oleh float dalam rentang [0.0, 1.0].
Suhu warna mewakili beberapa warna sebagai nilai desimal non-negatif di Kelvin. Atribut ini menjelaskan lampu "putih" atau "warmth", dengan nama warna seperti "cool white" atau "dung 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 subset dari model warna spektrum penuh RGB/HSV. Lihat tabel di bawah untuk mengetahui beberapa contoh suhu dan nama warna yang sesuai.
Suhu (Kelvin) | Nama Warna |
---|---|
2000 | Lampu Lilin |
2500 | Putih Ultra Hangat |
3000 | Putih Lembut, Putih Pagi, Putih Baca |
4000 | Putih Sejuk |
5000 | Siang Hari, Putih |
6.000 | Putih Bunga |
7.000 | Siang Hari Berawan, Asap Putih |
8.000 | Biru Mendung |
9.000 | Biru Langit |
ATRIBUT Perangkat
Perangkat dengan karakteristik ini dapat melaporkan atribut
berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
fulfillment intent.
Atribut | Jenis | Deskripsi |
---|---|---|
commandOnlyColorSetting |
Boolean |
(Default: Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk fitur ini. |
Berisi salah satu dari 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 di Kelvin. |
temperatureMinK |
Integer |
Wajib. Suhu warna minimum yang didukung di Kelvin. |
temperatureMaxK |
Integer |
Wajib. Suhu warna maksimum yang didukung di 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 | Jenis | Deskripsi |
---|---|---|
color |
Objek |
Wajib. Setelan warna saat ini yang sedang digunakan di perangkat. |
Berisi salah satu dari item berikut: | ||
0
|
Objek |
Dukungan suhu warna. |
temperatureK |
Integer |
Wajib. Nilai suhu dalam Kelvin. |
1
|
Objek |
Dukungan spektrum RGB warna. |
spectrumRgb |
Integer |
Wajib. Nilai RGB spektrum sebagai bilangan bulat desimal. |
2
|
Objek |
Dukungan spektrum warna HSV. |
spectrumHsv |
Objek |
Wajib. Nilai Spektrum HSV. |
hue |
Number |
Hue. |
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 } } }
COMMAND Perangkat
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 | Jenis | Deskripsi |
---|---|---|
color |
Objek |
Wajib. Warna yang akan disetel. |
name |
String |
Nama warna yang diuraikan dari perintah pengguna; mungkin tidak selalu tersedia (misalnya saat menggunakan perintah relatif). |
Berisi salah satu dari 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 RGB spektrum sebagai bilangan bulat desimal. Lihat RGB, HSV, dan suhu warna untuk mengetahui detailnya. |
2
|
Objek |
Dukungan spektrum warna HSV. |
spectrumHSV |
Objek |
Wajib. Nilai Spektrum HSV. Lihat RGB, HSV, dan suhu warna untuk mengetahui detailnya. |
hue |
Number |
Hue. |
saturation |
Number |
Saturasi. |
value |
Number |
Nilai. |
Contoh
Buat lampu menjadi putih hangat.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } }
Jadikan magenta terang.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumRGB": 16711935 } } }
Jadikan magenta terang.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumHSV": { "hue": 300, "saturation": 1, "value": 1 } } } }
Perlu diketahui bahwa nama parameter sedikit berbeda antara parameter perintah dan status. Hal ini bertujuan untuk menghindari konflik dengan parameter status untuk fitur 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 aufblau -
Stelle die Farbtemperatur auf
3000 Kelvin ein.
en-US
-
can you adjust
my lights color to4000 kelvins -
set
the lights toblue
es-ES
-
pon
azul la luz de la cocina -
pon
la luz a2000 k de temperatura de color
fr-FR
-
Allume
la lampe de la chambre à3500 kelvins . -
mets
les lampes enrose dansla chambre
hi-IN
-
तुम
लाइट कोब्लू कर दो -
लैम्प 2000 केल्विन पर लगाओ।
it-IT
-
Imposta
la lampada a2000 K . -
metti
la luce gialla
ja-JP
-
照明 の色を青 にして -
照明 の色温度を5000K にセットして
ko-KR
-
조명 색깔흰색 으로 바꿔 줘 -
주방 전등 색 온도를5000 켈빈 으로 설정해
nl-NL
-
Zet
de keukenlamp op2000 Kelvin . -
maak
het licht rood
pt-BR
-
Colocar
a lâmpada em2000 K . -
Define
a lâmpada para2000 K . -
colocar
a luz da sala emazul -
põe
a luz da sala avermelho
sv-SE
-
Ställ in
lampan på2000 Kelvin -
tänd
blått ljus i köket