Guide du ventilateur connecté
action.devices.types.FAN : les ventilateurs sont généralement allumés et éteints, et disposent de paramètres de vitesse. Certains ventilateurs peuvent également être associés à d'autres modes, comme l'orientation ou l'orientation du ventilateur (par exemple, un support mural peut être doté de paramètres permettant de l'augmenter ou de le réduire).
Ce type indique que l'appareil obtient l'icône Ventilateur ainsi que des synonymes et alias associés.
Fonctionnalités de l'appareil
Consultez la documentation sur les caractéristiques correspondantes pour obtenir des détails sur l'implémentation, tels que les attributs et les états que votre service doit accepter, et pour découvrir comment créer des réponses EXECUTE et QUERY.
Caractéristiques obligatoires
Ces caractéristiques et commandes sont nécessaires, le cas échéant. Si votre appareil n'est pas compatible avec ces caractéristiques, saisissez le code d'erreur functionNotSupported dans une réponse QUERY ou EXECUTE. Pour en savoir plus, consultez Erreurs et exceptions.
Exigences de qualité
- Latence:doit être inférieure ou égale à 700 ms.
- Fiabilité:doit être supérieure ou égale à 97%.
Exemple d'appareil: ventilateur simple
Cette section contient des exemples de charges utiles d'intent représentant un "ventilateur" classique en fonction du type d'appareil et des caractéristiques ci-dessus. Si vous ajoutez ou supprimez des caractéristiques dans votre mise en œuvre, modifiez vos réponses en conséquence.
Exemple de réponse SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.FAN",
"traits": [
"action.devices.traits.FanSpeed",
"action.devices.traits.OnOff"
],
"name": {
"name": "Simple fan"
},
"willReportState": true,
"attributes": {
"availableFanSpeeds": {
"speeds": [
{
"speed_name": "low_key",
"speed_values": [
{
"speed_synonym": [
"Low",
"Slow"
],
"lang": "en"
},
{
"speed_synonym": [
"Niedrig",
"Schleppend"
],
"lang": "de"
}
]
},
{
"speed_name": "high_key",
"speed_values": [
{
"speed_synonym": [
"High"
],
"lang": "en"
},
{
"speed_synonym": [
"Hoch"
],
"lang": "de"
}
]
}
],
"ordered": true
},
"reversible": true
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Exemple de réponse QUERY
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"on": true,
"currentFanSpeedSetting": "low_key"
}
}
}
}
Exemples de commandes EXECUTE
Vitesse du ventilateur
Pour en savoir plus sur les paramètres de commande, consultez la documentation de référence sur
action.devices.traits.FanSpeed.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetFanSpeed",
"params": {
"fanSpeed": "high_key"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentFanSpeedSetting": "high_key"
}
}
]
}
}
Activé
Pour en savoir plus sur les paramètres de commande, consultez la documentation de référence sur
action.devices.traits.OnOff.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}