Sơ đồ đặ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ị, chẳng hạn như đèn thông minh, có thể thay đổi màu sắc hoặc nhiệt độ màu.

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

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

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

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

Nhiệt độ (Kelvin) Tên màu
2000Ánh nến
2500Trắng cực ấm
3000Trắng nhạt, Trắng buổi sáng, Trắng đọc
4000Trắng mát
5000Ánh sáng ban ngày, Trắng
6000Trắng hoa
7000Ánh sáng ban ngày nhiều mây, khói trắng
8000Xanh dương nhiều mây
9000Blue Sky

Thuộc tính 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 quá trình thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem bài viết Thực hiện ý định.

Thuộc tính Loại Mô tả
commandOnlyColorSetting Boolean

(Mặc định: false)

Cho biết liệu thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false) hay không. Đặt thuộc tính này thành true nếu thiết bị không thể phản hồi ý định QUERY hoặc Báo cáo trạng thái cho đặc điểm này.
Chứa bất kỳ mục nào sau đây:
0 Đối tượng

Hỗ trợ mô hình màu.
colorModel String

Bắt buộc.

Mô hình màu đầy đủ mà thiết bị hỗ trợ.

Các giá trị được hỗ trợ:

rgb
hsv
1 Đối tượng

Hỗ trợ nhiệt độ màu.
colorTemperatureRange Đối tượng

Bắt buộc.

Phạm vi nhiệt độ màu được hỗ trợ tính theo độ K.
temperatureMinK Số nguyên

Bắt buộc.

Nhiệt độ màu tối thiểu được hỗ trợ, tính bằng độ K.
temperatureMaxK Số nguyên

Bắt buộc.

Nhiệt độ màu tối đa được hỗ trợ tính theo độ K.

Ví dụ

Thiết bị hỗ trợ cả mô hình phổ màu 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 về 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 quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem bài viết Thực hiện ý định.

Tiểu bang Loại Mô tả
color Đối tượng

Bắt buộc.

Chế độ cài đặt màu hiện tại đang được dùng trên thiết bị.
Chứa một trong các mục sau:
0 Đối tượng

Hỗ trợ nhiệt độ màu.
temperatureK Số nguyên

Bắt buộc.

Giá trị nhiệt độ tính theo độ K.
1 Đối tượng

Hỗ trợ phổ màu RGB.
spectrumRgb Số nguyên

Bắt buộc.

Giá trị RGB của quang phổ dưới dạng số nguyên thập phân.
2 Đối tượng

Hỗ trợ dải màu HSV.
spectrumHsv Đối tượng

Bắt buộc.

Giá trị HSV của quang phổ.
hue Number

Sắc độ.
saturation Number

Độ rực màu.
value Number

Giá trị.

Ví dụ

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

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

Đèn này có màu gì? (Đỏ tía)

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

Đèn này có màu gì? (Đỏ tía)

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

LỆNH 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ố

Thông số Loại Mô tả
color Đối tượng

Bắt buộc.

Màu cần đặt.
name String

Tên màu được phân tích cú pháp từ lệnh của người dùng; có thể không phải lúc nào cũng có sẵn (tức là khi sử dụng lệnh tương đối).
Chứa một trong các mục sau:
0 Đối tượng

Hỗ trợ nhiệt độ màu.
temperature Số nguyên

Bắt buộc.

Giá trị nhiệt độ tính bằng độ K. Hãy xem phần RGB, HSV và nhiệt độ màu để biết thông tin chi tiết.
1 Đối tượng

Hỗ trợ phổ màu RGB.
spectrumRGB Số nguyên

Bắt buộc.

Giá trị RGB của quang phổ dưới dạng số nguyên thập phân. Hãy xem phần RGB, HSV và nhiệt độ màu để biết thông tin chi tiết.
2 Đối tượng

Hỗ trợ dải màu HSV.
spectrumHSV Đối tượng

Bắt buộc.

Giá trị HSV của quang phổ. Hãy xem phần RGB, HSV và nhiệt độ màu để biết thông tin chi tiết.
hue Number

Sắc độ.
saturation Number

Độ rực màu.
value Number

Giá trị.

Ví dụ

Đổi đèn sang màu trắng ấm.

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

Đổi màu đèn thành màu hồng tươi nhạt.

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

Đổi màu đèn thành màu hồng tươi nhạt.

{
  "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ủa lệnh và trạng thái có sự khác biệt nhỏ. Điều này giúp tránh xung đột với các tham số trạng thái cho các đặc điểm ColorSpectrum và ColorTemperature không dùng nữa.

Lệnh Tiểu bang
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

Câu lệnh mẫu

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

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.