最近项目中用到环信(项目中使用的是没有音视频的SDK),这边就从导入SDK、引入依赖库后开始说起,网上找了些资料都是复制粘贴或者是比较早的,现在说说3.3.4的版本的一些使用。
注意:导入的SDK framework的status不需要设置为optional,如果不添加Embedded Binaries,单独修改status为optional可以解决报image no found的错误。集成后你会发现发送消息的时候messgae = nil,这个问题只需要添加一下Embedded Binaries,如果把两个 framework的status设置为optional运行、发消息都是OK的,上架的时候会出现问题上传到苹果后二进制文件无效。so,对导入SDK的设置为:添加Embedded Binaries,不需要修改它framework的status。
导入的SDK以及设置Embedded Binaries后的截图:
1、项目导入相关第三方
如果自己的项目中已经有引用MBProgressHUD、SDWebImage(这个环信藏的比较深,也改成它自身的EMSDWebImage)、MJRefresh需要在环信的EMUIKit文件夹中找到并删除,如果没有删除环信的EMSDWebImage在设置pch文件#ifdefOBJC#endif之后会五个错误。再删除掉EMSDWebImage会报好几个错误,因为环信修改了里面的一些方法,为了更方便环信那边的使用,只需要找到对应的错误改回原本SD的方法就可以了。
2、初始化(在AppDelegate.m文件中)
//注册环信SDK
EMOptions *options = [EMOptions optionsWithAppkey:EMkey];
options.apnsCertName = apnsCertName;
//初始化SDK
[[EMClient sharedClient] initializeSDKWithOptions:options];
//配置IM的UI key
[[EaseSDKHelper shareHelper] hyphenateApplication:application didFinishLaunchingWithOptions:launchOptions appkey:EMkey apnsCertName:apnsCertName otherConfig:@{kSDKConfigEnableConsoleLogger:[NSNumber numberWithBool:YES]}];
3、登录
EMError *error = [[EMClient sharedClient] loginWithUsername:hxName password:hxPsw];
if (!error) {
//登录成功后的操作
}
登录成功后,如果要设置自动登录代码如下:
[[EMClient sharedClient].options setIsAutoLogin:YES];
4、调起单聊界面
// CustomChatController继承EaseUI的EaseMessageViewController,如果不继承也行,直接调用EaseMessageViewController
CustomChatController * chatC = [[CustomChatController alloc] initWithConversationChatter:to conversationType:EMConversationTypeChat];
[self.navigationController pushViewController:chatC animated:YES];
5、消息推送
消息推送,环信后台添加证书已经制作推送证书这些就不细说了,只说一点:环信后台添加推送证书的时候需要输入应用包名,应用包名是项目的Bundle Identifier而不是应用程序名。注册代码如下:
//注册推送
EMPushOptions * pushOptions = [[EMClient sharedClient] pushOptions];
pushOptions.displayStyle = EMPushDisplayStyleMessageSummary;
[pushOptions setNoDisturbStatus:EMPushNoDisturbStatusClose];
//iOS10 注册APNs
if (NSClassFromString(@"UNUserNotificationCenter")) {
[[UNUserNotificationCenter currentNotificationCenter] requestAuthorizationWithOptions:UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert completionHandler:^(BOOL granted, NSError *error) {
if (granted) {
#if !TARGET_IPHONE_SIMULATOR
[application registerForRemoteNotifications];
#endif
}
}];
return;
}
if([application respondsToSelector:@selector(registerUserNotificationSettings:)])
{
UIUserNotificationType notificationTypes = UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert;
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:notificationTypes categories:nil];
[application registerUserNotificationSettings:settings];
}
实现注册APNS回调:
//注册token
- (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
//环信注册 Device Token
[[EMClient sharedClient] bindDeviceToken:deviceToken];
}
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
//Optional
NSLog(@"did Fail To Register For Remote Notifications With Error: %@", error);
}
//ios 10 之后回调
-(void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler{
NSLog(@"Userinfo %@",notification.request.content.userInfo);
//功能:可设置是否在应用内弹出通知
completionHandler(UNNotificationPresentationOptionAlert);}
-(void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)())completionHandler{
NSLog(@"Userinfo %@",response.notification.request.content.userInfo);
//消息点击回调
}
//iOS 10 之前回调
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
{
//消息通知点击回调
}
消息推送过来后要显示消息详情需要设置它的推送昵称,并且更新到服务器(环信的服务器):
[[EMClient sharedClient] setApnsNickname:response[@"nickname"]];
dispatch_async(dispatch_get_global_queue(0, 0), ^{
[[EMClient sharedClient] updatePushOptionsToServer];
});
6、消息扩展(用于昵称、头像)(也可以操作环信本地数据库来实现)
自己的昵称、头像可以存储本地,在登录的时候存储、修改的时候更新存储,对方的头像可以从自己的服务器后台获取到相应的数据。
到环信UI的EaseMessageViewController控制器中,在环信的
- (void)sendTextMessage:(NSString *)text;
- (void)sendTextMessage:(NSString *)text withExt:(NSDictionary*)ext;
- (void)sendLocationMessageLatitude:(double)latitude longitude:(double)longitude andAddress:(NSString *)address;
- (void)sendImageMessageWithData:(NSData *)imageData;
- (void)sendImageMessage:(UIImage *)image
- (void)sendVoiceMessageWithLocalPath:(NSString *)localPath duration:(NSInteger)duration
- (void)sendVideoMessageWithURL:(NSURL *)url
这些方法中添加上需要扩展的消息,自己的头像、昵称以及对方的头像、昵称,例如:
- (void)sendTextMessage:(NSString *)text
{
//消息扩展ext
NSDictionary *ext = @{@"fromNickname":_fromNickName,@"fromAvatar":_fromAvatar,@"toNickname":_toNickName,@"toAvatar":_toAvatar};
if (self.conversation.type == EMConversationTypeGroupChat) {
NSArray *targets = [self _searchAtTargets:text];
if ([targets count]) {
__block BOOL atAll = NO;
[targets enumerateObjectsUsingBlock:^(NSString *target, NSUInteger idx, BOOL *stop) {
if ([target compare:kGroupMessageAtAll options:NSCaseInsensitiveSearch] == NSOrderedSame) {
atAll = YES;
*stop = YES;
}
}];
if (atAll) {
ext = @{kGroupMessageAtList: kGroupMessageAtAll};
}
else {
ext = @{kGroupMessageAtList: targets};
}
}
}
[self sendTextMessage:text withExt:ext];
}
在聊天列表中获取对应的扩展消息:
idmodel = IMModel;
NSDictionary * ext = model.conversation.lastReceivedMessage.ext;
7、上架
由于 iOS 编译的特殊性,为了方便开发者使用,我们将 i386 x86_64 armv7 arm64 几个平台都合并到了一起,所以使用动态库上传appstore时需要将i386 x86_64两个平台删除后,才能正常提交审核
在SDK当前路径下执行以下命令删除i386 x86_64两个平台
实时音视频版本Hyphenate.framework
lipo Hyphenate.framework/Hyphenate -thin armv7 -output Hyphenate_armv7
lipo Hyphenate.framework/Hyphenate -thin arm64 -output Hyphenate_arm64
lipo -create Hyphenate_armv7 Hyphenate_arm64 -output Hyphenate
mv Hyphenate Hyphenate.framework/
不包含实时音视频版本HyphenateLite.framework
lipo HyphenateLite.framework/HyphenateLite -thin armv7 -output HyphenateLite_armv7
lipo HyphenateLite.framework/HyphenateLite -thin arm64 -output HyphenateLite_arm64
lipo -create HyphenateLite_armv7 HyphenateLite_arm64 -output HyphenateLite
mv HyphenateLite HyphenateLite.framework/
具体操作:把环信demo里面的HyphenateSDK(实时音视频版本:HyphenateFullSDK)的文件夹拖到桌面(或者随意位置)然后打开终端 cd + 文件夹路径(把文件夹路径直接拉进终端)。然后执行以上命令,完成后文件夹中会多出两个文件:HyphenateLite_arm64、HyphenateLite_armv7这样就分离成功,然后直接把HyphenateLite.framework拖进工程,不是把整个文件夹拖进工程!!!运行只能用真机,不支持模拟器,可以自己替换回来,上架的时候再替换。
主要就这些吧,别的细的一些东东就不一一说明了。