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 |
2500 | Trắng cực ấm |
3000 | Trắng dịu, Trắng buổi sáng, Trắng đọc |
4000 | Trắng lạnh |
5000 | Ánh sáng ban ngày, màu trắng |
6000 | Màu trắng hoa |
7000 | Có mây nhẹ ban ngày, khói trắng |
8000 | Xanh dương u ám |
9000 | Xanh 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: 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ợ:
|
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 ColorSpectrum và ColorTemperature đã 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 på 2000 Kelvin
- tänd blått ljus i köket