环信SDK 头像、昵称、表情自定义和群聊设置的实现 一(附源码)

前言:

环信的SDK在公司的项目中有用到,现在用到的是群聊的部分,这里我们分析总结一下自己对环信给的DEMO大概的拆解一下,说说我们怎么样充分的利用这个demo来写我们所需要的业务。这个也由于篇幅的原因,实在没办法写成一篇博客,我们今天先说说它的一个文件解析昵称头像的实现。写这篇博客环信也是更新到3.0版本了,我们就按照3.0的版本分析一下,先看看这整个Demo的大概的文件;

刚开始,使用这个Demo的时候,有些人不知道自己需要的到底是什么文件,一个劲的恨不得连整个Demo全都拉进来,建议大家千万不要这样子做,你花点时间好好研究一些,看一下整个Demo有哪些你是用的着的,有哪些你是用不着的,找有用的拉进自己的项目中!给大家看看我觉得你用的着的一下文件,先看这整个大文件夹EaseUI,环信的文件我用到的全都在这里了。

我自己拉到项目中的就这么多,当然这个也因需求有个具体的不同,说两个地方:

一: 关于3rdparty这个文件,这里面是第三方的文件,有些事环信二次封装的,你一定要看清楚,已经在你项目中的,建议不要再拉进来!!环信封装的一些,比如图片浏览三方这些,你要自己项目中已经存在这样功能的第三方就不要再重复拉进来。保持整个项目代码的整洁,避免混乱和一些不懂也没用的代码出现,给以后造成困难! 

二:Resources这个文件,这里面的图片我几乎是已经删除干净了,我们自己项目中的UI肯定是要自己重新写的,不能直接连图片就不改动的用环信的Demo,建议这里这样做,等你们的设计师做好相应的UI切图之后,你拿到图片再找环信对应的是那张,全局搜索这张图片的名字,找到位置,看清楚了再把自己的UI切图名称换上去!

三:说说环信SDK,因为自己的项目中还是有网易云直播SDK和支付宝微信的SDK,比较的多,这时候你一定要注意静态文件!避免这里面出现冲突!其实只要仔细点,集成环信这一步我相信大部分人都没啥问题,集成这个也不是我们今天说的重点,我们把重点放在功能解析Demo上面!

重点是这两个文件:Class 和 EaseUI 

恩,是的,重点就是这个文件,重点都在这个文件夹当中,我们先看看Class这个文件夹当中的内容:

    说这么几点,先看到这里的话,我的给大家说一下,

一:这里的三个文件CoreData文件就是本地化的一些存储,ChatGroup是关于群聊的一些文件,剩下的几乎都在Chat这个文件夹当中了。

二:APPDelegate的几个类别,写的还是不错的,这说的不是说代码多精简,看着这里我也真的是学习到了,以后这样的话我们的支付,聊天,推送等等都可以一个功能一个功能的区分开了,简单,明了!!看看下面我们项目中的真实按照这思路写的,希望大家看了都可以学到思路,具体怎么写的,你可以看看Demo里面的代码,有问题也可以来找我!我尽我所能!

在说说这个 EaseUI,这么说吧,只要和界面相关的东西都在这个文件夹里面!!EaseUI这里面最重要的是ViewController这个文件夹了:

箭头标注出来的地方,大家注意这个继承关系!

仔细说说下面的功能:

一:头像和昵称

给大家看看下面的效果图,这是自己我们项目中的界面截图:

好,我们说说这个昵称和头像,官方有给出这两个方法来处理头像;

方法一 从APP服务器获取昵称和头像

  • 昵称和头像的获取:当收到一条消息(群消息)时,得到发送者的用户ID,然后查找手机本地数据库是否有此用户ID的昵称和头像,如没有则调用APP服务器接口通过用户ID查询出昵称和头像,然后保存到本地数据库和缓存,下次此用户发来信息即可直接查询缓存或者本地数据库,不需要再次向APP服务器发起请求
  • 昵称和头像的更新:当点击发送者头像时加载用户详情时从APP服务器查询此用户的具体信息然后更新本地数据库和缓存。当用户自己更新昵称或头像时,也可以发送一条透传消息到其他用户和用户所在的群,来更新该用户的昵称和头像。

方法二 从消息扩展中获取昵称和头像

  • 昵称和头像的获取:把用户基本的昵称和头像的URL放到消息的扩展中,通过消息传递给接收方,当收到一条消息时,则能通过消息的扩展得到发送者的昵称和头像URL,然后保存到本地数据库和缓存。当显示昵称和头像时,请从本地或者缓存中读取,不要直接从消息中把赋值拿给界面(否则当用户昵称改变后,同一个人会显示不同的昵称)。
  • 昵称和头像的更新:当扩展消息中的昵称和头像URI与当前本地数据库和缓存中的相应数据不同的时候,需要把新的昵称保存到本地数据库和缓存,并下载新的头像并保存到本地数据库和缓存。

  这里项目采用的是方法二,通过扩展消息来添加头像和昵称:我们一句一句的实现上面的话,先实现这一条:当收到一条消息时,则能通过消息的扩展得到发送者的昵称和头像URL,然后保存到本地数据库和缓存。

     下面的两个文件是通过FMDB缓存的,通过CoreData肯定也是没有问题的,下面是缓存文件的源码文件ChatUserDataManagerHelper.h

#import <Foundation/Foundation.h>
#import "UserInfoModel.h"
#import "FMDB.h"
 
@interface ChatUserDataManagerHelper : NSObject
 
/**
 保存用户数据,登录创建Model保存
  
 @param userinfoDic 用户数据字典
 */
+(void)saveUserInfoModel:(UserInfoModel*)userInfo;
 
/**
 保存用户数据,收到消息的扩展是字典类型,用这个方法直接保存。
  
 @param userinfoDic 用户数据字典
 */
+(void)saveUserInfoDictionary:(NSDictionary *)userinfoDic;
 
/**
 根据一个userID 查询一个用户数据
  
 @param  userid         用户id
 @return UserInfoModel  返回一个用户Model
 */
+(UserInfoModel *)queryByuserEaseMobId:(NSString *)userid;
 
@end

还有就是ChatUserDataManagerHelper.m文件了:

#import "ChatUserDataManagerHelper.h"
 
#define DBNAME @"cache_data.db"
 
@implementation ChatUserDataManagerHelper
 
/**
 类方法创建一张表单
  
 @param FMDBTable FMDBTable表
 */
 
+(void)createTable:(FMDatabase *)Database
{
    // 打开
    if ([Database open]) {
         
        // 要是不存在UserInfo表单
        if (![Database tableExists :@"userinfo"]) {
             
            // 创建这张表单,参数(用户ID,用户名称,用户头像)
            if ([Database executeUpdate:@"create table userinfo (userid text, username text, userimage text)"]) {
                 
                // NSLog(@"create table success");
                 
            }else{
                 
               // NSLog(@"fail to create table");
            }
             
        }else {
             
               // NSLog(@"table is already exist");
        }
         
    // 打开失败
    }else{
         
      // NSLog(@"fail to open");
    }
}
 
 
/**
 从userinfo清除所有信息
 
 @param FMDBTable FMDBTable表
 */
+ (void)clearTableData:(FMDatabase *)Database
{
    if ([Database executeUpdate:@"DELETE FROM userinfo"]) {
         
        //NSLog(@"clear successed");
         
    }else{
         
        // NSLog(@"fail to clear");
    }
}
 
 
/**
 获取FMDatabase
  
 @return FMDatabase
 */
+(FMDatabase*)getFMDB{
     
    NSString   *  docsPath   = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0];
    NSString   *  FMDBPath   = [docsPath stringByAppendingPathComponent:DBNAME];
    FMDatabase *  Database   = [FMDatabase databaseWithPath:FMDBPath];
    [self createTable:Database];
    return Database;
}
 
 
/**
 保存用户Model
 
 @param userInfo userInfo description
 */
+(void)saveUserInfoModel:(UserInfoModel*)userInfo{
     
    [ChatUserDataManagerHelper SaveUserInfoWithUserEaseMobId:userInfo.userEaseMobId andUserHeaderImageUrl:userInfo.userHeaderImageUrl andUserNickName:userInfo.usernickName];
}
 
 
/**
 根据创建的用户数据Model,保存用户信息
 
 @param easeMobId 用户ID
 @param imageUrl  用户头像
 @param nickName  用户昵称
 */
 
+(void)SaveUserInfoWithUserEaseMobId:(NSString *)easeMobId andUserHeaderImageUrl:(NSString*)imageUrl andUserNickName:(NSString*)nickName{
     
     
    NSMutableDictionary * userDic = [NSMutableDictionary dictionary];
     
    [userDic setValue:easeMobId forKey:CHATUSERID];
    [userDic setValue:imageUrl  forKey:CHATUSRTHEADIMAGE];
    [userDic setValue:nickName  forKey:CHATUSERNICK];
     
    [ChatUserDataManagerHelper saveUserInfoDictionary:userDic];
}
 
 
/**
 保存用户数据
 
 @param userinfoDic 用户数据字典
 */
+(void)saveUserInfoDictionary:(NSDictionary *)userinfoDic{
     
    FMDatabase *  dataBase = [self getFMDB];
     
    NSString   *  userid   = [userinfoDic objectForKey:CHATUSERID];
     
    if ([dataBase executeUpdate:@"DELETE FROM userinfo where userid = ?", userid]) {
         
        debugLog(@"删除成功");
         
    }else{
         
        debugLog(@"删除失败");
    }
     
    NSString *username  = [userinfoDic objectForKey:CHATUSERNICK];
    NSString *userimage = [userinfoDic objectForKey:CHATUSRTHEADIMAGE];
    if ([dataBase executeUpdate:@"INSERT INTO userinfo (userid, username, userimage) VALUES (?, ?, ?)", userid,username,userimage]) {
         
        debugLog(@"插入成功");
         
    }else{
         
        debugLog(@"插入失败");
    }
     
    //  NSLog(@"%d: %@", [db lastErrorCode], [db lastErrorMessage]);
    FMResultSet *rs = [dataBase executeQuery:@"SELECT userid, username, userimage FROM userinfo where userid = ?",userid];
     
    if ([rs next]) {
         
        NSString * userid    = [rs stringForColumn:@"userid"];
        NSString * username  = [rs stringForColumn:@"username"];
        NSString * userimage = [rs stringForColumn:@"userimage"];
        debugLog(@"查询一个 %@ %@ %@",userid,username,userimage);
    }
     
    rs = [dataBase executeQuery:@"SELECT userid, username, userimage FROM userinfo"];
    while ([rs next]) {
        NSString * userid    = [rs stringForColumn:@"userid"];
        NSString * username  = [rs stringForColumn:@"username"];
        NSString * userimage = [rs stringForColumn:@"userimage"];
         
        debugLog(@"查询所有 %@ %@ %@",userid,username,userimage);
    }
     
    [rs close];
     
    // NSLog(@"%d: %@", [db lastErrorCode], [db lastErrorMessage]);
    [dataBase close];
}
 
 
/**
 根据一个userID 查询一个用户数据
 
 @param  userid         用户id
 @return UserInfoModel  返回一个用户Model
 */
 
+(UserInfoModel *)queryByuserEaseMobId:(NSString *)userid {
     
    FMDatabase * dataBase     = [self getFMDB];
     
    if ([dataBase open]) {
         
        FMResultSet *rs = [dataBase executeQuery:@"SELECT userid, username, userimage FROM userinfo where userid = ?",userid];
         
        if ([rs next]) {
             
            UserInfoModel * userInfo = [[UserInfoModel alloc] init];
             
            userInfo.userEaseMobId      = [rs stringForColumn:@"userid"];
            userInfo.usernickName       = [rs stringForColumn:@"username"];
            userInfo.userHeaderImageUrl = [rs stringForColumn:@"userimage"];
             
            debugLog(@"查询一个 %@",userInfo);
            return userInfo;
             
        }else{
             
            return nil;
        }
    }else{
         
        return nil;
    }
}
 
@end

注意: 通过上面的代码,你就实现了存储的功能。不过你的记着,在登录成功之后你得先把自己的信息存储起来,在更改了个人资料之后,你要更新这里的存储信息。

我们再说这个发送消息的时候,把自己的个人信息附加在扩展消息当中发送出去,这里我们就用发送文本消息为例子,其他的都一样:

你找到EaseSDKHelper.m这个文件,这里面有这个方法

+(EMMessage *)sendTextMessage:(NSString *)text  to:(NSString *)toUser  messageType:(EMChatType)messageType  messageExt:(NSDictionary *)messageExt

说说这里,这个你看看Demo的话你就可以看到,所有的信息发送都是EaseSDKHelper这个类发送的,由于这个EaseMessageViewController控制器已经代码行数够多了,就不要再在这里添加了,写在EaseSDKHelper,在EaseMessageViewController中有下面这个方法,这个方法就是发送消息的

- (void)_sendMessage:(EMMessage *)message

看看EaseSDKHelper.m中我们怎样添加扩展消息发送的,

#pragma mark - send message
+(EMMessage *)sendTextMessage:(NSString *)text
                            to:(NSString *)toUser
                   messageType:(EMChatType)messageType
                    messageExt:(NSDictionary *)messageExt{
 
    NSMutableDictionary * extDictionary = nil;
    // 这里要加判断,因为群聊消息的扩展和直播聊天室的扩展会冲突
    if (messageType == EMChatTypeGroupChat) {
         
       //这是为了区分一下表情的扩展消息
        if (!messageExt) {
             
            extDictionary = [self reGetMessageExt];
             
        }else{
 
            //扩展消息字典
            extDictionary = [[NSMutableDictionary alloc]initWithDictionary:messageExt];
            [extDictionary addEntriesFromDictionary:[self reGetMessageExt]];
      
        }
    }
 
    NSString *willSendText = [EaseConvertToCommonEmoticonsHelper convertToCommonEmoticons:text];
    EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:willSendText];
    NSString *from = [[EMClient sharedClient] currentUsername];
    EMMessage *message = [[EMMessage alloc] initWithConversationID:toUser from:from to:toUser body:body ext:extDictionary];
    message.chatType = messageType;
    return message;
}
 
// 获取消息扩展,这里不要纠结,我这里只是去了一下自己本地存储的个人信息,你把自己的取出来拼成一个字 // 典返回就可以了
+(NSMutableDictionary*)reGetMessageExt{
     
    NSMutableDictionary *extDic = [NSMutableDictionary dictionary];
    NSString * userId = [NSString stringWithFormat:@"%@",READUSERDEFAULTS(UserId)];
    [extDic setValue:userId forKey:CHATUSERID];
    [extDic setValue:READUSERDEFAULTS(UserName) forKey:CHATUSERNICK];
    [extDic setValue:READUSERDEFAULTS(UserHeadImage) forKey:CHATUSRTHEADIMAGE];
    return extDic;
}

最后就是接收到之后的赋值了,在这里进行ChatViewController.m中来写,这里面又有一个方法

- (id<IMessageModel>)messageViewController:(EaseMessageViewController *)viewController  modelForMessage:(EMMessage *)message

看下面这个方法的完整代理:

#pragma mark - EaseMessageViewControllerDataSource
// 数据源方法
- (id<IMessageModel>)messageViewController:(EaseMessageViewController *)viewController
                           modelForMessage:(EMMessage *)message{
     
    id<IMessageModel> model = nil;
    // 根据聊天消息生成一个数据源Model
    //NSLog(@"-======%@",message.from);
    //debugObj(message.ext);
     
    model = [[EaseMessageModel alloc] initWithMessage:message];
    NSDictionary * messageDic = message.ext;
     
    UserInfoModel * userinfoModel = [ChatUserDataManagerHelper queryByuserEaseMobId:messageDic[CHATUSERID]];
     
    if (userinfoModel != nil) {
         
        model.nickname      = userinfoModel.usernickName;
        model.avatarURLPath = userinfoModel.userHeaderImageUrl;
    }
    // 默认头像
    //model.avatarImage = [UIImage imageNamed:@"EaseUIResource.bundle/user"];
    //Placeholder image for network error
    //项目图片取出错误的时候就用这张代替
    model.failImageName = @"icon_Default-Avatar";
    return model;
}

  其实到这里头像和昵称差不多可以了,在具体的Cell中,你不需要给它再去赋值,因为这些Demo当中已经写好了,你要一直写到这里了,你可以试试效果了!剩下的部分内容明天发出来,不然篇幅有点过长了!

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏iOS122-移动混合开发研究院

FXForms,自动生成iOS表单

1.简介 FXForms是一个简单的表单提交框架,他的作者是鼎鼎大名的 Nick Lockwood,你也许听说过他的其他的一些框架,比如 iCarousel. ...

30600
来自专栏林德熙的博客

WPF 播放 gif

本文告诉大家如何在 WPF 播放 Gif 图片,提供了几个方法进行播放,包括比较性能。

24710
来自专栏Aloys的开发之路

LaTeX内容总结

心得 Sublime + LaTeXTools 简直噩梦,决不再碰 TeX最好用的发行版就是Tex Live TeX Live可以在Linux、Windows平...

304100
来自专栏Laoqi's Linux运维专列

Mongodb 副本集安装配置

16780
来自专栏谈补锅

通知 - NSNotificationCenter

1、每一个应用程序都有一个通知中心(NSNotificationCenter)实例,专门负责协助不同对象之间的消息通信;

13140
来自专栏mukekeheart的iOS之旅

iOS学习——键盘弹出遮挡输入框问题解决方案

  在iOS或Android等移动端开发过程中,经常遇到很多需要我们输入信息的情况,例如登录时要输入账号密码、查询时要输入查询信息、注册或申请时需要填写一些信息...

57560
来自专栏一“技”之长

NSAlert组件应用总结 原

    在桌面软件开发中,当用户进行非法的操作或有风险的操作时,时长需要弹出警告框来提示用户。在OS X系统上,NSAlert是专门的警告框组件。其提供了简洁的...

12240
来自专栏Android先生

Android 9.0适配及部分新特性介绍

在最开始针对速贷进行Android9.0版本的适配时,我使用的是真机是vivo X21A,将targetSdkVersion升到28,运行发现网络请求全报400...

1.5K40
来自专栏向治洪

react-native添加redux支持

redux简介 redux是一个用于管理js应用状态的容器。redux出现时间并不是很长,在它出现之前也有类似功能的模块出现,诸如flux等等。redux设计的...

32790
来自专栏落影的专栏

iOS开发笔记(三)

前言 日常开发遇到的问题记录。 JSON Invalid type in JSON write (NSConcreteMutableData) 合法的j...

60350

扫码关注云+社区

领取腾讯云代金券