iOS —— 极光推送和极光IM

2018-12-04 本文已影响231人 Hsusue

前言

（环境：iOS12.0、极光推送SDK3.1.0、极光IM3.7.0）

写iOS 推送(苹果原生态)时，笔者就是为研究极光打下基础。

结果三个月快过去了，笔者犹如咸鱼，一直未开始研究极光，真是堕落啊。

极光推送的坑大多都是苹果原生态的推送的问题。如果你对苹果原生态推送不了解，建议先看上面笔者写的小白文章，了解原生态的苹果推送方法及调用时机。

本文主要记录一些笔者对极光IM的理解。极光推送略提，弄懂原生态，极光推送就没什么难的地方。

极光推送的初步了解

极光推送的一些小知识

设备标签(Tag)和设备别名(Alias)

一个设备只能有一个别名，但能有多个标签。所以别名可以用userId，针对一个用户；标签可以用用户所处分组，方便针对目标用户推送，针对一批用户。

笔者举一个不那么恰当的例子。假设想推送裙子消息给男性用户，那么前端就可以绑定性别到Tag。

开发环境和生产环境：

推送证书也分为开发环境和生产环境。虚拟机和真机调试属于开发环境。测试包、企业包和App Store属于生产环境。

SDK中，上线时，我们要改成生产环境。笔者建议大家弄个宏之类的，到时候别忘了切换。

image

经笔者验证，如果App不是API下载的话，即使参数改成“1”，也收不到生产环境推送。不过不用担心，开发环境和生产环境都是一样的，开发环境只是让我们调试用。

    [JPUSHService setupWithOption:launchOptions
                           appKey:@"***"
                          channel:@"Publish channel"
                 apsForProduction:isProduction
            advertisingIdentifier:nil];

IDFA

iOS 6.0+，IDFA为设备广告标示符，用于广告投放。通常不会改变，不同App获取到都是一样的。但如果用户完全重置系统（(设置程序 -> 通用 -> 还原 -> 还原位置与隐私) ，这个广告标示符会重新生成。

IDFA，同一设备下的不同app信息共享。

获取：[[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];

但是要注意审核问题。笔者不用这个就不研究了。在RegistrationID中会再说。

RegistrationID

原生是采用deviceToken来标识设备唯一性。在极光中采用RegistrationID。其生成原则优先采用IDFA（如果设备未还原IDFA，卸载App后重新下载，能被识别出老用户），次采用deviceToken。

集成了 JPush SDK 的应用程序在第一次 App 启动后，成功注册到 JPush 服务器时，JPush 服务器会给客户端返回唯一的该设备的标识 - RegistrationID。

极光推送的消息形式

通知（APNS）：手机的通知栏（状态栏）上会显示的一条通知信息。
自定义消息（应用内消息）：不会被 SDK 展示到通知栏上。自定义消息主要用于应用的内部业务逻辑。朋友圈红点就可以用这个。
本地通知：SDK集成苹果实现本地通知。

image

极光推送的实现原理

image

通过我们的App服务器或极光Web端调用极光的API能发起极光推送。

换言之，开发过程中，登录账号后，将userId（setAlias）绑定到RegistrationID。然后在iOS端发起一个网络请求到App服务器后（通过目标userId可知推送目标registrationId），由后台调用极光API。另外我们还能通过极光Web端调试,如下图。

image

（笔者的亲身体验！！！）iOS开发调试时，尽量用Web调用调用API。因为我们不知道后台的代码（如果后台在推送上也是个新手，推送环境或者推送配置字段弄错了，我们这半天也收不到推送。。。）。当然，最后还是要测试一遍发请求给后台推送正不正常。

关于自定义消息的原理。

极光采用的是长连接。所以自定义消息在网络正常、App处于前台的情况下会马上收到。

关于通知(APNs)的原理

举个例子，用户A(userIdA)发消息给用户B(userIdB)。这里只考虑两个都绑定好了deviceToken等，不存在离线消息。

在苹果原生态下的流程图。

image

在极光下的流程图。

后台服务器瘦身。

image

极光推送的使用

通知

iOS7以后的机型实现这些方法

1. - (void)jpushNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(NSInteger options))completionHandler;
2. - (void)jpushNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)())completionHandler;
3. - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler NS_AVAILABLE_IOS(7_0);
4. - (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification;

方法一：iOS10+ 点击推送调用。

方法二：iOS10+ App前台收到推送调用。

方法三：iOS10+ ，收到静默推送或者后台推送调用。

方法三：iOS7+，iOS10-，前后台收到任何远程类型推送调用。

方法四：iOS7+ ～ iOS10-，收到本地推送调用。

应用内消息

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    [defaultCenter addObserver:self
                      selector:@selector(receivePushMessage:)
                          name:kJMSGNetworkDidReceiveMessageNotification // 收到自定义消息
                        object:nil];
    
    return YES;
}

// 收到自定义消息
- (void)receivePushMessage:(NSNotification *)notification {
    NSLog(@"Event - 收到自定义消息");
    NSDictionary *info = notification.userInfo;
    if (info) {
        NSLog(@"The message - %@", info);
    } else {
        NSLog(@"Unexpected - 没有用户信息no user info in jpush mesasge");
    }
    
    // 弄个工具类处理
    // [PushUtil handleNotification:info];
    
}

极光IM

image

官方文档里，极光推送就是亲生的，IM充话费送的。

官方开发指南并不够友好，给到的信息少之又少，连基本的通讯都没说清楚，SDK Reference可读性又差。OC版示例项目也好久不更新了，笔者又需要用OC。。。网上相关的资料也难查。

笔者想要的效果是账号用App服务器账号，不额外新建一个。

下面就记录笔者的研究成果。

接口Code的定义查看官方文档，本文不处理。IM SDK ErrorCode 定义

极光IM注册

(默认用userId当IM账号密码)。

    NSString *userId = @"Hsusue1";
    [JMSGUser registerWithUsername:userId password:userId completionHandler:^(id resultObject, NSError *error) {
        NSLog(@"%@-----%@", resultObject, error);
    }];

注册成功，resultObject值为success。

如果已经注册过这个账号，回调的error会显示以下内容。

image

极光IM登录

    [JMSGUser loginWithUsername:userId password:userId completionHandler:^(id resultObject, NSError *error) {
        NSLog(@"%@-----%@", resultObject, error);
        
        // 查看自己IM的个人信息
        //JMSGUser *user = [JMSGUser myInfo];
        
    }];

补充点笔者遇到的问题和解决思路，觉得不太好，希望有大神提出更好的方法。

极光IM发送消息，如果接收方没有注册，消息会发空，并且不会保存在极光服务器。这就会造成一些问题。

因为App账号采用后台的数据（包括个人信息），不确定这个账号有没有注册过极光IM。App账号和极光IM账号是两个独立的账号。

极光IM发送消息不要求极光IM内是好友关系。

App有两种类型，一种是添加好友，另一种是企业内规定好友。

第一种就像微信，好友关系由极光IM服务器决定，添加好友后聊天，那就没有这种问题。能添加好友说明已经注册了。
另一种情况，举个例，大学教务系统规定了同学的App账号，并且同班级内的人都是好友关系。

那么这时候的好友列表就是老师和同学(App服务器的数据)，这些人不一定都注册过极光IM，发送消息就会发空。用户就会莫名其妙，明明看到通讯录有人。。。这时候就要解决这个问题了。

笔者想了很久，这种情况，注册功能由iOS端实现的话解决不了。应该由后台录入App账号进数据库时注册，才能保证好友的IM账号不是空的。

另外，后台修改密码的接口，记得顺便修改IM密码。笔者的项目中极光IM账号密码都是userId就没这需要。

IM发送消息

注意此处会发送推送和应用内消息。

    // 对方的Id
    NSString *targetId = @"hsusue";
    JMSGTextContent *textContent = [[JMSGTextContent alloc] initWithText:@"textContent"];
    JMSGMessage *message = [JMSGMessage createSingleMessageWithContent:textContent username:targetId];
    [JMSGMessage sendMessage:message];

发送的推送如下

image

发送结果回调在代理<JMessageDelegate>方法中

注意这里，是add，不是set。意味着只要实现了代理方法的target，都会调用。

- (void)viewDidLoad {
    [super viewDidLoad];
    
    // nil表示所有会话的回调都接收
    [JMessage addDelegate:self withConversation:nil];
}

- (void)onSendMessageResponse:(JMSGMessage *)message
                        error:(NSError *)error {
    NSLog(@"%@-----%@", message, error);
}

IM接收消息

也是在代理方法中（推送调用的方法此处不再介绍）。

- (void)onReceiveMessage:(JMSGMessage *)message
                   error:(NSError *)error {
    NSLog(@"%@-----%@", message, error);
}

在这里可以判断消息所属类型，笔者发送了文本消息测试。

image

下载媒体文件失败的回调。

- (void)onReceiveMessageDownloadFailed:(JMSGMessage *)message;

最近联系人列表和聊天记录

极光IM，App本地保存了各个账号的最近联系人列表和聊天记录。

SDK中JMSGConversation包含了一堆有用的信息。

这里只列出部分。

获取会话及其他操作

/*!
 * @abstract 获取单聊会话
 *
 * @param username 单聊对象 username
 *
 * @discussion 如果会话还不存在，则返回 nil
 */
+ (JMSGConversation * JMSG_NULLABLE)singleConversationWithUsername:(NSString *)username;

/*!
 * @abstract 删除单聊会话
 *
 * @param username 单聊用户名
 *
 * @discussion 除了删除会话本身，还会删除该会话下所有的聊天消息。
 */
+ (BOOL)deleteSingleConversationWithUsername:(NSString *)username;

/*!
 * @abstract 返回 conversation 列表（异步,已排序）
 *
 * @param handler 结果回调。正常返回时 resultObject 的类型为 NSArray，数组里成员的类型为 JMSGConversation
 *
 * @discussion 当前是返回所有的 conversation 列表，不包括聊天室会话，默认是已经排序。
 */
+ (void)allConversations:(JMSGCompletionHandler)handler;

/*!
 * @abstract 获取当前所有会话的未读消息的总数
 *
 * @discussion 获取所有会话未读消息总数，开启免打扰的会话未读数不会加入计数
 */
+ (NSNumber *)getAllUnreadCount;

/*!
 * @abstract 同步分页获取最新的消息
 *
 * @param offset 开始的位置。nil 表示从最初开始。
 * @param limit 获取的数量。nil 表示不限。
 *
 * @return 返回消息列表（数组）。数组成员的类型是 JMSGMessage*
 *
 * @discussion 排序规则是：最新
 *
 * 参数举例：
 *
 * - offset = nil, limit = nil，表示获取全部。相当于 allMessages。
 * - offset = nil, limit = 100，表示从最新开始取 100 条记录。
 * - offset = 100, limit = nil，表示从最新第 100 条开始，获取余下所有记录。
 */
- (NSArray JMSG_GENERIC(__kindof JMSGMessage *) *)messageArrayFromNewestWithOffset:(NSNumber *JMSG_NULLABLE)offset limit:(NSNumber *JMSG_NULLABLE)limit;

会话对象的属性。

/*!
 * @abstract 会话标题
 */
@property(nonatomic, strong, readonly) NSString * JMSG_NULLABLE title;

/*!
 * @abstract 最后一条消息
 */
@property(nonatomic, strong, readonly) JMSGMessage * JMSG_NULLABLE latestMessage;

/*!
 * @abstract 会话最近一条消息的创建时间
 *
 * @discussion 可用于会话排序，单位为毫秒
 */
@property(nonatomic, strong, readonly) NSNumber *latestMsgTime;

/*!
 * @abstract 未读数
 * @discussion 有新消息来时, SDK 会对未读数自动加 1
 */
@property(nonatomic, strong, readonly) NSNumber * JMSG_NULLABLE unreadCount;


///--------------------------------------------------------
/// @name Conversation Extend Properties 会话扩展属性：用于聊天
///--------------------------------------------------------

/*!
 * @abstract 会话类型 - 单聊，群聊，聊天室
 * @discussion 详细定义见 JMSGConversationType
 */
@property(nonatomic, assign, readonly) JMSGConversationType conversationType;

/*!
 * @abstract 聊天对象
 *
 * @discussion 需要根据会话类型转型。单聊时转型为 JMSGUser，群聊时转型为 JMSGGroup，聊天时转型为 JMSGChatRoom
 *
 *    注意: 在会话列表上, 请不要使用此属性, 否则有性能问题. 只在进入聊天界面(单个会话) 时使用此属性.
 *
 * 进入会话(聊天界面)后, 访问会话对象的各种信息, 包括群聊的群组成员, 都应使用此属性,
 * 而没有必要再通过接口查询 UserInfo / GroupInfo / ChatRoomInfo.
 */
@property(nonatomic, strong, readonly) id target;

/*!
 * @abstract 会话目标用户所在的 appKey
 *
 * @discussion 这是为了跨应用聊天而新增的一个字段.
 * 如果此字段为空, 则表示为默认的主应用.
 *
 * 单聊会话时, 如果单聊对象用户不属于主应用, 则此字段会有值.
 *
 */
@property(nonatomic, strong, readonly) NSString *targetAppKey;

看完这些能基本掌握它们的原理，但在推送和UI层上仍存在不少难度。

比如，消息发送失败在聊天界面展示红色的感叹号这个功能。在* iOS 极光IM 集成之旅有探讨。

极光也推出了IMUI，github地址：Aurora IMUI

iOS —— 极光推送和极光IM

前言

极光推送的初步了解

极光推送的一些小知识

极光推送的消息形式

极光推送的实现原理

极光推送的使用

通知

应用内消息

极光IM

极光IM注册

极光IM登录

IM发送消息

IM接收消息

最近联系人列表和聊天记录

猜你喜欢

热点阅读

iOS —— 极光推送和极光IM

前言

极光推送的初步了解

极光推送的一些小知识

极光推送的消息形式

极光推送的实现原理

极光推送的使用

通知

应用内消息

极光IM

极光IM注册

极光IM登录

IM发送消息

IM接收消息

最近联系人列表 和 聊天记录

猜你喜欢

热点阅读

最近联系人列表和聊天记录