菜单项

提供的内容仅仅是故事的一半。最有趣的服务还允许用户进行交互的时间表卡通过菜单项。菜单项允许用户请求的动作相关时间轴卡，并配备有两种类型：内置菜单项和自定义菜单项。

内置菜单项提供玻璃提供的特殊功能，如大声朗读的时间表卡，导航到一个位置，共享图像，或答复消息：

自定义菜单项可以让您的应用程序公开到您的玻璃器皿，是特定的行为，你也可以提供一个菜单项的图标，以配合你的品牌。

您可以添加内置菜单项，通过填充菜单项数组，当你插入你的时间表项目。要使用一个内置的菜单项，你只需要填入每个菜单项的 动作。

注意：当使用内置的菜单项的答复或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"
    }
  ...
 ]
}

谷歌眼镜--与菜单项互动

菜单项

加上内置的菜单项

定义自定义菜单项

允许用户固定时间表卡