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 inteligentnego wyboru aplikacji Home Home

action.devices.traits.AppSelector – to atrybut jest używany w przypadku urządzeń, które mogą przełączać sygnały wejściowe.

ATRYBUTY urządzenia

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

Atrybuty Typ Opis
availableApplications Tablica

Wymagany.

Lista aplikacji. Każda aplikacja ma co najmniej 1 synonim w każdym obsługiwanym języku. W odpowiedzi jest używany pierwszy synonim.

[item, ...] Obiekt

Aplikacja, z którą użytkownicy tego urządzenia mogą korzystać.

key Ciąg

Wymagany.

Unikalny klucz aplikacji, który nie jest dostępny dla użytkowników mowa ani odpowiedź.

names Tablica

Wymagany.

Nazwa każdej aplikacji i jej synonimy.

[item, ...] Obiekt

Synonimy aplikacji.

name_synonym Tablica

Wymagany.

Przyjazne dla użytkownika synonimy nazwy aplikacji w danym języku. W odpowiedzi jest używany pierwszy synonim.

[item, ...] Ciąg

Nazwa aplikacji.

lang Ciąg

Wymagany.

Kod języka.

Przykłady

Urządzenie z aplikacją YouTube

{
  "availableApplications": [
    {
      "key": "youtube",
      "names": [
        {
          "name_synonym": [
            "youtube",
            "YouTube US"
          ],
          "lang": "en"
        },
        {
          "name_synonym": [
            "youtube",
            "YouTube DE"
          ],
          "lang": "de"
        }
      ]
    }
  ]
}

Urządzenie STATES

W ramach operacji QUERY urządzenia z tą cechą mogą zgłaszać podane niżej stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany Typ Opis
currentApplication Ciąg

Wymagany.

Wartość klucza bieżącej aplikacji aktywnej na pierwszym planie.

Przykłady

Urządzenie z aplikacją YouTube aktywne na pierwszym planie.

{
  "currentApplication": "youtube"
}

Polecenie urządzenia

Urządzenia z tą cechą mogą w ramach operacji EXECUTE odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji Realizacja intencji.

action.devices.commands.appInstall

Zainstaluj daną aplikację.

Parametry

Parametry Typ Opis
newApplication Ciąg

Klucz aplikacji do zainstalowania.

newApplicationName Ciąg

Nazwa aplikacji do zainstalowania.

Przykłady

Instalowanie aplikacji YouTube według klucza

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplication": "youtube"
  }
}

Instalowanie aplikacji YouTube według nazwy

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSearch

Wyszukaj daną aplikację.

Parametry

Parametry Typ Opis
newApplication Ciąg

Klucz aplikacji do wyszukania.

newApplicationName Ciąg

Nazwa aplikacji do wyszukania.

Przykłady

Wyszukaj aplikację YouTube według klucza

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplication": "youtube"
  }
}

Wyszukaj aplikację YouTube wg nazwy

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSelect

Wybierz aplikację.

Parametry

Parametry Typ Opis
newApplication Ciąg

Klawisz aplikacji do wyboru.

newApplicationName Ciąg

Nazwa aplikacji do wyboru.

Przykłady

Wybierz aplikację YouTube według klucza

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplication": "youtube"
  }
}

Wybierz aplikację YouTube po nazwie

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

Przykładowe wypowiedzi

de-DE

  • Netflix auf dem Fernseher .

en-US

  • zacznij korzystać z aplikacji YouTube na telewizorze smart TV

es-ES

  • pon netflix en la tele del salón

fr-FR

  • Mets Netflix sur la télé .

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.
  • noAvailableApp: aplikacja nie istnieje lub jest niedostępna.
  • appLaunchFailed: nie udało się uruchomić aplikacji.
  • alreadyInstalledApp: aplikacja jest już zainstalowana.