Skema Trait ColorSetting 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. Triplet RGB apa pun dapat direpresentasikan sebagai kode heksadesimal, 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 mewakili warna sebagai triplet (hue, saturasi, nilai). Nilai warna apa pun dalam HSV dapat dikonversi ke RGB, dan sebaliknya. Hue memiliki rentang [0, 360) derajat (tidak termasuk 360, karena akan di-wrap 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 hari 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 untuk mengetahui beberapa contoh suhu dan nama warna yang sesuai.

Atribut perangkat

Perangkat dengan trait ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani SYNC intent, lihat Pemenuhan intent.

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 trait ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani QUERY intent, lihat Pemenuhan intent.

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

PERINTAH perangkat

Perangkat dengan trait ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari lebih lanjut cara menangani intent EXECUTE, lihat Pemenuhan intent.

action.devices.commands.ColorAbsolute

Menetapkan nilai warna absolut.

Parameter

Contoh

Jadikan lampunya putih hangat.

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

Jadikan lampunya magenta.

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

Jadikan lampunya 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 status. Hal ini menghindari konflik dengan parameter status untuk trait ColorSpectrum dan ColorTemperature yang tidak digunakan lagi.

Contoh ucapan

ERROR perangkat