Smart-Home-Netzwerk – Leitfaden
action.devices.types.NETWORK: Eine Gruppe von Routerknoten oder Mesh-Netzwerken, die als eine Entität gesteuert werden und nicht als einzelne Geräte. Das Netzwerkgerät kann neu gestartet werden, seine Software aktualisieren und Modi zur Steuerung der Dienstqualität sowie Jugendschutzeinstellungen haben.
Das Gerät kann beispielsweise das Gastnetzwerk aktivieren und netzwerkspezifische Informationen wie die aktuellen Internetdurchsatzraten melden.
Dieser Typ zeigt an, dass das Gerät das Netzwerksymbol und einige zugehörige Synonyme und Aliasse erhält.
Gerätefunktionen
In der zugehörigen Dokumentation zur Eigenschaft finden Sie Implementierungsdetails wie Attribute und Status, die Ihr Dienst unterstützen sollte, und zum Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Eigenschaften
Diese Eigenschaften und Befehle sind erforderlich, falls sie auf Ihr Gerät zutreffen. Wenn Ihr Gerät diese Eigenschaften nicht unterstützt, geben Sie den Fehlercode functionNotSupported in einer QUERY- oder EXECUTE-Antwort ein. Weitere Informationen finden Sie unter Fehler und Ausnahmen.
Empfohlene Eigenschaften
Diese Eigenschaften werden empfohlen, sofern sie für Ihr Gerät relevant sind. Sie können jedoch alle verfügbaren Merkmale beliebig kombinieren, um Ihre bestehenden Produktfunktionen bestmöglich anzupassen.
Qualitätsanforderungen
- Latenz:muss kleiner oder gleich 300 ms sein.
- Zuverlässigkeit:muss größer oder gleich 97% sein
Beispielgerät: Einfaches Netzwerk
Dieser Abschnitt enthält Beispielnutzlasten, die je nach Gerätetyp und Eigenschaften ein gemeinsames „Netzwerk“ darstellen. Wenn du bei der Implementierung Eigenschaften hinzufügst oder entfernst, ändere deine Antworten entsprechend.
SYNC-Beispielantwort
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.NETWORK",
"traits": [
"action.devices.traits.Reboot",
"action.devices.traits.NetworkControl"
],
"name": {
"name": "Simple network"
},
"willReportState": true,
"attributes": {
"supportsEnablingNetworkProfile": true,
"supportsDisablingNetworkProfile": true,
"supportsNetworkDownloadSpeedTest": true,
"supportsNetworkUploadSpeedTest": true,
"networkProfiles": [
"kids"
]
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Beispiel für eine QUERY-Antwort
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"networkEnabled": true,
"networkSettings": {
"ssid": "home-network-123"
}
}
}
}
}
Beispiele für EXECUTE-Befehle
Neu starten
Weitere Informationen zu den Befehlsparametern finden Sie in der
Referenz zu action.devices.traits.Reboot.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.Reboot"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true
}
}
]
}
}
Netzwerkprofil deaktivieren
Weitere Informationen zu den Befehlsparametern finden Sie in der
Referenz zu action.devices.traits.NetworkControl.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.EnableDisableNetworkProfile",
"params": {
"profile": "kids",
"enable": false
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"networkEnabled": true,
"networkSettings": {
"ssid": "home-network-123"
}
}
}
]
}
}
Netzwerkgeschwindigkeit testen
Weitere Informationen zu den Befehlsparametern finden Sie in der
Referenz zu action.devices.traits.NetworkControl.
{
"requestId": "6894439706274654520",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TestNetworkSpeed",
"params": {
"testDownloadSpeed": true,
"testUploadSpeed": true,
"followUpToken": "123"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654520",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true
}
}
]
}
}