Lược đồ đặc điểm ColorSetting của Nhà thông minh

action.devices.traits.ColorSetting – Đặc điểm này áp dụng cho các thiết bị có thể thay đổi màu sắc hoặc nhiệt độ màu, chẳng hạn như đèn thông minh.

RGB, HSV và nhiệt độ màu

RGB biểu thị màu sắc dưới dạng bộ ba (đỏ, xanh lục, xanh dương). RGB là mô hình màu mặc định. Bạn có thể biểu thị bất kỳ bộ ba RGB nào dưới dạng mã hex, tương đương với các giá trị thập lục phân được nối cho bộ ba. Ví dụ: "xanh dương" là (0, 0, 255) và #0000FF. Bạn có thể sử dụng bất kỳ giá trị nào trong không gian màu RGB; tức là RGB(x, y, z) trong đó x, y, z nằm trong phạm vi [0, 255] (bao gồm cả 2 giá trị đó).

HSV biểu thị màu sắc dưới dạng bộ ba (tông màu, độ bão hoà màu, giá trị màu). Bạn có thể chuyển đổi mọi giá trị màu trong HSV sang RGB và ngược lại. Sắc độ có dải giá trị là [0, 360) độ (không bao gồm 360, vì giá trị này sẽ chuyển về 0 độ). Độ rực màu và giá trị được biểu thị bằng số thực trong phạm vi [0.0, 1.0].

Nhiệt độ màu thể hiện một số màu dưới dạng giá trị thập phân không âm theo Kelvin. Thuộc tính này mô tả đèn "trắng" hoặc "ấm", với các tên màu như "trắng lạnh" hoặc "ánh sáng ban ngày u ám". Đèn thông minh hỗ trợ nhiệt độ màu thường có dải nhiệt độ từ [2000, 9000] Kelvin, tương ứng với đèn thông thường có Kelvin cố định. Nhiệt độ màu là một thang đo tuyến tính và là một phần của mô hình màu RGB/HSV toàn phổ. Hãy xem bảng bên dưới để biết một số ví dụ về nhiệt độ và tên màu tương ứng.

THUỘC TÍNH của thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Ví dụ

Thiết bị hỗ trợ cả mô hình màu phổ RGB và nhiệt độ màu.

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Thiết bị chỉ hỗ trợ mô hình màu phổ HSV.

{
  "colorModel": "hsv"
}

Thiết bị chỉ hỗ trợ nhiệt độ màu.

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Thiết bị chỉ hỗ trợ các lệnh mô hình màu HSV.

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

TRẠNG THÁI THIẾT BỊ

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Ví dụ

Đèn có màu gì? (Trắng ấm)

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

Ánh sáng có màu gì? (Đỏ tía)

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

Đèn có màu gì? (Đỏ tươi)

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

LỆNH trên thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.ColorAbsolute

Đặt giá trị màu tuyệt đối.

Thông số

Ví dụ

Chuyển đèn sang màu trắng ấm.

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

Đổi màu đèn sang hồng tím.

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

Đổi màu đèn sang hồng tím.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumHSV": {
        "hue": 300,
        "saturation": 1,
        "value": 1
      }
    }
  }
}

Xin lưu ý rằng tên tham số có khác biệt đôi chút giữa tham số lệnh và tham số trạng thái. Điều này giúp tránh xung đột với các tham số trạng thái cho đặc điểm ColorSpectrum và ColorTemperature không dùng nữa.

Câu nói mẫu

LỖI thiết bị