目录

引入静态库

正常情况下需要引入MMCSDK和ProtocolBufferSDK两个静态库，但是若你的项目中也用到了ProtocolBuffer，为避免冲突，在项目中可以不引入MIMC提供的ProtocolBufferSDK静态库。

用户初始化

参考 安全认证 ，初始化NSMutableURLRequest和parseToken

  1. (1)创建访问AppProxyService服务的URLRequest，作为参数传入MCUser的初始化方法中，见(3):
  2. NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
  3. NSMutableDictionary *dicObj = [[NSMutableDictionary alloc] init];
  4. ...
  5. NSData *dicData = [NSJSONSerialization dataWithJSONObject:dicObj options:NSJSONWritingPrettyPrinted error:nil];
  6. [request setHTTPMethod:@"POST"];
  7. [request setHTTPBody:dicData];
  9. (2)实现协议:
  10. /**
  11.  * @param proxyResult: AppProxyService返回结果
  12.  * @result: TokenService(MIMC)返回结果
  13.  **/
  14. @protocol parseTokenDelegate <NSObject>
  15. - (NSString *)parseToken:(NSData *)proxyResult;
  16. @end
  18. (3)创建user并初始化:
  19. MCUser *user = [[MCUser alloc] initWithAppAccount:appAccount andRequest:request];

登录

  1. [user login];

在线状态变化回调

  1. /**
  2.  * @param[user]: 在线状态发生变化的用户
  3.  * @param[status]: 1 在线，0 不在线
  4.  * @param[errType]: 登录失败类型
  5.  * @param[errReason]: 登录失败原因
  6.  * @param[errDescription]: 登录失败原因描述
  7.  **/
  8. @protocol onlineStatusDelegate <NSObject>
  9. - (void)statusChange:(MCUser *)user status:(int)status errType:(NSString *)errType errReason:(NSString *)errReason errDescription:(NSString *)errDescription;
  10. @end

发送单聊消息

  1. /**
  2.  * @param[toAppAccount] NSString: 消息接收者在APP帐号系统内的帐号
  3.  * @param[msg] NSData: 开发者自定义消息体
  4.  * @param[isStore] Boolean: 消息是否存储在mimc服务端，true 存储, false 不存储, 默认存储。
  5.  * @return: 客户端生成的消息ID
  6.  **/
  7. NSString packetId = [user sendMessage:toAppAccount msg:data];
  8. NSString packetId = [user sendMessage:toAppAccount msg:data isStore:isStore];

发送群聊消息

  1. /**
  2.  * @param[topicId] int64_t: 接收消息的群ID
  3.  * @param[msg] NSData: 开发者自定义消息体
  4.  * @param[isStore] Boolean: 消息是否存储在mimc服务端，true 存储, false 不存储, 默认存储。
  5.  * @return: 客户端生成的消息ID
  6.  **/
  7. NSString packetId = [user sendGroupMessage:topicId msg:data];
  8. NSString packetId = [user sendGroupMessage:topicId msg:data isStore:isStore];

接收消息回调

  1. @protocol handleMessageDelegate <NSObject>
  2. /**
  3.  * @param[packets]: 单聊消息集
  4.  * @note: MIMCMessage 单聊消息
  5.  *   MIMCMessage.packetId: 消息ID
  6.  *   MIMCMessage.sequence: 序列号
  7.  *   MIMCMessage.fromAccount: 发送方帐号
  8.  *   MIMCMessage.toAccount: 接收方帐号
  9.  *   MIMCMessage.payload: 消息体
  10.  *   MIMCMessage.timestamp: 时间戳
  11.  **/
  12. - (void)handleMessage:(NSArray<MIMCMessage*> *)packets user:(MCUser *)user;
  14. /**
  15.  * @param[packets]: 群聊消息集
  16.  * @note: MIMCGroupMessage 群聊消息
  17.  *   MIMCGroupMessage.packetId: 消息ID
  18.  *   MIMCGroupMessage.groupId: 群ID
  19.  *   MIMCGroupMessage.sequence: 序列号
  20.  *   MIMCGroupMessage.fromAccount: 发送方帐号
  21.  *   MIMCGroupMessage.payload: 消息体
  22.  *   MIMCGroupMessage.timestamp: 时间戳
  23.  **/
  24. - (void)handleGroupMessage:(NSArray<MIMCGroupMessage*> *)packets;
  26. /**
  27.  * @param[serverAck]: 服务器返回的serverAck对象
  28.  *        serverAck.packetId: 客户端生成的消息ID
  29.  *        serverAck.timestamp: 消息发送到服务器的时间(单位:ms)
  30.  *        serverAck.sequence: 服务器为消息分配的递增ID，单用户空间内递增唯一，可用于去重/排序
  31.  **/
  32. - (void)handleServerAck:(NSString *)packetId sequence:(int64_t)sequence timestamp:(int64_t)timestamp;
  34. /**
  35.  * @param[message]: 发送超时的单聊消息
  36.  **/
  37. - (void)handleSendMessageTimeout:(MIMCMessage *)message;
  39. /**
  40.  * @param[groupMessage]: 发送超时的群聊消息
  41.  **/
  42. - (void)handleSendGroupMessageTimeout:(MIMCGroupMessage *)groupMessage;
  43. @end

注销

  1. [user logout];

回到顶部