登录鉴权

本文主要介绍在使用云上曲率即时通讯IM SDK时,如何进行登录鉴权操作。

功能介绍

在IM SDK初始化完成后,需要调用登录接口,完成身份鉴权,成功后,可以正常使用IM SDK的消息、会话等功能。

鉴权

鉴权方式与云上 RTM SDK服务提供的鉴权方式一致,请参考Token鉴权

登录

在获取完Token之后,可以调用login完成登录。 参数说明:

参数 含义 说明
token 登录token Token获取方式包括客户端生成,和通过服务端生成后拉取
ts 对应token的获取方式所产生的时间戳 1-客户端生成Token对应的时间戳
2-传0,代表从服务端获取Token
language 语言 用户使用语言,针对增值服务需求
attribute 自定义属性 开发者可以配置业务信息
timeout 超时时间 请求的超时时间,单位为秒

代码示例

- (void)loginWithToken:(nonnull NSString *)token
                    ts:(int64_t)ts
              language:(nullable NSString *)language
             attribute:(nullable NSDictionary *)attribute
               timeout:(int)timeout
               success:(LDLoginSuccessCallBack)loginSuccess
           connectFail:(LDLoginFailCallBack)loginFail;

断线重连

当登录成功后,出现网络波动、切屏等断线情况时,会触发断线重连操作。此时IM SDK会根据返回值情况来判断是否进行重连。

  • 发起重连
-(BOOL)ldReloginWillStart:(LDEngine *)client reloginCount:(int)reloginCount;
  • 重连结果
-(void)ldReloginCompleted:(LDEngine *)client reloginCount:(int)reloginCount reloginResult:(BOOL)reloginResult error:(FPNError*)error;
  • 关闭连接下线
-(void)ldConnectClose:(LDEngine *)client;
  • 被踢下线
-(void)ldKickout:(LDEngine *)client;