Schéma des caractéristiques de la couleur des maisons connectées
action.devices.traits.ColorSetting
: cette caractéristique s'applique aux appareils tels que les systèmes d'éclairage connectés, qui peuvent modifier la couleur ou la température des couleurs.
RVB, HSV et température de couleur
RVB représente les couleurs sous forme de triplet (rouge, vert, bleu). RVB est le modèle de couleurs par défaut. Tout triplet RVB peut être représenté sous forme d'un code hexadécimal, équivalent aux valeurs hexadécimales du triplet concaténé. Par exemple, "bleu" correspond à (0, 0, 255) et à #0000FF. Vous pouvez utiliser n'importe quelle valeur dans l'espace colorimétrique RVB, c'est-à-dire RV(x, y, z), où x, y et z sont compris dans la plage [0, 255], inclus.
HSV représente les couleurs sous forme de triplet (teinte, saturation, valeur). Toute valeur de couleur dans le composant HSV peut être convertie en RVB, et inversement. La plage de Hue est comprise entre [0, 360] degrés (hors 360°, car elle s'étend jusqu'à 0 degré). Saturation et valeur sont représentées par des nombres à virgule flottante compris dans la plage [0.0, 1.0].
La température des couleurs représente certaines couleurs sous forme de valeurs décimales non négatives en kelvin. Cet attribut décrit des lumières "blanches" ou "chaudes", avec des noms de couleurs tels que "blanc froid" ou "lumière couverte". Les lumières intelligentes compatibles avec la température des couleurs ont généralement une plage de [2 000, 9 000] kelvins, ce qui correspond aux lumières conventionnelles avec Kelvin fixe. La température des couleurs est une échelle linéaire et un sous-ensemble des modèles de couleurs à double spectre RVB/HSV. Consultez le tableau ci-dessous pour obtenir des exemples de températures et les noms de couleurs correspondants.
Température (Kelvin) | Nom de la couleur |
---|---|
2 000 | Bougie |
2 500 | Blanc très chaud |
3 000 | Blanc doux, blanc matin, blanc |
4 000 | Blanc froid |
5 000 | Lumière du jour, Blanc |
6 000 | Blanc floral |
7000 | Nuageux, journée, fumée blanche |
8000 | Ciel couvert bleu |
9000 | Bleu ciel |
Appareil : ATTRIBUTES
Les appareils associés à cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC
. Pour en savoir plus sur la gestion des intents SYNC
, consultez la page Traitement des intents.
Attributs | Type | Description |
---|---|---|
commandOnlyColorSetting |
Booléen |
(Par défaut : Indique si l'appareil est compatible avec la communication unidirectionnelle (vraie) ou bidirectionnelle (fausse). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou Signaler un état pour cette caractéristique. |
Contient l'un des éléments suivants: | ||
0
|
Objet |
Compatibilité avec les modèles de couleur |
colorModel |
Chaîne |
Obligatoire. Modèle à spectre complet compatible avec l'appareil. Valeurs acceptées :
|
1
|
Objet |
Température des couleurs. |
colorTemperatureRange |
Objet |
Obligatoire. Plage de température des couleurs compatible en kelvin. |
temperatureMinK |
Entier |
Obligatoire. Température minimale des couleurs acceptée (en kelvin) |
temperatureMaxK |
Entier |
Obligatoire. Température maximale des couleurs acceptée (en kelvin). |
Exemples
Appareil compatible avec le modèle de couleurs à spectre RVB et la température des couleurs.
{ "colorModel": "rgb", "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Appareil compatible uniquement avec le modèle de couleurs à spectre HSV.
{ "colorModel": "hsv" }
Appareil uniquement compatible avec la température des couleurs.
{ "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Appareil n'acceptant que les commandes de modèle de couleur HSV.
{ "colorModel": "hsv", "commandOnlyColorSetting": true }
Appareil : STATES
Les appareils associés à cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY
. Pour en savoir plus sur la gestion des intents QUERY
, consultez la page Traitement des intents.
États | Type | Description |
---|---|---|
color |
Objet |
Obligatoire. Paramètre de couleur actuellement utilisé sur l'appareil. |
Contient l'un des éléments suivants: | ||
0
|
Objet |
Température des couleurs. |
temperatureK |
Entier |
Obligatoire. Valeur de température en kelvin. |
1
|
Objet |
Compatibilité avec le spectre RVB. |
spectrumRgb |
Entier |
Obligatoire. Valeur du spectre RVB sous forme d'entier décimal. |
2
|
Objet |
Compatibilité avec le spectre de couleurs HSV. |
spectrumHsv |
Objet |
Obligatoire. Valeur HSV du spectre. |
hue |
Number |
Teinte. |
saturation |
Number |
Saturation. |
value |
Number |
Valeur. |
Exemples
Quelle est la couleur de la lumière ? (Blanc chaud)
{ "color": { "temperatureK": 3000 } }
Quelle est la couleur de la lumière ? (Magenta).
{ "color": { "spectrumRgb": 16711935 } }
Quelle est la couleur de la lumière ? (Magenta).
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
Appareil COMMANDS
Les appareils dotés de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE
. Pour en savoir plus sur la gestion des intents EXECUTE
, consultez la page Traitement des intents.
action.devices.commands.ColorAbsolute
Définissez la valeur de couleur absolue.
Paramètres
Paramètres | Type | Description |
---|---|---|
color |
Objet |
Obligatoire. Couleur à définir. |
name |
Chaîne |
Nom de couleur analysé à partir de la commande de l'utilisateur. Il est possible qu'il ne soit pas toujours disponible (c'est-à-dire lorsque vous utilisez des commandes relatives). |
Contient l'un des éléments suivants : | ||
0
|
Objet |
Température des couleurs. |
temperature |
Entier |
Obligatoire. Valeur de température en kelvin. |
1
|
Objet |
Compatibilité avec le spectre RVB. |
spectrumRGB |
Entier |
Obligatoire. Valeur du spectre RVB sous forme d'entier décimal. |
2
|
Objet |
Compatibilité avec le spectre de couleurs HSV. |
spectrumHSV |
Objet |
Obligatoire. Valeur HSV du spectre. |
hue |
Number |
Teinte. |
saturation |
Number |
Saturation. |
value |
Number |
Valeur. |
Exemples
Mets une lumière blanche.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "warm white", "temperature": 3000 } } }
Créez un magenta clair.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "magenta", "spectrumRGB": 16711935 } } }
Créez un magenta clair.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "magenta", "spectrumHSV": { "hue": 300, "saturation": 1, "value": 1 } } } }
Notez que les noms des paramètres diffèrent légèrement entre les paramètres de commande et d'état. Cela permet d'éviter les conflits avec les paramètres d'état pour les caractéristiques obsolètes ColorSpectrum et ColorTempérature.
Commande | State |
---|---|
temperature |
temperatureK |
spectrumRGB |
spectrumRgb |
spectrumHSV |
spectrumHsv |
Exemples d'énoncés
de-DE
-
Stell die Farbe
der Lampe aufblau -
Stelle die Farbtemperatur auf
3000 Kelvin ein.
en-US
-
can you adjust
my lights color to4000 kelvins -
set
the lights toblue
es-ES
-
pon
azul la luz de la cocina -
pon
la luz a2000 k de temperatura de color
fr-FR
-
Allume
la lampe de la chambre à3500 kelvins . -
mets
les lampes enrose dansla chambre
hi-IN
-
तुम
लाइट कोब्लू कर दो -
लैम्प 2000 केल्विन पर लगाओ।
it-IT
-
Imposta
la lampada a2000 K . -
metti
la luce gialla
ja-JP
-
照明 の色を青 にして -
照明 の色温度を5000K にセットして
ko-KR
-
조명 색깔흰색 으로 바꿔 줘 -
주방 전등 색 온도를5000 켈빈 으로 설정해
nl-NL
-
Zet
de keukenlamp op2000 Kelvin . -
maak
het licht rood
pt-BR
-
Colocar
a lâmpada em2000 K . -
Define
a lâmpada para2000 K . -
colocar
a luz da sala emazul -
põe
a luz da sala avermelho
sv-SE
-
Ställ in
lampan på2000 Kelvin -
tänd
blått ljus i köket