JEP-0084: User Avatar Jabber用户头像协议
|
用户头像在 Jabber 中叫做 “Avatar”，JEP-0084 定义了一种符合XMPP协议的方法来传递头像信息，它的协议是构建在 pubsub 的 Personal Eventing via Pubsub [2] subset ("PEP") 基础上。另外头像avatar还可以使用vCard来存储，如psi就是用vCard。
使用 JEP-0084 的客户端目前还比较少。 另外还有一种老的avatar协议 JEP-0008: IQ-Based Avatars，Pandion 目前使用的就是用那个已经淘汰的协议。 JEP-0084 使用了两个节点来保存 avatar 信息，状态(metadata node)和图片内容(data node)。用户再更新了 avatar 数据(data node)之后会同时更新 metadata node 的内容(相当更新内容索引)，订阅的用户只需要订阅 metadata node, 只有在 metadata node 发现有更新之后才更新 data node 内容，这样就避免用户每次查询 data node 产生大量数据流量。 Avatar使用流程： 1. 用户创建 metadata 节点 Send: <iq type='set' from='timyang@jabber.org/chamber' id='create1'> <pubsub xmlns='http://jabber.org/protocol/pubsub'> <create node='http://jabber.org/protocol/avatar#metadata'/> <configure> <x xmlns='jabber:x:data' type='form'> <field var='FORM_TYPE' type='hidden'> <value>http://jabber.org/protocol/pubsub#node_config</value> </field> <field var='pubsub#access_model'> <option><value>presence</value></option> </field> </x> </configure> </pubsub> </iq> NodeID 必须是 "http://jabber.org/protocol/avatar#metadata" 访问方式应为 "presence". <iq type='result' to='timyang@jabber.org/chamber' id='create1'/> 2. 创建 data node 创建 data node, 类型必须是 "image/png" 用户创建数据节点, node 必须是 http://jabber.org/protocol/avatar#data <iq type='set' from='timyang@jabber.org/chamber' id='create2'> <pubsub xmlns='http://jabber.org/protocol/pubsub'> <create node='http://jabber.org/protocol/avatar#data'/> <configure/> </pubsub> </iq> <iq type='result' to='timyang@jabber.org/chamber' id='create2'/> 3. 发布图片 用户发布 image/png 类型的图片信息到数据节点，同时以HTTP URL形式提交其他格式的图片，如下例中的 qqshow <iq type='set' from='timyang@jabber.org/chamber' id='publish1'> <pubsub xmlns='http://jabber.org/protocol/pubsub'> <publish node='http://jabber.org/protocol/avatar#data'> <item id='111f4b3c50d7b0df729d299bc6f8e9ef9066971f'> <data xmlns='http://jabber.org/protocol/avatar#data'> qANQR1DBwU4DX7jmYZnncm... </data> </item> <item id='222f4b3c50d7b0df729d299bc6f8e9ef9066971f'> <data xmlns='http://jabber.org/protocol/avatar#data'> http://qqshow.qq.com/12345/my.swf </data> </item> </publish> </pubsub> </iq> <iq type='result' to='timyang@jabber.org/chamber' id='publish1'/> 4. 发布图片索引 头像索引信息到 meta data 节点, item id 设置为图片文件的 hash 值，便于其他订阅用户用来比较图片是否变化。 用户设置头像可能会轮流使用几个固定的文件，这样另外一个订阅的用户可以对图片进行cache，这样就不用每次更新都重新下载图片。 <iq type='set' from='timyang@jabber.org/chamber' id='publish2'> <pubsub xmlns='http://jabber.org/protocol/pubsub'> <publish node='http://jabber.org/protocol/avatar#metadata'> <item id='111f4b3c50d7b0df729d299bc6f8e9ef9066971f'> <metadata xmlns='http://jabber.org/protocol/avatar#metadata'> <info id='111f4b3c50d7b0df729d299bc6f8e9ef9066971f' type='image/png' bytes='12345' height='64' width='64'/> </metadata> </item> </publish> </pubsub> </iq> 5. 订阅者(用户的好友)获取消息 <message to='romeo@montague.net' from='timyang@jabber.org'> <event xmlns='http://jabber.org/protocol/pubsub#event'> <items node='http://jabber.org/protocol/avatar#metadata'> <item id='111f4b3c50d7b0df729d299bc6f8e9ef9066971f'> <metadata xmlns='http://jabber.org/protocol/avatar#metadata'> <info id='111f4b3c50d7b0df729d299bc6f8e9ef9066971f' type='image/png' bytes='12345' height='64' width='64'/> </metadata> </item> </items> </event> <addresses xmlns='http://jabber.org/protocol/address'> <address type='replyto' jid='timyang@jabber.org/chamber'/> </addresses> </message> 6. 如果需要，订阅者获取图片内容 <iq type='get' from='romeo@montague.net/home' to='timyang@jabber.org' id='retrieve1'> <pubsub xmlns='http://jabber.org/protocol/pubsub'> <items node='http://jabber.org/protocol/avatar#data'> <item id='111f4b3c50d7b0df729d299bc6f8e9ef9066971f'> </items> </pubsub> </iq> 服务器返回结果，注意不是由客户端返回，JEP里面P2P的理念还是太少了。 <iq type='result' from='timyang@jabber.org' to='romeo@montague.net/home' id='publish1'> <pubsub xmlns='http://jabber.org/protocol/pubsub'> <publish node='http://jabber.org/protocol/avatar#data'> <item id='111f4b3c50d7b0df729d299bc6f8e9ef9066971f'> <data xmlns='http://jabber.org/protocol/avatar#data'> qANQR1DBwU4DX7jmYZnncm... </data> </item> </publish> </pubsub> </iq> 7. 可选的，用户也可以在客户端设置不显示用户头像 使用 stop 标签 <iq type='set' from='timyang@jabber.org/chamber' id='publish3'> <pubsub xmlns='http://jabber.org/protocol/pubsub'> <publish node='avatar/info/timyang@jabber.org'> <item> <metadata xmlns='http://jabber.org/protocol/avatar#metadata'> <stop/> </metadata> </item> </publish> </pubsub> </iq> As before, subscribers to the metadata node would then receive the notification: Example 12. Subscribers receive avatar metadata notification <message to='romeo@montague.net' from='timyang@jabber.org'> <event xmlns='http://jabber.org/protocol/pubsub#event'> <items node='http://jabber.org/protocol/avatar#metadata'> <item> <metadata xmlns='http://jabber.org/protocol/avatar#metadata'> <stop/> </metadata> </item> </items> </event> <addresses xmlns='http://jabber.org/protocol/address'> <address type='replyto' jid='timyang@jabber.org/chamber'/> </addresses> </message> |
