Skema Karakter Setelan Warna Smart Home

action.devices.traits.ColorSetting - Sifat ini berlaku untuk perangkat, seperti lampu smart, yang dapat mengubah warna atau suhu warna.

RGB, HSV, dan suhu warna

RGB merepresentasikan warna sebagai triplet (merah, hijau, biru). RGB adalah model warna default. Triplet RGB apa pun dapat direpresentasikan sebagai hexcode, yang 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) dengan x, y, z berada dalam rentang [0, 255], inklusif.

HSV merepresentasikan warna sebagai triplet (hue, saturasi, nilai). Nilai warna apa pun dalam HSV dapat dikonversi ke RGB, dan sebaliknya. Hue memiliki rentang [0, 360) derajat (eksklusif 360, karena memutar 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 dingin" atau "cahaya siang berawan". 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 ini untuk beberapa contoh suhu dan nama warna yang sesuai.

Suhu (Kelvin) Nama Warna
2000Cahaya Lilin
2500Putih Ultra Hangat
3000Putih Lembut, Putih Pagi, Putih Baca
4000Putih Sejuk
5000Siang Hari, Putih
6000Floral White
7.000Cloudy Day Light, White Smoke
8.000Biru Mendung
9000Langit Biru

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 (true) atau dua arah (false). Tetapkan atribut ini ke 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:

rgb
hsv
1 Objek

Dukungan suhu warna.
colorTemperatureRange Objek

Wajib.

Rentang suhu warna yang didukung dalam Kelvin.
temperatureMinK Bilangan Bulat

Wajib.

Suhu warna minimum yang didukung dalam Kelvin.
temperatureMaxK Bilangan Bulat

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 lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

Negara bagian Jenis Deskripsi
color Objek

Wajib.

Setelan warna saat ini yang sedang digunakan di perangkat.
Berisi salah satu item berikut:
0 Objek

Dukungan suhu warna.
temperatureK Bilangan Bulat

Wajib.

Nilai suhu dalam Kelvin.
1 Objek

Dukungan spektrum RGB warna.
spectrumRgb Bilangan Bulat

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 cahayanya? (Putih Hangat)

{
  "color": {
    "temperatureK": 3000
  }
}

Apa warna cahayanya? (Magenta)

{
  "color": {
    "spectrumRgb": 16711935
  }
}

Apa warna lampunya? (Magenta)

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

Perintah 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

Menetapkan nilai warna absolut.

Parameter

Parameter Jenis 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 Bilangan Bulat

Wajib.

Nilai suhu dalam Kelvin. Lihat RGB, HSV, dan color temperature untuk mengetahui detailnya.
1 Objek

Dukungan spektrum RGB warna.
spectrumRGB Bilangan Bulat

Wajib.

Nilai RGB Spectrum sebagai bilangan bulat desimal. Lihat RGB, HSV, dan color temperature untuk mengetahui detailnya.
2 Objek

Dukungan spektrum HSV warna.
spectrumHSV Objek

Wajib.

Nilai HSV spektrum. Lihat RGB, HSV, dan suhu warna untuk mengetahui detailnya.
hue Number

Rona.
saturation Number

Saturasi.
value Number

Nilai.

Contoh

Buat lampu berwarna putih hangat.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Warm White",
      "temperature": 3000
    }
  }
}

Buat lampu berwarna magenta.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumRGB": 16711935
    }
  }
}

Ubah warna lampu menjadi magenta.

{
  "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 parameter status. Tindakan ini menghindari konflik dengan parameter status untuk 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

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.