Giản đồ đặc điểm cài đặt màu cho 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ị các 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ã hex, tương đương với các giá trị thập lục phân của bộ ba nối với nhau. 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 hệ màu RGB; nghĩa là RGB(x, y, z), trong đó x, y, z nằm trong phạm vi [0, 255].

HSV biểu thị màu sắc dưới dạng bộ ba (màu sắc, độ 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. Hue có phạm vi [0, 360) độ (bao gồm cả 360 độ vì phạm vi xoay quanh 0 độ). Độ bão hoà 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ạng giá trị thập phân không âm theo độ K. Thuộc tính này mô tả đèn "màu trắng" hoặc "ấm áp", với tên màu như "trắng mát" hoặc "ánh sáng ban ngày u ám". Đèn thông minh hỗ trợ nhiệt độ màu thường có phạm vi [2000, 9000] Kelvin, tương ứng với các đè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 tập hợp con của các mô hình màu phổ màu đầy đủ RGB/HSV. Hãy xem bảng dưới đây để biết một số ví dụ về nhiệt độ và tên màu tương ứng.

Nhiệt độ (Kelvin) Tên màu
2000Đèn nến
2500Trắng cực ấm
3000Trắng dịu, Trắng buổi sáng, Trắng đọc
4000Trắng lạnh
5000Ánh sáng ban ngày, màu trắng
6000Màu trắng hoa
7000Có mây nhẹ ban ngày, khói trắng
8000Xanh dương u ám
9000Xanh da trời

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 quá trình SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, vui lòng xem phần Thực hiện ý định.

Thuộc tính Loại Nội dung mô tả
commandOnlyColorSetting Boolean

(Mặc định: false)

Cho biết thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false). Đặ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 Trạng thái báo cáo cho trait 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 Chuỗi

Bắt buộc.

Mô hình màu phổ đầ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 bằng độ 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 bằng độ K.

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ợ lệnh về mô hình màu HSV.

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

TRẠNG THÁI của 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 trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, vui lòng xem phần Thực hiện ý định.

Tiểu bang Loại Nội dung 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ị phổ RGB dưới dạng số nguyên thập phân.

2 Đối tượng

Hỗ trợ phổ HSV màu.

spectrumHsv Đối tượng

Bắt buộc.

Giá trị HSV phổ.

hue Number

Màu 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 trên thiết bị

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

action.devices.commands.ColorAbsolute

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

Các tham số

Các tham số Loại Nội dung mô tả
color Đối tượng

Bắt buộc.

Màu cần đặt.

name Chuỗi

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 các 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 theo độ K. 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ị phổ RGB dưới dạng số nguyên thập phân. Xem phần RGB, HSV và nhiệt độ màu để biết thông tin chi tiết.

2 Đối tượng

Hỗ trợ phổ HSV màu.

spectrumHSV Đối tượng

Bắt buộc.

Giá trị HSV phổ. Xem phần RGB, HSV và nhiệt độ màu để biết thông tin chi tiết.

hue Number

Màu sắc.

saturation Number

Độ rực màu.

value Number

Giá trị.

Ví dụ

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

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

Chuyển sang màu đỏ tươi nhạt.

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

Chuyển sang màu đỏ 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ố hơi khác nhau 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ác trait ColorSpectrumColorTemperature đã ngừng hoạt động.

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

Cách phát âm 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 2000 Kelvin
  • tänd blått ljus i köket

Thiết bị ERRORS

Xem danh sách đầy đủ lỗi và trường hợp ngoại lệ.