登录鉴权
Update:
本文主要介绍在使用云上曲率即时通讯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;
本文主要介绍在使用云上曲率即时通讯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;