谷歌眼镜Mirror API之Menu Items

原文链接：http://bbs.seacat.cn/thread-874-1-2.html

Menu Items（菜单项）

传播内容是只有一半的故事。最有趣的服务还允许用户通过菜单项与时间轴卡来互动。菜单项允许用户请求相关的行动时间轴卡片,菜单项有两种类型:内置菜单项和自定义菜单项。
内置菜单项为谷歌眼镜提供特殊的功能,如大声朗读时间卡,导航到一个位置,共享一个图像,或回复一条消息。

自定义菜单项允许应用程序针对于你的Glassware有特定的行为，而且你还可以提供一个菜单项的图标让其变得独一无二。

添加内置菜单项

你可以将内置菜单项添加到您的项目timeline item,通过填充menuItems数组来插入它们。要使用一个内置菜单项时,您只需要填充每个菜单项的操作即可。
注意：当使用内置菜单项的回复或回复所有，不需要用户说一组有限的选项,可能是在为服务等待一个游戏或命令。这些菜单项旨在捕捉自由形式的语音输入。
Raw HTTP

[HTML] 纯文本查看 复制代码
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"
}
]
}

注意： reference documentation包含一个详细可用的action

自定义菜单项
内置菜单往往满足不了需求，许多服务要求有特殊的菜单，这时自定义菜单就可以登场了。
创建一个自定义菜单通过指定CUSTOM 的 menuItem.action和 menuItem.id，当你的用户触发你的自定义菜单项，一个notification就会带着menuItem.id发送给你的服务。这允许您确定通知的来源
你还必须填充菜单项，menuValue 指定的iconUrl和displayname将显示到谷歌眼镜上。
Raw HTTP
[HTML] 纯文本查看 复制代码
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 action给菜单项。
Raw HTTP
[HTML] 纯文本查看 复制代码

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"
}
...
]
}