Guide des capteurs pour la maison connectée
action.devices.types.SENSOR : un même capteur peut remplir plusieurs fonctions, telles que la surveillance de la température et de l'humidité. Les capteurs peuvent fournir soit des données quantitatives, soit des mesures quantitatives (par exemple, des niveaux de monoxyde de carbone et de fumée mesurés en parties par million) et des mesures qualitatives (par exemple, si la qualité de l'air est saine ou malsaine).
Ce type indique que l'appareil reçoit l'icône de capteur et d'autres des synonymes et des alias.
Fonctionnalités de l'appareil
Reportez-vous à la documentation des caractéristiques correspondantes pour les détails de mise en œuvre, tels que les attributs et les états que votre service doit prendre en charge, et comment créer des réponses EXECUTE et QUERY.
Caractéristiques recommandées
Ces caractéristiques sont recommandées, si elles s'appliquent à votre appareil. Cependant, vous êtes libre de combiner toutes les caractéristiques disponibles pour les faire correspondre au mieux la fonctionnalité du produit.
Les capteurs peuvent également utiliser d'autres caractéristiques pour couvrir les données qu'ils peuvent signaler, par exemple:
Exigences de qualité
- Latence:la latence doit être inférieure ou égale à 1 000 ms.
- La fiabilité doit être supérieure ou égale à 97%.
Exemple d'appareil: capteur simple
Cette section contient des exemples de charges utiles d'intent représentant un "capteur" commun en fonction du type d'appareil et des caractéristiques ci-dessus. Si vous ajoutez ou supprimez des caractéristiques dans votre implémentation, modifiez vos réponses en conséquence pour refléter ces changements.
Exemple de réponse SYNC
<ph type="x-smartling-placeholder">{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.SENSOR",
"traits": [
"action.devices.traits.EnergyStorage",
"action.devices.traits.OccupancySensing",
"action.devices.traits.SensorState"
],
"name": {
"name": "Simple sensor"
},
"willReportState": true,
"attributes": {
"sensorStatesSupported": [
{
"name": "AirQuality",
"descriptiveCapabilities": {
"availableStates": [
"healthy",
"moderate",
"unhealthy",
"very unhealthy"
]
}
}
],
"queryOnlyEnergyStorage": true,
"occupancySensorConfiguration": [
{
"occupancySensorType": "PIR",
"occupiedToUnoccupiedDelaySec": 10,
"unoccupiedToOccupiedDelaySec": 10,
"unoccupiedToOccupiedEventThreshold": 2
}
]
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Exemple de réponse QUERY
<ph type="x-smartling-placeholder">{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"currentSensorStateData": [
{
"name": "AirQuality",
"currentSensorState": "healthy"
}
],
"descriptiveCapacityRemaining": "HIGH",
"capacityRemaining": [
{
"unit": "PERCENTAGE",
"rawValue": 90
}
],
"occupancy": "OCCUPIED"
}
}
}
}