您可以指定您创建的时间表卡上的菜单项。这些可以包括内置的动作,如大声朗读,通过语音回复,并导航到。此外,您还可以指定自己的自定义操作,具体的为您服务。
菜单项的更多信息,请参阅以下资源:
- 开发人员指南
- 参考文档
- UI指南
开发人员指南:
菜单项
提供的内容仅仅是故事的一半。最有趣的服务还允许用户进行交互的时间表卡通过菜单项。菜单项允许用户请求的动作相关时间轴卡,并配备有两种类型:内置菜单项和自定义菜单项。
内置菜单项提供玻璃提供的特殊功能,如大声朗读的时间表卡,导航到一个位置,共享图像,或答复消息:
自定义菜单项可以让您的应用程序公开到您的玻璃器皿,是特定的行为,你也可以提供一个菜单项的图标,以配合你的品牌。
加上内置的菜单项
您可以添加内置菜单项,通过填充菜单项数组
,当你插入你的时间表项目 。要使用一个内置的菜单项,你只需要填入每个菜单项
的 动作
。
注意:当使用内置的菜单项的答复
或REPLY_ALL
,不需要用户说出一组有限的选项,如在游戏或服务的命令可能的行动。这些菜单项目的目的是捕捉自由形式的语音输入。
HTTP/1.1 201 Created
Date: Tue, 25 Sep 2012 23:30:11 GMT
Content-Type: application/json
Content-Length: 303
{
"text": "Hello world",
"menuItems": [
{
"action": "REPLY"
}
]
}
注:参考文档 包含可用的内建动作的详细说明。
定义自定义菜单项
内置动作可能不会永远是不够的。许多服务都需要暴露自己的特定的菜单项。这是自定义操作来发挥作用。
创建一个自定义菜单项通过指定一个menuItem.action
习惯
和 menuItem.id的
。当用户触发一个自定义菜单项, 通知发送给服务人口与 menuItem.id
。这可以让你确定源的通知。
您还必须填充menuItem.menuValue的
指定iconUrl
和 显示名称
将出现在玻璃设备。
HTTP/1.1 201 Created
Date: Tue, 25 Sep 2012 23:30:11 GMT
Content-Type: application/json
Content-Length: 303
{
"text": "Hello world",
"menuItems": [
{
"action": "CUSTOM",
"id": "complete"
"values": [{
"displayName": "Complete",
"iconUrl": "http://example.com/icons/complete.png"
}]
}
]
}
注:为了获得最佳效果,请使用50像素的正方形透明背景的PNG图标图像。
允许用户固定时间表卡
您可以创建一个菜单项,可以让您的用户针时间表卡,它将永久显示在时间轴的卡主时钟卡的左侧。用户可以取消固定卡,通过使用相同的菜单项。
钢钉菜单项是一个内置在菜单项,因此,所有你需要做的是提供一个菜单项
TOGGLE_PINNED
行动
。
HTTP/1.1 201 Created
Date: Tue, 25 Sep 2012 23:30:11 GMT
Content-Type: application/json
Content-Length: 303
{
"text": "You can pin or unpin this card.",
"menuItems": [
{
"action": "TOGGLE_PINNED"
}
...
]
}