Google Home デベロッパー センターにようこそ。スマートホーム アクションの開発方法を学ぶことができます。注: アクションの作成は、引き続き Actions Console で行います。
コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

スマートホームの AppSelector トレイトのスキーマ

action.devices.traits.AppSelector - このトレイトは、入力を切り替えられるデバイスに使用します。

デバイスの属性

この特性を持つデバイスは、SYNC オペレーションの一部として次の属性を報告する可能性があります。SYNC インテントの処理の詳細については、インテント フルフィルメントをご覧ください。

属性 タイプ 説明
availableApplications 配列

必須。

アプリケーションのリスト。各アプリケーションには、サポート対象の言語それぞれに 1 つ以上の類義語があります。レスポンスでは最初の同義語が使用されます。

[item, ...] オブジェクト

このデバイスのユーザーが操作できるアプリ。

key 文字列

必須。

音声やレスポンスでユーザーに公開されていない、アプリケーションの一意のキー。

names 配列

必須。

各アプリケーションの名前とその言語の固有類義語。

[item, ...] オブジェクト

アプリケーションの類義語。

name_synonym 配列

必須。

特定の言語のアプリケーション名の、ユーザー フレンドリーな類義語。レスポンスでは最初の同義語が使用されます。

[item, ...] 文字列

アプリケーション名。

lang 文字列

必須。

言語コード。

YouTube アプリがインストールされているデバイス

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

デバイスのステータス

この特性を持つデバイスは、QUERY オペレーションの一部として次の状態をレポートできます。QUERY インテントの処理の詳細については、インテント フルフィルメントをご覧ください。

状態 タイプ 説明
currentApplication 文字列

必須。

フォアグラウンドでアクティブになっている現在のアプリの Key-Value。

現在 YouTube アプリがフォアグラウンドで実行されているデバイス。

{
  "currentApplication": "youtube"
}

デバイスのコマンド

この特性を持つデバイスは、EXECUTE オペレーションの一部として次のコマンドに応答できます。EXECUTE インテントの処理の詳細については、インテント フルフィルメントをご覧ください。

action.devices.commands.appInstall

指定されたアプリケーションをインストールします。

パラメータ

パラメータ タイプ 説明
newApplication 文字列

インストールするアプリケーションのキー。

newApplicationName 文字列

インストールするアプリケーションの名前。

キーを使って YouTube アプリをインストールする

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

名前を指定して YouTube アプリをインストールする

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

action.devices.commands.appSearch

目的のアプリケーションを検索します。

パラメータ

パラメータ タイプ 説明
newApplication 文字列

検索するアプリケーションのキー。

newApplicationName 文字列

検索するアプリケーションの名前。

キーで YouTube アプリを検索する

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

YouTube アプリを名前で検索する

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

action.devices.commands.appSelect

目的のアプリケーションを選択します。

パラメータ

パラメータ タイプ 説明
newApplication 文字列

選択するアプリケーションのキー。

newApplicationName 文字列

選択するアプリケーションの名前。

キーで YouTube アプリを選択する

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

YouTube アプリを名前で選択する

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

サンプル音声

de-DE

  • Öffne Netflix auf dem Fernseher .

en-US

  • begin using YouTube app on the smart TV

es-ES

  • pon netflix en la tele del salón

fr-FR

  • Mets Netflix sur la télé .

hi-IN

  • टीवी पर नेटफ्लिक्स ऍप लॉन्च करो

it-IT

  • Apri Netflix sulla televisione della mia camera .

ja-JP

  • YouTube のアプリを テレビ でスタート

ko-KR

  • TV 에서 유튜브 앱 열어 줘

nl-NL

  • Start Netflix op mijn TV .

pt-BR

  • Abra o Netflix na TV para mim.
  • Abre o Youtube na televisão .

sv-SE

  • Öppna Youtube TV:n

デバイスエラー

エラーと例外のリストをご覧ください。
  • noAvailableApp: アプリケーションが存在しないか、利用できません。
  • appLaunchFailed: アプリを起動できませんでした。
  • alreadyInstalledApp: アプリケーションはすでにインストールされています。