#import <RongIMLib/RongIMLib.h>

	[[RCIMClient sharedRCIMClient] initWithAppKey:@"YourTestAppKey"];

	// RCIMClient Class
	
	/*!
	 与融云服务器建立连接
	
	 @param token                   从您服务器端获取的 token(用户身份令牌)
	 @param successBlock            连接建立成功的回调
	 [userId:当前连接成功所用的用户 ID]
	 @param errorBlock              连接建立失败的回调 [status:连接失败的错误码]
	 @param tokenIncorrectBlock     token 错误或者过期的回调
	
	 @discussion 在 App 整个生命周期，您只需要调用一次此方法与融云服务器建立连接。
	 之后无论是网络出现异常或者 App 有前后台的切换等，SDK 都会负责自动重连。
	 除非您已经手动将连接断开，否则您不需要自己再手动重连。
	
	 tokenIncorrectBlock 有两种情况：
	 一是 token 错误，请您检查客户端初始化使用的 AppKey 和您服务器获取 token 使用的 AppKey 是否一致；
	 二是 token 过期，是因为您在开发者后台设置了 token 过期时间，您需要请求您的服务器重新获取token 并再次用新的 token 建立连接。
	
	 @warning 如果您使用 IMLib，请使用此方法建立与融云服务器的连接；
	 如果您使用 IMKit，请使用 RCIM 中的同名方法建立与融云服务器的连接，而不要使用此方法。
	
	 在 tokenIncorrectBlock 的情况下，您需要请求您的服务器重新获取 token 并建立连接，但是注意避免无限循环，以免影响 App 用户体验。
	
	 此方法的回调并非为原调用线程，您如果需要进行 UI 操作，请注意切换到主线程。
	 */
	- (void)connectWithToken:(NSString *)token
	                 success:(void (^)(NSString *userId))successBlock
	                   error:(void (^)(RCConnectErrorCode status))errorBlock
	          tokenIncorrect:(void (^)())tokenIncorrectBlock;

	// RCIMClient Class
	
	/*!
	 加入聊天室（如果聊天室不存在则会创建）
	
	 @param targetId                聊天室 ID
	 @param messageCount 进入聊天室时获取历史消息的数量，-1<=messageCount<=50
	 @param successBlock            加入聊天室成功的回调
	 @param errorBlock              加入聊天室失败的回调
	 [status:加入聊天室失败的错误码]
	
	 @discussion
	 可以通过传入的 messageCount 设置加入聊天室成功之后，需要获取的历史消息数量。
	 -1 表示不获取任何历史消息，0 表示不特殊设置而使用 SDK 默认的设置（默认为获取 10 条），0<messageCount<=50 为具体获取的消息数量,最大值为 50。
	 */
	- (void)joinChatRoom:(NSString *)targetId
	        messageCount:(int)messageCount
	             success:(void (^)())successBlock
	               error:(void (^)(RCErrorCode status))errorBlock;
	
	/*!
	 加入已经存在的聊天室（如果不存在或超限会返回聊天室不存在错误 23410 或 人数超限
	 23411）
	
	 @param targetId                聊天室 ID
	 @param messageCount 进入聊天室时获取历史消息的数量，-1<=messageCount<=50
	 @param successBlock            加入聊天室成功的回调
	 @param errorBlock              加入聊天室失败的回调
	 [status:加入聊天室失败的错误码]
	
	 @warning
	 注意：使用 Kit 库的会话页面 viewDidLoad 会自动调用 joinChatRoom 加入聊天室（聊天室不存在会自动创建），
	 如果您只想加入已存在的聊天室，需要在 push 到会话页面之前调用这个方法并且 messageCount
	 传 -1，成功之后 push 到会话页面，失败需要您做相应提示处理
	
	 @discussion
	 可以通过传入的 messageCount 设置加入聊天室成功之后，需要获取的历史消息数量。
	 -1 表示不获取任何历史消息，0 表示不特殊设置而使用 SDK 默认的设置（默认为获取 10 条），0<messageCount<=50 为具体获取的消息数量,最大值为 50。
	 */
	- (void)joinExistChatRoom:(NSString *)targetId
	             messageCount:(int)messageCount
	                  success:(void (^)())successBlock
	                    error:(void (^)(RCErrorCode status))errorBlock;

	// RCIMClient Class
	
	/*!
	 退出聊天室
	
	 @param targetId                聊天室 ID
	 @param successBlock            退出聊天室成功的回调
	 @param errorBlock              退出聊天室失败的回调
	 [status:退出聊天室失败的错误码]
	 */
	- (void)quitChatRoom:(NSString *)targetId
	             success:(void (^)())successBlock
	               error:(void (^)(RCErrorCode status))errorBlock;

	// RCIMClient Class
	
	/*!
	 发送消息
	
	 @param conversationType    发送消息的会话类型
	 @param targetId            发送消息的目标会话 ID
	 @param content             消息的内容
	 @param pushContent         接收方离线时需要显示的远程推送内容
	 @param pushData            接收方离线时需要在远程推送中携带的非显示数据
	 @param successBlock        消息发送成功的回调 [messageId:消息的 ID]
	 @param errorBlock          消息发送失败的回调 [nErrorCode:发送失败的错误码,
	 messageId:消息的 ID]
	 @return                    发送的消息实体
	
	 @discussion 当接收方离线并允许远程推送时，会收到远程推送。
	 远程推送中包含两部分内容，一是 pushContent，用于显示；二是 pushData，用于携带不显示的数据。
	
	 SDK 内置的消息类型，如果您将 pushContent 和 pushData 置为 nil，会使用默认的推送格式进行远程推送。
	 自定义类型的消息，需要您自己设置 pushContent 和 pushData 来定义推送内容，否则将不会进行远程推送。
	
	 如果您使用此方法发送图片消息，需要您自己实现图片的上传，构建一个 RCImageMessage 对象，
	 并将 RCImageMessage 中的 imageUrl 字段设置为上传成功的 URL 地址，然后使用此方法发送。
	
	 @warning 如果您使用 IMLib，可以使用此方法发送消息；
	 如果您使用 IMKit，请使用 RCIM 中的同名方法发送消息，否则不会自动更新 UI。
	 */
	- (RCMessage *)sendMessage:(RCConversationType)conversationType
	                  targetId:(NSString *)targetId
	                   content:(RCMessageContent *)content
	               pushContent:(NSString *)pushContent
	                  pushData:(NSString *)pushData
	                   success:(void (^)(long messageId))successBlock
	                     error:(void (^)(RCErrorCode nErrorCode,
	                                     long messageId))errorBlock;

	// RCIMClient Class
	
	/*!
	 发送图片消息
	
	 @param conversationType    发送消息的会话类型
	 @param targetId            发送消息的目标会话 ID
	 @param content             消息的内容
	 @param pushContent         接收方离线时需要显示的远程推送内容
	 @param pushData            接收方离线时需要在远程推送中携带的非显示数据
	 @param progressBlock       消息发送进度更新的回调 [progress:当前的发送进度, 0
	 <= progress <= 100, messageId:消息的 ID]
	 @param successBlock        消息发送成功的回调 [messageId:消息的 ID]
	 @param errorBlock          消息发送失败的回调 [errorCode:发送失败的错误码,
	 messageId:消息的 ID]
	 @return                    发送的消息实体
	
	 @discussion 当接收方离线并允许远程推送时，会收到远程推送。
	 远程推送中包含两部分内容，一是 pushContent，用于显示；二是 pushData，用于携带不显示的数据。
	
	 SDK内置的消息类型，如果您将 pushContent 和 pushData 置为 nil，会使用默认的推送格式进行远程推送。
	 自定义类型的消息，需要您自己设置 pushContent 和 pushData 来定义推送内容，否则将不会进行远程推送。
	
	 如果您需要上传图片到自己的服务器，构建一个 RCImageMessage 对象，
	 并将 RCImageMessage 中的 imageUrl 字段设置为上传成功的 URL 地址，然后使用 RCIMClient 的 sendMessage:targetId:content:pushContent:pushData:success:error:方法或 sendMessage:targetId:content:pushContent:success:error:方法进行发送，不要使用此方法。
	
	 @warning 如果您使用 IMKit，使用此方法发送图片消息 SDK 会自动更新 UI；
	 如果您使用 IMLib，请使用 RCIMClient 中的同名方法发送图片消息，不会自动更新 UI。
	 */
	- (RCMessage *)
	sendImageMessage:(RCConversationType)conversationType
	        targetId:(NSString *)targetId
	         content:(RCMessageContent *)content
	     pushContent:(NSString *)pushContent
	        pushData:(NSString *)pushData
	        progress:(void (^)(int progress, long messageId))progressBlock
	         success:(void (^)(long messageId))successBlock
	           error:(void (^)(RCErrorCode errorCode, long messageId))errorBlock;

	// RCIMClient Class
	
	/*!
	 设置IMlib的消息接收监听器
	
	 @param delegate    IMLib 消息接收监听器
	 @param userData    用户自定义的监听器 Key 值，可以为 nil
	
	 @discussion
	 设置 IMLib 的消息接收监听器请参考 RCIMClient的setReceiveMessageDelegate:object:方法。
	
	 userData 为您自定义的任意数据，SDK 会在回调的 onReceived:left:object:方法中传入作为 object 参数。
	 您如果有设置多个监听，会只有最终的一个监听器起作用，您可以通过该 userData 值区分您设置的监听器。如果不需要直接设置为 nil 就可以。
	
	 @warning 如果您使用 IMlib，可以设置并实现此 Delegate 监听消息接收；
	 如果您使用 IMKit，请使用 RCIM 中的 receiveMessageDelegate 监听消息接收，而不要使用此方法，否则会导致 IMKit 中无法自动更新 UI！
	 */
	- (void)setReceiveMessageDelegate:(id<RCIMClientReceiveMessageDelegate>)delegate
	                           object:(id)userData;
	
	/*!
	 IMlib 消息接收的监听器
	
	 @discussion
	 设置 IMLib 的消息接收监听器请参考 RCIMClient的setReceiveMessageDelegate:object:方法。
	
	 @warning 如果您使用 IMlib，可以设置并实现此 Delegate 监听消息接收；
	 如果您使用 IMKit，请使用 RCIM 中的 RCIMReceiveMessageDelegate 监听消息接收，而不要使用此监听器，否则会导致 IMKit 中无法自动更新 UI！
	 */
	@protocol RCIMClientReceiveMessageDelegate <NSObject>
	
	/*!
	 接收消息的回调方法
	
	 @param message     当前接收到的消息
	 @param nLeft       还剩余的未接收的消息数，left>=0
	 @param object      消息监听设置的 key 值
	
	 @discussion 如果您设置了 IMlib 消息监听之后，SDK 在接收到消息时候会执行此方法。
	 其中，left 为还剩余的、还未接收的消息数量。比如刚上线一口气收到多条消息时，通过此方法，您可以获取到每条消息，left 会依次递减直到 0。
	 您可以根据 left 数量来优化您的 App 体验和性能，比如收到大量消息时等待 left 为 0 再刷新 UI。
	 object 为您在设置消息接收监听时的 key 值。
	 */
	- (void)onReceived:(RCMessage *)message left:(int)nLeft object:(id)object;
	
	@optional
	/*!
	 消息被撤回的回调方法
	 
	 @param messageId 被撤回的消息 ID
	 
	 @discussion 被撤回的消息会变更为 RCRecallNotificationMessage，App 需要在 UI 上刷新这条消息。
	 */
	- (void)onMessageRecalled:(long)messageId;
	
	@end

	// RCIMClient Class
	
	/*!
	 插入消息
	
	 @param conversationType    会话类型
	 @param targetId            目标会话 ID
	 @param senderUserId        消息发送者的用户 ID
	 @param sendStatus          发送状态
	 @param content             消息的内容
	 @return                    插入的消息实体
	
	 @warning 目前仅支持插入向外发送的消息，不支持插入接收的消息。
	 */
	- (RCMessage *)insertMessage:(RCConversationType)conversationType
	                    targetId:(NSString *)targetId
	                senderUserId:(NSString *)senderUserId
	                  sendStatus:(RCSentStatus)sendStatus
	                     content:(RCMessageContent *)content;

	// RCIMClient Class
	
	/*!
	 删除消息
	
	 @param messageIds  消息 ID 的列表
	 @return            是否删除成功
	 */
	- (BOOL)deleteMessages:(NSArray *)messageIds;

	/*!
	 删除某个会话中的所有消息
	
	 @param conversationType    会话类型，不支持聊天室
	 @param targetId            目标会话 ID
	 @return                    是否删除成功
	 */
	- (BOOL)clearMessages:(RCConversationType)conversationType
	             targetId:(NSString *)targetId;

	// RCMessageContent Class
	
	/*!
	 消息内容中携带的发送者的用户信息
	
	 @discussion
	 如果您使用 IMKit，可以通过 RCIM 的 enableMessageAttachUserInfo 属性设置在每次发送消息中携带发送者的用户信息。
	 */
	@property(nonatomic, strong) RCUserInfo *senderUserInfo;

	// RCIMClient Class
	
	/*!
	 设置 IMLib 的连接状态监听器
	
	 @param delegate    IMLib 连接状态监听器
	
	 @warning 如果您使用 IMLib，可以设置并实现此 Delegate 监听连接状态变化；
	 如果您使用 IMKit，请使用 RCIM 中的 connectionStatusDelegate 监听连接状态变化，而不要使用此方法，否则会导致 IMKit 中无法自动更新 UI！
	 */
	- (void)setRCConnectionStatusChangeDelegate:
	    (id<RCConnectionStatusChangeDelegate>)delegate;
    
	/*!
	 IMLib 连接状态的的监听器
	
	 @discussion
	 设置 IMLib 的连接状态监听器，请参考 RCIMClient 的 setRCConnectionStatusChangeDelegate:方法。
	
	 @warning 如果您使用 IMLib，可以设置并实现此 Delegate 监听连接状态变化；
	 如果您使用 IMKit，请使用 RCIM 中的 RCIMConnectionStatusDelegate 监听消息接收，而不要使用此监听器，否则会导致 IMKit 中无法自动更新 UI！
	 */
	@protocol RCConnectionStatusChangeDelegate <NSObject>
	
	/*!
	 IMLib 连接状态的的监听器
	
	 @param status  SDK 与融云服务器的连接状态
	
	 @discussion 如果您设置了 IMLib 消息监听之后，当 SDK 与融云服务器的连接状态发生变化时，会回调此方法。
	 */
	- (void)onConnectionStatusChanged:(RCConnectionStatus)status;

	// RCIMClient Class
	
	/*!
	 断开与融云服务器的连接
	
	 @param isReceivePush   App 在断开连接之后，是否还接收远程推送
	
	 @discussion
	 因为 SDK 在前后台切换或者网络出现异常都会自动重连，会保证连接的可靠性。
	 所以除非您的 App 逻辑需要登出，否则一般不需要调用此方法进行手动断开。
	
	 @warning 如果您使用 IMLib，请使用此方法断开与融云服务器的连接；
	 如果您使用 IMKit，请使用 RCIM 中的同名方法断开与融云服务器的连接，而不要使用此方法。
	
	 isReceivePush 指断开与融云服务器的连接之后，是否还接收远程推送。
	 [[RCIMClient sharedRCIMClient] disconnect:YES]与[[RCIMClient sharedRCIMClient]
	 disconnect]完全一致；
	 [[RCIMClient sharedRCIMClient] disconnect:NO]与[[RCIMClient sharedRCIMClient]
	 logout]完全一致。
	 您只需要按照您的需求，使用 disconnect:与 disconnect 以及 logout 三个接口其中一个即可。
	 */
	- (void)disconnect:(BOOL)isReceivePush;
	
	/*!
	 断开与融云服务器的连接，但仍然接收远程推送
	
	 @discussion
	 因为 SDK 在前后台切换或者网络出现异常都会自动重连，会保证连接的可靠性。
	 所以除非您的 App 逻辑需要登出，否则一般不需要调用此方法进行手动断开。
	
	 @warning 如果您使用 IMLib，请使用此方法断开与融云服务器的连接；
	 如果您使用 IMKit，请使用 RCIM 中的同名方法断开与融云服务器的连接，而不要使用此方法。
	
	 [[RCIMClient sharedRCIMClient] disconnect:YES]与[[RCIMClient sharedRCIMClient]
	 disconnect]完全一致；
	 [[RCIMClient sharedRCIMClient] disconnect:NO]与[[RCIMClient sharedRCIMClient]
	 logout]完全一致。
	 您只需要按照您的需求，使用 disconnect: 与 disconnect 以及 logout 三个接口其中一个即可。
	 */
	- (void)disconnect;
	
	/*!
	 断开与融云服务器的连接，并不再接收远程推送
	
	 @discussion
	 因为 SDK 在前后台切换或者网络出现异常都会自动重连，会保证连接的可靠性。
	 所以除非您的 App 逻辑需要登出，否则一般不需要调用此方法进行手动断开。
	
	 @warning 如果您使用 IMKit，请使用此方法断开与融云服务器的连接；
	 如果您使用 IMLib，请使用 RCIMClient 中的同名方法断开与融云服务器的连接，而不要使用此方法。
	
	 [[RCIMClient sharedRCIMClient] disconnect:YES]与[[RCIMClient sharedRCIMClient]
	 disconnect]完全一致；
	 [[RCIMClient sharedRCIMClient] disconnect:NO]与[[RCIMClient sharedRCIMClient]
	 logout]完全一致。
	 您只需要按照您的需求，使用 disconnect: 与 disconnect 以及 logout 三个接口其中一个即可。
	 */
	- (void)logout;

	// RCMessageContent Class
	
	@interface RCMessageContent
	    : NSObject <RCMessageCoding, RCMessagePersistentCompatible,
	                RCMessageContentView>
	
	...
	
	@end
	
	/*!
	 消息内容的编解码协议
	
	 @discussion 用于标示消息内容的类型，进行消息的编码和解码。
	 所有自定义消息必须实现此协议，否则将无法正常传输和使用。
	 */
	@protocol RCMessageCoding <NSObject>
	@required
	
	/*!
	 将消息内容序列化，编码成为可传输的 json 数据
	
	 @discussion
	 消息内容通过此方法，将消息中的所有数据，编码成为 json 数据，返回的 json 数据将用于网络传输。
	 */
	- (NSData *)encode;
	
	/*!
	 将 json 数据的内容反序列化，解码生成可用的消息内容
	
	 @param data    消息中的原始 json 数据
	
	 @discussion
	 网络传输的 json 数据，会通过此方法解码，获取消息内容中的所有数据，生成有效的消息内容。
	 */
	- (void)decodeWithData:(NSData *)data;
	
	/*!
	 返回消息的类型名
	
	 @return 消息的类型名
	
	 @discussion 您定义的消息类型名，需要在各个平台上保持一致，以保证消息互通。
	
	 @warning 请勿使用 @"RC:" 开头的类型名，以免和 SDK 默认的消息名称冲突
	 */
	+ (NSString *)getObjectName;
	
	@end
	
	/*!
	 消息内容的存储协议
	
	 @discussion 用于确定消息内容的存储策略。
	 所有自定义消息必须实现此协议，否则将无法正常存储和使用。
	 */
	@protocol RCMessagePersistentCompatible <NSObject>
	@required
	
	/*!
	 返回消息的存储策略
	
	 @return 消息的存储策略
	
	 @discussion 指明此消息类型在本地是否存储、是否计入未读消息数。
	 */
	+ (RCMessagePersistent)persistentFlag;
	@end
	
	/*!
	 消息内容摘要的协议
	
	 @discussion 用于在会话列表和本地通知中显示消息的摘要。
	 */
	@protocol RCMessageContentView
	@optional
	
	/*!
	 返回在会话列表和本地通知中显示的消息内容摘要
	
	 @return 会话列表和本地通知中显示的消息内容摘要
	
	 @discussion
	 如果您使用 IMKit，当会话的最后一条消息为自定义消息时，需要通过此方法获取在会话列表展现的内容摘要；
	 当 App 在后台收到消息时，需要通过此方法获取在本地通知中展现的内容摘要。
	 */
	- (NSString *)conversationDigest;
	
	@end

	// RCIMClient Class
	
	/*!
	 注册自定义的消息类型
	
	 @param messageClass    自定义消息的类，该自定义消息需要继承于 RCMessageContent
	
	 @discussion
	 如果您需要自定义消息，必须调用此方法注册该自定义消息的消息类型，否则 SDK 将无法识别和解析该类型消息。
	
	 @warning 如果您使用 IMLib，请使用此方法注册自定义的消息类型；
	 如果您使用 IMKit，请使用 RCIM 中的同名方法注册自定义的消息类型，而不要使用此方法。
	 */
	- (void)registerMessageType:(Class)messageClass;