(十一)即时通讯之XMPPFramework电子名片

前言

这也是本人第一次琢磨关于即时通讯方面的内容,结合网上查看的相关资料搭建出来的仿微信小demo,如有意见请多多指教

具体项目可以在githubWeiChat下载进行查看,如若各位看官老爷觉得还可以请点star

服务器地址

**Attention,这里需要改成自己的服务器地址和端口号
并且数据库和服务器一定要开启哟,不然没法登陆的哟**
#ifdef DEBUG
#define kHostName @"192.168.199.111"
//#define kHostName @"127.0.0.1"
#define kHostPort 5222
#else
#define kHostNanme @""
#define kHostPort 5222
#endif

本篇讲的是XMPPFramework的电子名片部分

1.什么叫电子名片

在Extensions中有XEP-0054扩展，提供了一种可以通过XMPP发送电子名片的机制。

vCard，也叫Versitcard，vCard的常用文件扩展名是.vcf。在XMPP中通过XMPPvCardTemp和XMPPvCardCoreDataStorage两个类来实现。
vCard是电子名片的文件格式标准，一般附加在电子邮件之后，但也可以用于其它场合，比如在因特网上相互交换。

2.电子名片相关类

XMPPvCardTemp 代表电子名片
它是继承自NSXMLElement的,提供了很多属性,比如出生日期,姓名,地址,手机号,邮箱等.
XMPPvCardCoreDataStorage 代表电子名片在core data存储
它是一个单例类,直接与数据库相关,它遵循 XMPPvCardAvatarStorage,表示头像模块的存储代理,就可以将电子头像写入电子名片数据存储中
XMPPvCardTempModule ,继承自XMPPModule类,用于提供电子名片增、删、改、查操作

3.XMPPvCardTemp的使用

注意:
1. XMPPvCardTemp可以在各个界面获得,用于用户信息的展示
2.当对XMPPvCardTemp进行了修改时,需要想服务器进行更新
3.可以通过代理方法获得用户头像,使用传值来获得头像展示

3.1XMPPvCardTemp的激活

/**
         *  XMPPvCardCoreDataStorage和XMPPvCardTempModule模块的激活与设置代理
         */
        self.vCardStorage = [XMPPvCardCoreDataStorage sharedInstance];
        self.vCardModule = [[XMPPvCardTempModule alloc] initWithvCardStorage:self.vCardStorage];
        [self.vCardModule activate:self.stream];
        [self.vCardModule addDelegate:self delegateQueue:dispatch_get_main_queue()];
        
        /**
         *  XMPPvCardAvatarModule头像模块激活与设置代理
         */
        self.vCardAvatar = [[XMPPvCardAvatarModule alloc] initWithvCardTempModule:self.vCardModule];
        [self.vCardAvatar activate:self.stream];
        [self.vCardAvatar addDelegate:self delegateQueue:dispatch_get_main_queue()];

3.2XMPPvCardTemp的使用

在微信主界面中我的界面可以通过电子名片来获得用户相关信息

 /**
     *  从电子名片的模型中获取自已用户信息的电子名片展示在个人信息中
     */
    XMPPManager *manager = [XMPPManager sharedmanager];
    XMPPvCardTemp *vCard = manager.vCardModule.myvCardTemp;
    self.nameLab.text = vCard.nickname;
    self.weiXinNameLab.text = [NSString stringWithFormat:@"微信号:  %@",[UserManager sharedmanager].loginName];
    self.headerImageV.image = [UIImage imageWithData:vCard.photo];
    
    // 头像发生改变时,回调block改变个人信息的头像
    [manager xmppGetUserHeaderImage:^(UIImage *image) {
        self.headerImageV.image = image;
    }];

在微信的用户设置界面可以对用户的信息相关设置,这里举例对用户头像的设置

// 选取头像成功后需要手动将数据更新到服务器
    XMPPManager *manager = [XMPPManager sharedmanager];
    XMPPvCardTemp *vCard = manager.vCardModule.myvCardTemp;
    vCard.photo = UIImageJPEGRepresentation(image, 0.75);
    //vCard.nickname = @"华惠友";
    // 更新到服务器
    [manager.vCardModule updateMyvCardTemp:vCard];

3.3当用户电子名片代理

当用户的名片信息或头像发生变化时,如果在激活模块中设置了代理,那么就可以通过代理来获得用户的名片信息

#pragma mark -- XMPPvCardTempModuleDelegate名片代理
/**
 *  当用户名片信息发生改变时,调用该方法
 */
- (void)xmppvCardTempModule:(XMPPvCardTempModule *)vCardTempModule
        didReceivevCardTemp:(XMPPvCardTemp *)vCardTemp
                     forJID:(XMPPJID *)jid {
    // 打印用户信息
    XMPPvCardTemp *temp = [self.vCardStorage vCardTempForJID:jid xmppStream:self.stream];
    //NSLog(@"%@",temp);
}

#pragma mark ******************************
#pragma mark -- XMPPvCardAvatarDelegate名片代理
/**
 *  当用户名片头像发生改变时,调用该方法
 */
- (void)xmppvCardAvatarModule:(XMPPvCardAvatarModule *)vCardTempModule
              didReceivePhoto:(UIImage *)photo
                       forJID:(XMPPJID *)jid {
    NSLog(@"头像发生变化");
    if (self.imageBlock) {
        self.imageBlock(photo);
    }
}

未完待续...