スマートホームの 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 på TV:n

デバイスエラー

エラーと例外のリストをご覧ください。

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