网站首页 > 厂商资讯 > 环信 >

iOS环信SDK使用教程详细解析

一、环信SDK简介

环信是一款基于云服务的即时通讯（IM）平台，提供IM、音视频通话、实时直播、消息推送等功能。环信SDK是环信平台提供的一套用于iOS开发的API接口，开发者可以通过集成环信SDK，轻松实现IM功能。

二、环信SDK集成

下载环信SDK

首先，在环信官网（https://www.rongcloud.cn/）注册账号并登录，然后在开发者中心下载环信SDK。下载完成后，解压得到环信SDK文件夹。

添加环信SDK到项目中

将解压后的环信SDK文件夹中的RongCloud文件夹拖拽到Xcode项目中，并将RongCloud文件夹设置为当前target的Copy items if needed属性。

添加依赖库

在Xcode项目中，添加以下依赖库：

libsqlite3.0.tbd
libz.1.2.5.tbd
libssl.1.0.0.tbd
libcrypto.1.0.0.tbd
CoreTelephony.framework
CoreGraphics.framework
CoreFoundation.framework
UIKit.framework
Foundation.framework
SystemConfiguration.framework
Security.framework
CoreLocation.framework
AVFoundation.framework
MobileCoreServices.framework
CoreMedia.framework
AudioToolbox.framework
CoreAudio.framework
CoreTelephony.framework

添加权限

在Info.plist文件中添加以下权限：

NSAppTransportSecurity
- NSAllowsArbitraryLoads：允许任意加载，用于测试阶段
NSLocationWhenInUseUsageDescription
NSLocationAlwaysUsageDescription
NSLocationAlwaysAndWhenInUseUsageDescription
NSPhotoLibraryUsageDescription
NSCameraUsageDescription

三、环信SDK初始化

创建环信IMClient实例

在项目中创建一个环信IMClient实例，用于管理环信SDK。

// 创建环信IMClient实例

self.imClient = [IMClient sharedInstance];

设置环信SDK配置

在环信SDK配置中，设置AppKey和AppSecret，用于身份验证。

// 设置环信SDK配置

self.imClient.setAppKey(@"your app key");

self.imClient.setAppSecret(@"your app secret");

设置环信SDK监听器

创建一个环信SDK监听器，用于接收IM事件。

// 创建环信SDK监听器

self.imClient.setListener(self);

登录环信服务器

使用环信账号登录服务器。

// 登录环信服务器

[self.imClient login:@"your userId" token:@"your token" success:^(RCIMClient *client) {

    // 登录成功

} fail:^(RCErrorCode code, NSString *desc) {

    // 登录失败

}];

四、环信SDK功能使用

发送文本消息

// 创建消息对象

RCMessage *message = [[RCMessage alloc] initWithConversationType:RCConversationTypeChat userId:@"target userId" content:nil extra:nil];



// 设置消息内容

RCTextMessage *textMessage = [[RCTextMessage alloc] initWithContent:@"Hello, RongCloud!"];

message.content = textMessage;



// 发送消息

[self.imClient sendMessage:message success:^(RCMessage *message) {

    // 发送成功

} fail:^(RCErrorCode code, NSString *desc) {

    // 发送失败

}];

发送图片消息

// 创建消息对象

RCMessage *message = [[RCMessage alloc] initWithConversationType:RCConversationTypeChat userId:@"target userId" content:nil extra:nil];



// 设置消息内容

RCImageMessage *imageMessage = [[RCImageMessage alloc] initWithImage:nil imageUri:@"image path"];

message.content = imageMessage;



// 发送消息

[self.imClient sendMessage:message success:^(RCMessage *message) {

    // 发送成功

} fail:^(RCErrorCode code, NSString *desc) {

    // 发送失败

}];

发送语音消息

// 创建消息对象

RCMessage *message = [[RCMessage alloc] initWithConversationType:RCConversationTypeChat userId:@"target userId" content:nil extra:nil];



// 设置消息内容

RCVoiceMessage *voiceMessage = [[RCVoiceMessage alloc] initWithVoiceUri:@"voice path"];

message.content = voiceMessage;



// 发送消息

[self.imClient sendMessage:message success:^(RCMessage *message) {

    // 发送成功

} fail:^(RCErrorCode code, NSString *desc) {

    // 发送失败

}];

发送视频消息

// 创建消息对象

RCMessage *message = [[RCMessage alloc] initWithConversationType:RCConversationTypeChat userId:@"target userId" content:nil extra:nil];



// 设置消息内容

RCVideoMessage *videoMessage = [[RCVideoMessage alloc] initWithVideoUri:@"video path"];

message.content = videoMessage;



// 发送消息

[self.imClient sendMessage:message success:^(RCMessage *message) {

    // 发送成功

} fail:^(RCErrorCode code, NSString *desc) {

    // 发送失败

}];

添加好友

// 添加好友

[self.imClient addFriend:@"target userId" name:@"target name" success:^(RCContact *contact) {

    // 添加成功

} fail:^(RCErrorCode code, NSString *desc) {

    // 添加失败

}];

添加黑名单

// 添加黑名单

[self.imClient addToBlackList:@"target userId" success:^(RCContact *contact) {

    // 添加成功

} fail:^(RCErrorCode code, NSString *desc) {

    // 添加失败

}];

添加群组

// 创建群组

RCGroup *group = [[RCGroup alloc] initWithId:@"group id" name:@"group name" description:nil];



// 添加群成员

[self.imClient addGroupMember:group userId:@"target userId" success:^(RCGroup *group) {

    // 添加成功

} fail:^(RCErrorCode code, NSString *desc) {

    // 添加失败

}];

五、总结

本文详细解析了iOS环信SDK的使用方法，包括集成、初始化、功能使用等。通过本文的学习，开发者可以轻松实现IM功能，提高应用的用户体验。在开发过程中，如遇到问题，可以参考环信官方文档（https://www.rongcloud.cn/docs/server/im/server_v2/）或加入环信开发者社区（https://www.rongcloud.cn/dev/）寻求帮助。