IM即时通讯

收发消息

接收消息

接收消息需要先设置消息回调监听对象,开发者可通过添加消息监听对象来接收消息,所有的IM消息都通过该通知接收,这里我们只举例接收新消息接口onRecvNewMsg,更多通知函数请参考CRIMAdvancedMsgListener

  • 调用接口:
// 接收消息前设置消息监听对象
[CRIMManager.callbacker addAdvancedMsgListener:obj];
  • 回调接口:
// 收到新消息
- (void)onRecvNewMsg:(CRIMMessageInfo *)msg {
 // 收到消息后,根据消息类型contentType进行UI展示
}

相关API请参考:

发送消息

发送消息需要先构造消息实例,支持构造的消息类型有普通文本、图片、视频、文件、音频、地理位置、引用、转发、@xxx等消息,构造完消息后调用SDK的发送接口即可完成消息的发送

创建文本消息

  • 调用接口:
CRIMMessageInfo *message = [CRIMMessageInfo createTextMsg:@"这是一条文本消息"];

相关API请参考:

创建多媒体消息

多媒体消息支持的媒体类型包括图片、视频、语音、文件。
我们提供了两种方式发送多媒体消息,一种是SDK上传文件,一种是发送方自行上传,这里我们以图片消息为例分别说明。

SDK上传文件

发送方调用发送消息接口后,SDK内部会负责把文件上传到IM系统OSS存放,接收方收到消息后自行下载。
  • 调用接口:
CRIMMessageInfo *message = [CRIMMessageInfo createImageMsgFromFullPath:@"文件绝对路径"];

发送方自行上传

发送方可以调用uploadFile接口把文件上传到IM系统OSS,也可以自己把文件上传到第三方存储,创建消息时把文件的下载URL传给SDK,接收方收到消息后用URL自行下载。
  • 调用接口:
CRIMPictureInfo *source = [CRIMPictureInfo new];
source.size = 512;
source.width = 320;
source.height = 320;
source.url = @"https://xxxxxxxxxxxx";

CRIMPictureInfo *big = [CRIMPictureInfo new];
big.size = 512;
big.width = 320;
big.height = 320;
big.url = @"https://xxxxxxxxxxxx";

CRIMPictureInfo *snapshot = [CRIMPictureInfo new];
snapshot.size = 512;
snapshot.width = 120;
snapshot.height = 120;
snapshot.url = @"https://xxxxxxxxxxxx";

CRIMMessageInfo *message = [CRIMMessageInfo createImageMsgByURL:source                                                                    bigPicture:big 
                                                snapshotPicture:snapshot];

相关API请参考:

创建位置消息

创建位置消息需要开发者采集到经纬度参数

  • 调用接口:
CRIMMessageInfo *message = [CRIMMessageInfo createLocationMsg:@"位置描述" 
                                                    longitude:@"经度" 
                                                     latitude:@"纬度"];

相关API请参考:

创建自定义消息

创建自定义消息的消息内容需要使用json字符串

  • 调用接口:
CRIMMessageInfo *message = [CRIMMessageInfo createCustomMsg:@"json字符串" 
                                                  extension:@"扩展" 
                                                description:@"描述"];

相关API请参考:

发送消息

用于所有IM消息的发送

  • 调用接口:
CRIMMessageInfo *message = [CRIMMessageInfo createTextMsg:[@"测试消息" stringByAppendingFormat:@"%d", arc4random() % 1000]];
                
[CRIMManager.manager sendMsg:message
         recvID:otherUserID
        groupID:groupID
offlinePushInfo:nil
      onSuccess:^(CRIMMessageInfo * _Nullable message) {
// 进度回调,可进行UI展示

} onProgress:^(NSInteger number) {
  NSLog(@"progress:%zd", number);
} onFailure:^(NSInteger code, NSString * _Nullable msg) {

}];

相关API请参考: