スマートホームの 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 onthe smart TV
es-ES
-
pon
netflix enla tele del salón
fr-FR
-
Mets
Netflix surla télé .
hi-IN
-
टीवी परनेटफ्लिक्स ऍप लॉन्च करो
it-IT
-
Apri
Netflix sulla televisione della mia camera .
ja-JP
-
YouTube のアプリをテレビ でスタート
ko-KR
-
TV 에서유튜브 앱 열어 줘
nl-NL
-
Start
Netflix opmijn TV .
pt-BR
-
Abra o
Netflix naTV para mim. -
Abre o
Youtube natelevisão .
sv-SE
-
Öppna
Youtube påTV:n
デバイスエラー
エラーと例外のリストをご覧ください。noAvailableApp
: アプリケーションが存在しないか、利用できません。appLaunchFailed
: アプリを起動できませんでした。alreadyInstalledApp
: アプリケーションはすでにインストールされています。