智能家居 AppSelector 特征架构
action.devices.traits.AppSelector
- 此特征用于能够切换输入的设备。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
availableApplications |
数组 |
必填。 应用列表。每个应用都有每种受支持语言的一个或多个同义词。第一个同义词将在响应中使用。 |
[item, ...] |
对象 |
此设备的用户可与之互动的应用。 |
key |
String |
必填。 应用的唯一键,不会在语音或响应中向用户显示。 |
names |
数组 |
必填。 每个应用的名称及其特定语言的同义词。 |
[item, ...] |
对象 |
应用同义词。 |
name_synonym |
数组 |
必填。 给定语言的应用名称易于理解的同义词。第一个同义词将在响应中使用。 |
[item, ...] |
String |
应用名称。 |
lang |
String |
必填。 语言代码。 |
示例
安装了 YouTube 应用的设备
{ "availableApplications": [ { "key": "youtube", "names": [ { "name_synonym": [ "YouTube", "YouTube US" ], "lang": "en" }, { "name_synonym": [ "YouTube", "YouTube DE" ], "lang": "de" } ] } ] }
设备状态
具有此特征的实体可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
currentApplication |
String |
必填。 当前活跃的应用在前台运行的键值对。 |
示例
目前在前台运行 YouTube 应用的设备。
{ "currentApplication": "YouTube" }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.appInstall
安装指定应用。
参数
参数 | 类型 | 说明 |
---|---|---|
newApplication |
String |
要安装的应用的键。 |
newApplicationName |
String |
要安装的应用的名称。 |
示例
通过密钥安装 YouTube 应用
{ "command": "action.devices.commands.appInstall", "params": { "newApplication": "YouTube" } }
按名称安装 YouTube 应用
{ "command": "action.devices.commands.appInstall", "params": { "newApplicationName": "YouTube US" } }
action.devices.commands.appSearch
搜索指定应用。
参数
参数 | 类型 | 说明 |
---|---|---|
newApplication |
String |
要搜索的应用的键。 |
newApplicationName |
String |
要搜索的应用的名称。 |
示例
按键搜索 YouTube 应用
{ "command": "action.devices.commands.appSearch", "params": { "newApplication": "YouTube" } }
按名称搜索 YouTube 应用
{ "command": "action.devices.commands.appSearch", "params": { "newApplicationName": "YouTube US" } }
action.devices.commands.appSelect
选择给定应用。
参数
参数 | 类型 | 说明 |
---|---|---|
newApplication |
String |
所选应用的键。 |
newApplicationName |
String |
所选应用的名称。 |
示例
按键选择 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
:应用已安装。