Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Schemat schematu inteligentnego zarządzania siecią domowym

action.devices.traits.NetworkControl – ten atrybut należy do urządzeń, które obsługują raportowanie danych sieciowych i wykonują operacje związane z siecią.

ATRYBUTY na urządzeniu

Urządzenia z tą cechą mogą zgłaszać w ramach operacji SYNC te atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
supportsEnablingGuestNetwork Wartość logiczna

(Domyślnie: false)

Ustaw wartość „true”, jeśli można włączyć sieć dla gości.

supportsDisablingGuestNetwork Wartość logiczna

(Domyślnie: false)

Ustaw wartość „true”, jeśli sieć gościa może być wyłączona.

supportsGettingGuestNetworkPassword Wartość logiczna

(Domyślnie: false)

Ustaw wartość „true”, jeśli hasło do sieci dla gości można uzyskać za pomocą polecenia GetGuestNetworkPassword.

networkProfiles Tablica

Określa obsługiwane nazwy profili sieci.

[item, ...] Ciąg

Nazwa profilu sieciowego reprezentującego grupę powiązanych urządzeń.

supportsEnablingNetworkProfile Wartość logiczna

(Domyślnie: "false")

Ustaw „true”, jeśli można włączyć profile sieciowe.

supportsDisablingNetworkProfile Wartość logiczna

(Domyślnie: "false")

Ustaw wartość „true”, jeśli można wyłączyć profile sieciowe.

supportsNetworkDownloadSpeedTest Wartość logiczna

(Domyślnie: false)

Ustaw wartość „true”, jeśli można uruchomić test szybkości pobierania.

supportsNetworkUploadSpeedTest Wartość logiczna

(Domyślnie: false)

Ustaw wartość „true”, jeśli można przeprowadzić test szybkości przesyłania.

Przykłady

Urządzenie sieciowe, które obsługuje sieć gościnną, profile i test szybkości.

{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true,
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true,
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true,
  "supportsGettingGuestNetworkPassword": true,
  "networkProfiles": [
    "kids"
  ]
}

STANY urządzenia

Urządzenia z tą cechą mogą w ramach operacji QUERY zgłaszać następujące stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
networkEnabled Wartość logiczna

Określa, czy sieć główna jest włączona.

networkSettings Obiekt

Zawiera identyfikator SSID sieci głównej.

ssid Ciąg

Wymagane.

Identyfikator SSID sieci.

guestNetworkEnabled Wartość logiczna

Określa, czy sieć gościa jest włączona.

guestNetworkSettings Obiekt

Zawiera identyfikator SSID sieci gościa.

ssid Ciąg

Wymagane.

Identyfikator SSID sieci.

numConnectedDevices Liczba całkowita

Liczba urządzeń połączonych z siecią.

networkUsageMB Number

Wykorzystanie sieci w MB (megabajtach). Wykorzystanie sieci dotyczy bieżącego okresu rozliczeniowego, co może być przydatne w kontekście monitorowania wykorzystania.

networkUsageLimitMB Number

Limit użycia sieci w MB (megabajtach). Limit wykorzystania sieci mieści się w bieżącym okresie rozliczeniowym.

networkUsageUnlimited Wartość logiczna

Określa, czy użycie sieci jest nieograniczone. Jeśli zasada ma wartość Prawda, stan sieci NetworkUsageLimitMB jest ignorowany.

lastNetworkDownloadSpeedTest Obiekt

Zawiera wyniki ostatniego testu szybkości pobierania przez sieć.

downloadSpeedMbps Number

Szybkość pobierania w ostatnim teście szybkości sieci (Mb/s (megabity na sekundę)).

unixTimestampSec Liczba całkowita

Sygnatura czasowa Unix (liczba sekund od czasu uniksowego) okresu ostatniego testu szybkości pobierania w sieci.

status Ciąg

Wskazuje, czy ostatni test szybkości pobierania sieci zakończył się powodzeniem czy nie.

Obsługiwane wartości:

SUCCESS
FAILURE
lastNetworkUploadSpeedTest Obiekt

Zawiera wyniki ostatniego testu szybkości przesyłania w sieci.

uploadSpeedMbps Number

Szybkość przesyłania ostatniego testu szybkości sieci (w Mb/s).

unixTimestampSec Liczba całkowita

Sygnatura czasowa Unix (liczba sekund od czasu uniksowego) czasu ostatniego testu szybkości przesyłania w sieci.

status Ciąg

Wskazuje, czy ostatni test szybkości przesyłania sieci zakończył się powodzeniem lub niepowodzeniem.

Obsługiwane wartości:

SUCCESS
FAILURE
networkSpeedTestInProgress Wartość logiczna

(Domyślnie: false)

Czy trwa test szybkości.

networkProfilesState Obiekt

Stan profili sieciowych. Obiekt najwyższego poziomu powinien zawierać pary klucz-wartość, w których klucz jest nazwą jednego z profili sieciowych wymienionych w atrybucie networkProfiles, a wartością powinien być stan tego profilu.

<string> Obiekt

Obiekt zawierający stan pojedynczego profilu sieci. Wartość klucza powinna być nazwą jednego z profili sieciowych w atrybucie networkProfiles.

enabled Wartość logiczna

Bieżący stan włączenia/wyłączenia profilu sieci.

Przykłady

Urządzenie z aktywną siecią.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8
}

Urządzenie z aktywną siecią i wynikami testu szybkości.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "lastNetworkDownloadSpeedTest": {
    "downloadSpeedMbps": 159.8,
    "unixTimestampSec": 1563215576,
    "status": "SUCCESS"
  },
  "lastNetworkUploadSpeedTest": {
    "uploadSpeedMbps": 64.1,
    "unixTimestampSec": 1563215576,
    "status": "SUCCESS"
  }
}

Urządzenie z aktywną siecią i testem szybkości.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "networkSpeedTestInProgress": true
}

Urządzenie z wyłączonym profilem profilowym sieci dla dzieci.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "networkProfilesState": {
    "parents": {
      "enabled": true
    },
    "kids": {
      "enabled": false
    }
  }
}

Polecenia dotyczące urządzenia

Urządzenia z tą cechą mogą w ramach operacji EXECUTE reagować na następujące polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.EnableDisableGuestNetwork

Włącz lub wyłącz sieć dla gości.

To polecenie wymaga tych atrybutów:
{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true
}

Parametry

Parametry Typ Opis
enable Wartość logiczna

Wymagane.

Wartość Prawda, aby włączyć sieć dla gości, lub Fałsz, aby wyłączyć sieć dla gości.

Przykłady

Włącz sieć dla gości.

{
  "command": "action.devices.commands.EnableDisableGuestNetwork",
  "params": {
    "enable": true
  }
}

action.devices.commands.EnableDisableNetworkProfile

Włącz lub wyłącz profil sieci.

To polecenie wymaga tych atrybutów:
{
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true
}

Parametry

Parametry Typ Opis
profile Ciąg

Wymagane.

Nazwa profilu z atrybutu networkProfiles.

enable Wartość logiczna

Wymagane.

Wartość prawda oznacza, że profil jest włączony, lub fałsz, aby wyłączyć profil.

Przykłady

Wyłącz internet dla dzieci.

{
  "command": "action.devices.commands.EnableDisableNetworkProfile",
  "params": {
    "profile": "kids",
    "enable": false
  }
}

Podczas próby kontrolowania danego profilu sieci wystąpił błąd.

Obsługiwane wartości:

networkProfileNotRecognized

action.devices.commands.GetGuestNetworkPassword

Uzyskaj hasło do sieci dla gości.

To polecenie wymaga tych atrybutów:
{
  "supportsGettingGuestNetworkPassword": true
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Pokaż hasło do Wi-Fi dla gości

{
  "command": "action.devices.commands.GetGuestNetworkPassword",
  "params": {}
}

Wyniki

Wyniki Typ Opis
guestNetworkPassword Ciąg

Wymagane.

Hasło do sieci dla gości.

Przykłady

Pokaż hasło do Wi-Fi dla gości

{
  "guestNetworkPassword": "123456"
}

action.devices.commands.TestNetworkSpeed

Sprawdź szybkość pobierania i przesyłania sieci.

To polecenie wymaga tych atrybutów:
{
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true
}

Parametry

Parametry Typ Opis
testDownloadSpeed Wartość logiczna

Wymagane.

Wskazuje, czy szybkość pobierania powinna zostać przetestowana.

testUploadSpeed Wartość logiczna

Wymagane.

Określa, czy szybkość przesyłania ma zostać przetestowana.

followUpToken Ciąg

Wymagane.

Token Google do dalszej odpowiedzi.

Przykłady

Jaka jest prędkość Wi-Fi?

{
  "command": "action.devices.commands.TestNetworkSpeed",
  "params": {
    "testDownloadSpeed": true,
    "testUploadSpeed": true,
    "followUpToken": "123"
  }
}

Podczas wysyłania żądania testu szybkości wystąpił błąd.

Obsługiwane wartości:

networkSpeedTestInProgress

Dalsze odpowiedzi

Urządzenia z tą cechą mogą zwrócić w odpowiedzi operacja EXECUTE następujący ładunek odpowiedzi. Więcej informacji o wdrażaniu kolejnych odpowiedzi znajdziesz w artykule Powiadomienia o inteligentnych działaniach w domu.

Ładunek zawiera jedną z tych wartości:

Udało się: networkDownloadSpeedSpeed

Pola Typ Opis
followUpToken Ciąg

Wymagane.

Token podany w pierwotnym żądaniu EXECUTE.

status Ciąg

Wymagane.

Wynik żądania.

Obsługiwane wartości:

SUCCESS
networkDownloadSpeedMbps Number

Wymagane.

Szybkość pobierania w sieci mierzona w megabitach na sekundę.

Udało się: networkUploadSpeedSzybkość

Pola Typ Opis
followUpToken Ciąg

Wymagane.

Token podany w pierwotnym żądaniu EXECUTE.

status Ciąg

Wymagane.

Wynik żądania.

Obsługiwane wartości:

SUCCESS
networkUploadSpeedMbps Number

Wymagane.

Szybkość przesyłania sieci mierzona w megabitach na sekundę.

Udało się: networkDownloadSpeedMbs i sieciUploadSpeedMbs

Pola Typ Opis
followUpToken Ciąg

Wymagane.

Token podany w pierwotnym żądaniu EXECUTE.

status Ciąg

Wymagane.

Wynik żądania.

Obsługiwane wartości:

SUCCESS
networkDownloadSpeedMbps Number

Wymagane.

Szybkość pobierania w sieci mierzona w megabitach na sekundę.

networkUploadSpeedMbps Number

Wymagane.

Szybkość przesyłania sieci mierzona w megabitach na sekundę.

Niepowodzenie

Pola Typ Opis
followUpToken Ciąg

Wymagane.

Token podany w pierwotnym żądaniu EXECUTE.

status Ciąg

Wymagane.

Wynik żądania.

Obsługiwane wartości:

FAILURE
errorCode Ciąg

Wymagane.

Wartością może być dowolny kod błędu tego atrybutu, np. transientError.

Przykłady

Jaka jest prędkość Wi-Fi? (odpowiedź)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "networkDownloadSpeedMbps": 23.3,
      "networkUploadSpeedMbps": 10.2,
      "followUpToken": "1234"
    }
  }
}

Jaka jest prędkość Wi-Fi? (dalsza odpowiedź zakończy się niepowodzeniem)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "transientError",
      "followUpToken": "1234"
    }
  }
}

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.

Podczas próby kontrolowania danego profilu sieci wystąpił błąd.

Obsługiwane wartości:

networkProfileNotRecognized

Podczas wysyłania żądania testu szybkości wystąpił błąd.

Obsługiwane wartości:

networkSpeedTestInProgress