Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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
2.000Lampu Lilin
2500Putih Ultra Hangat
3.000Putih Lembut, Putih Pagi, Putih Baca
4.000Putih Sejuk
5.000Siang Hari, Putih
6.000Putih Bunga
7.000Siang Hari Berawan, Asap Putih
8.000Biru Mendung
9.000Biru 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

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

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

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 3.000 Kelvin ein.

en-US

  • kamu bisa mengatur lampuku warna ke 4000 kelvin
  • setel lampu ke biru

es-ES

  • pon azul la luz de la cocina
  • pon la luz a 2.000 k de temperatura de color

fr-FR

  • Allume la lampe de la chambre à 3.500 kelvin .
  • bertemu les lampu en mawar dans la chambre

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.