Chào mừng bạn đến với Trung tâm nhà phát triển Google Home, điểm đến mới để tìm hiểu cách phát triển các hành động nhà thông minh. Lưu ý: Bạn sẽ tiếp tục xây dựng các hành động trong bảng điều khiển Actions.

Trang này được dịch bởi Cloud Translation API.

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 tí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ưu ý: Khi sử dụng Trạng thái báo cáo cho tính năng ColorSetting, hãy nhớ chỉ định trạng thái RGB là spectrumRGB và trạng thái HSV là spectrumHsv. (Bạn phải sử dụng cách viết hoa chính xác này cho tên tiểu bang.)

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

Thiết bị ERRORS

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