Halaman ini diterjemahkan oleh Cloud Translation API.

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: `false`) 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: `rgb` `hsv`
`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
    }
  }
}

Catatan: Saat menggunakan Status Laporan untuk fitur ColorSetting, pastikan Anda menentukan status RGB sebagai spectrumRGB dan status HSV sebagai spectrumHsv. (Anda harus menggunakan huruf besar ini untuk nama negara bagian.)

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 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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.