Anleitung für Smart-Home-Sensoren
action.devices.types.SENSOR: Ein Sensor kann mehrere Funktionen erfüllen, z. B. die Messung von Temperatur und Luftfeuchtigkeit. Die Sensoren können sowohl quantitative Daten (z. B. Kohlenmonoxid- und Rauchkonzentrationen in Teilen pro Million) als auch qualitative Messungen (z. B. ob die Luftqualität gesund oder ungesund ist) ausgeben.
Dieser Typ gibt an, dass das Gerät das Sensorsymbol und zugehörige Synonyme und Aliasse.
Gerätefunktionen
Weitere Informationen finden Sie in der entsprechenden Dokumentation Implementierungsdetails wie Attribute und Angaben, die Ihr Dienst unterstützen soll, und wie Sie EXECUTE- und QUERY-Antworten erstellen.
Empfohlene Eigenschaften
Diese Traits werden empfohlen, sofern sie für Ihr Gerät relevant sind. Du kannst jedoch alle verfügbaren Merkmale beliebig kombinieren, um deine vorhandenen Merkmale bestmöglich anzupassen. Produktfunktionen.
Sensoren können auch andere Merkmale nutzen, die Daten erfassen, die sie melden können, z. B.:
Qualitätsanforderungen
- Latenz:muss kleiner oder gleich 1.000 ms sein.
- Zuverlässigkeit:Muss größer oder gleich 97% sein.
Beispielgerät: Einfacher Sensor
Dieser Abschnitt enthält Beispiele für Intent-Nutzlasten, die einen gemeinsamen „Sensor“ darstellen basierend auf dem Gerätetyp und den oben genannten Merkmalen. Wenn Sie in Ihrer Implementierung Tragen hinzufügen oder entfernen, und passen Sie Ihre Antworten entsprechend an.
Beispiel für SYNC-Antwort
<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"
}
}
]
}
}
Beispiel für eine QUERY-Antwort
<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"
}
}
}
}