スマートホームの 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
: アプリはすでにインストールされています。