联系
联系可以是人或Glassware,用户可以分享timelineitem。默认情况下,Glassware不能访问时间表并没有创建的项目。允许用户通过Glassware分享timelineitem，即使timelineitem并没有创建。
下面有两种方法,你的Glassware可以使用contant:
允许用户与其他用户分享你的timeline items。添加分享内置菜单项到时间轴卡片。当用户点击分享菜单项、谷歌眼镜显示的列表可能分享给联系人。有关更多信息,请参见开发人员指南 menu items如何添加内置菜单项。
允许用户通过你的Glassware共享timeline item：创建一个代表你的Glassware。当用户想要分享一个时间轴卡片,你的联系人可以作为一个选项。你也可以声明一个可接受的MIME类型列表（ acceptable MIME types）,这样你的联系人只出现您感兴趣的卡片。当用户共享一个时间轴卡片你会得到通知,你可以订阅timeline通知。
创建一个contact
允许用户通过你的Glassware来分享timelineitems，插入一个contact通过post一段json（ JSON representation of a contact）给插入的REST端点（insert REST endpoint.）
所有的联系人都必须指定一个id。用来在Glassware接收通知时识别。你还必须指定一个displayName和至少一个imageUrl，好在谷歌眼镜上显示联系人的信息给用户。
注意：为达到最佳效果，imageUrl使用PNG的图像，背景色要透明，分辨率是640x360.
Raw HTTP
[HTML] 纯文本查看 复制代码
?
01
02
03
04
05
06
07
08
09
10
11
POST /mirror/v1/contacts HTTP/1.1
Authorization: Bearer {auth token}
Content-Type: application/json
Content-Length: {length}
{
"id": "harold"
"displayName": "Harold Penguin",
"iconUrl": "https://developers.google.com/glass/images/harold.jpg"
"priority": 7
}
可以从共享timeline items（ shared timeline items）来获取更多的关于如何处理通知的资料。
分享是如何工作的
一旦你创建一个共享contact,分享时间轴卡片一般遵守这个流程
1．用户滑动时间轴项,选择共享菜单项,选择你的联系人
2．MirrorAPI创建一个共享时间轴卡片的副本,给你联系人访问,并将副本插入用户的timeline。你的Glassware不能访问原始的时间轴卡片
3．如果你订阅了分享通知（subscribed to share notifications），你会收到一个包含时间轴卡片的识别信息，你可以通过 Timeline.get方法来检索timelineitem。
4.你通过Timeline.update方法来更新共享时间轴卡片和现有的时间轴卡片。
注意：你应该为你的Glassware添加识别品牌来区分从最初的timeline item复制过来的timeline item。用更新复制的timeline item的方式来代替插入一个新的timeline item。
下面的屏幕截图展示了在谷歌眼镜上如何分享联系人
加标题分享照片
用户有可能会通过Glassware分享照片并插入一篇演讲的标题。一般通过下面这几步：
1.用户轻触一项包含照片的timeline item，选择共享菜单项。接着选择联系人
2.用户在短时间内轻触这张照片来给它添加一个标题
3.用户说出标题
4.Timeline item和你的Glassware开始共享工作，就像之前描述的那样。此外，timeline item 的文本（text）属性会把用户说的话转录成标题。
声明语音菜单命令
你可以让用户在菜单插入语音命令 ok glass 通过你的Contact来共享timeline item。触发后，语音命令会通过你的contact来共享timeline item还包括转录用户的演讲，你可以为你的contact声明下面的语音命令：
~"take a note"
~"post an update"
注意：请求支持其他的语音指令，建议填写一个语音命令表单（ Suggest a Glass Voice Command form）
使用语音命令,指定接收指令（acceptCommands ）属性与适当的类型
[HTML] 纯文本查看 复制代码
?
01
02
03
04
05
06
07
08
09
{
...
"displayName": "Cat Stream",
"id": "CAT_STREAM",
"acceptCommands": [
{"type": "POST_AN_UPDATE"}
]
}
上面的例子更新你的用户的语音菜单包括 post an update 命令
如果不止一个Glassware注册一个相同的语音命令，谷歌眼镜会通过二级菜单来显示每个contact的displayName。用户可以说话来连接他们的选择，如果你的contact 显示在屏幕上名字包含不能发音的字符或者不是语音，说出谐音来使用你的分享交流。
例如：一个用户可能会在chipotle生日到来是时候说，ok glass，post an update tocat stream chipotle s birthday is tomorrow.
如果你的Glassware订阅了timeline通知，Mirror API会推送一个通知
[HTML] 纯文本查看 复制代码
?
01
02
03
04
05
06
07
08
09
10
{
"collection": "timeline",
"operation": "UPDATE",
"userToken": "<USER_TOKEN>",
"verifyToken": "<VERIFY_TOKEN>",
"itemId": "<ITEM_ID>",
"userActions": [
{"type": "LAUNCH"}
]
}
然后,您可以使用itemId获取timeline的值
[HTML] 纯文本查看 复制代码
?
01
02
03
04
05
06
07
{
"id": "<ITEM_ID>",
"text": "Chipotle's birthday is tomorrow",
"recipients": [
{"id": "CAT_STREAM"}
]
}
与媒体分享，你应该修改共享时间轴卡片和通过 Timeline.update.方法来更新现有的时间轴卡片。
