Схема характеристик умного дома ColorTemperature
action.devices.traits.ColorTemperature — эта черта относится к любым устройствам, которые могут устанавливать цветовую температуру.
Это относится к «теплым» лампочкам с цветовой точкой в Кельвинах. Как правило, это отдельная от
ColorSpectrum модальность, и могут быть белые точки, доступные через Temperature, которые не могут быть достигнуты Spectrum. Основываясь на доступных характеристиках, Google может выбрать подходящий режим для использования в зависимости от запроса и типа освещения (например,
«Сделать освещение в гостиной белым» может отправлять команды «Температура» на некоторые лампочки и команды «Спектр» на светодиодные ленты).
АТРИБУТЫ устройства
| Атрибут | Определение |
|---|
temperatureMinK | Необязательный. Требуется, если задано значение temperatureMaxK . Минимальная цветовая температура, поддерживаемая источником света, в Кельвинах. |
temperatureMaxK | Необязательный. Требуется, если установлена temperatureMinK . Максимальная цветовая температура, поддерживаемая источником света, в Кельвинах. |
Пример запроса SYNC и ответа
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.SYNC"
}]
}
'use strict';
const {smarthome} = require('actions-on-google');
const functions = require('firebase-functions');
const app = smarthome();
app.onSync((body, headers) => {
return {
requestId: body.requestId,
payload: {
agentUserId: '1836.15267389',
devices: [{
id: '123',
type: 'action.devices.types.LIGHT',
traits: [
'action.devices.traits.ColorTemperature'
],
name: {
defaultNames: ['AAA bulb A19 color hyperglow'],
name: 'lamp1',
nicknames: ['reading lamp']
},
willReportState: true,
attributes: {
temperatureMinK: 2000,
temperatureMaxK: 6500
},
deviceInfo: {
manufacturer: 'AAA',
model: 'hg11',
hwVersion: '1.2',
swVersion: '5.4'
},
customData: {
fooValue: 12,
barValue: false,
bazValue: 'dancing alpaca'
}
}]
}
};
});
// ...
exports.smarthome = functions.https.onRequest(app);
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"agentUserId": "1836.15267389",
"devices": [
{
"id": "123",
"type": "action.devices.types.LIGHT",
"traits": [
"action.devices.traits.ColorTemperature"
],
"name": {
"defaultNames": [
"AAA bulb A19 color hyperglow"
],
"name": "lamp1",
"nicknames": [
"reading lamp"
]
},
"willReportState": true,
"attributes": {
"temperatureMinK": 2000,
"temperatureMaxK": 6500
},
"deviceInfo": {
"manufacturer": "AAA",
"model": "hg11",
"hwVersion": "1.2",
"swVersion": "5.4"
},
"customData": {
"fooValue": 12,
"barValue": false,
"bazValue": "dancing alpaca"
}
}
]
}
}
СОСТОЯНИЯ устройства
| Состояние | Определение |
|---|
color | Объект. Текущая настройка цвета. Поскольку данный свет находится в режиме спектра ИЛИ температуры, этот объект включает в себя текущие настройки цвета в соответствующем режиме.- Строка
name . Если цветовая точка (Спектр или Температура) соответствует предустановленному имени в списке цветов партнера, верните это имя. -
temperature Целое число. Цветовая температура в Кельвинах.
|
Пример запроса и ответа на запрос QUERY
Какова моя текущая цветовая температура света?
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": 'action.devices.QUERY',
"payload": {
"devices": [{
"id": "123",
"customData": {
"fooValue": 74,
"barValue": true,
"bazValue": "foo"
}
}]
}
}]
}
'use strict';
const {smarthome} = require('actions-on-google');
const functions = require('firebase-functions');
const app = smarthome();
app.onQuery((body, headers) => {
return {
requestId: body.requestId,
payload: {
devices: {
123: {
online: true,
color: {
name: 'warm white',
temperature: 25000
},
status: 'SUCCESS'
}
}
}
};
});
// ...
exports.smarthome = functions.https.onRequest(app);
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"devices": {
"123": {
"online": true,
"color": {
"name": "warm white",
"temperature": 25000
},
"status": "SUCCESS"
}
}
}
}
КОМАНДЫ устройства
| Команда | Параметры/Определение |
|---|
action.devices.commands.ColorAbsolute | color Объект. Необходимый. Будет включать RGB или температуру и, необязательно, имя.- Строка
name . Название цвета (на английском языке), указанное в команде пользователя. Не всегда доступно (для относительных команд). -
temperature Целое число. Цветовая температура в Кельвинах.
|
Пример запроса и ответа EXECUTE
Настройте мой свет на мягкий белый.
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [{
"devices": [{
"id": "123",
"customData": {
"fooValue": 74,
"barValue": true,
"bazValue": "sheepdip"
}
}],
"execution": [{
"command": "action.devices.commands.ColorAbsolute",
"params": {
"color": {
"name": "soft white",
"temperature": 2700
}
}
}]
}]
}
}]
}
'use strict';
const {smarthome} = require('actions-on-google');
const functions = require('firebase-functions');
const app = smarthome();
app.onExecute((body, headers) => {
return {
requestId: body.requestId,
payload: {
commands: [{
ids: ['123'],
status: 'SUCCESS',
states: {
color: {
name: 'soft white',
temperature: 2700
}
}
}]
}
};
});
// ...
exports.smarthome = functions.https.onRequest(app);
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"color": {
"name": "soft white",
"temperature": 2700
}
}
}
]
}
}
