AgoraRtmDelegate Protocol Reference

Conforms to NSObject
Declared in AgoraRtmKit.h

Overview

AgoraRtmDelegate 接口类向 App 发送回调通知，上报运行时的事件。

– rtmKit:connectionStateChanged:reason:

连接状态改变回调。

- (void)rtmKit:(AgoraRtmKit *_Nonnull)kit connectionStateChanged:(AgoraRtmConnectionState)state reason:(AgoraRtmConnectionChangeReason)reason

Parameters

kit

AgoraRtmKit 实例。
state

新的连接状态，详见 AgoraRtmConnectionState。
reason

连接状态改变的原因，详见 AgoraRtmConnectionChangeReason。

Declared In

AgoraRtmKit.h

– rtmKit:messageReceived:fromPeer:

收到点对点消息回调。

- (void)rtmKit:(AgoraRtmKit *_Nonnull)kit messageReceived:(AgoraRtmMessage *_Nonnull)message fromPeer:(NSString *_Nonnull)peerId

Parameters

kit

AgoraRtmKit 实例。
message

收到的消息内容。
peerId

消息发送者的用户 ID。

Declared In

AgoraRtmKit.h

– rtmKit:fileMessageReceived:fromPeer:

DEPRECATED 收到点对点文件消息回调。

- (void)rtmKit:(AgoraRtmKit *_Nonnull)kit fileMessageReceived:(AgoraRtmFileMessage *_Nonnull)message fromPeer:(NSString *_Nonnull)peerId

Parameters

kit

一个 AgoraRtmKit 实例。
message

接收到的文件消息。 详见 AgoraRtmFileMessage。
peerId

发送该消息的对端用户 ID。

Declared In

AgoraRtmKit.h

– rtmKit:imageMessageReceived:fromPeer:

DEPRECATED 收到点对点图片消息回调。

- (void)rtmKit:(AgoraRtmKit *_Nonnull)kit imageMessageReceived:(AgoraRtmImageMessage *_Nonnull)message fromPeer:(NSString *_Nonnull)peerId

Parameters

kit

一个 AgoraRtmKit 实例。
message

接收到的图片消息。 详见 AgoraRtmImageMessage。
peerId

发送该消息的对端用户 ID。

Declared In

AgoraRtmKit.h

– rtmKit:media:uploadingProgress:

DEPRECATED 主动回调：上传任务的上传进度回调。

- (void)rtmKit:(AgoraRtmKit *_Nonnull)kit media:(long long)requestId uploadingProgress:(AgoraRtmMediaOperationProgress *_Nonnull)progress

Parameters

kit

一个 AgoraRtmKit 实例。
requestId

标识本次上传请求的的唯一 ID。
progress

文件或图片的上传进度。详见 AgoraRtmMediaOperationProgress。

Discussion

NOTE

  • 如果上传任务正在不断进行中，SDK 每秒返回该回调一次。
  • 如果上传任务停顿，SDK 会暂停返回该回调直到上传任务重新进行。

Declared In

AgoraRtmKit.h

– rtmKit:media:downloadingProgress:

DEPRECATED 主动回调：下载任务的下载进度回调。

- (void)rtmKit:(AgoraRtmKit *_Nonnull)kit media:(long long)requestId downloadingProgress:(AgoraRtmMediaOperationProgress *_Nonnull)progress

Parameters

kit

一个 AgoraRtmKit 实例。
requestId

标识本次下载请求的的唯一 ID。
progress

文件或图片的下载进度。详见 AgoraRtmMediaOperationProgress。

Discussion

NOTE

  • 如果下载任务正在不断进行中，SDK 每秒返回该回调一次。
  • 如果下载任务停顿，SDK 会暂停返回该回调直到上传任务重新进行。

Declared In

AgoraRtmKit.h

– rtmKit:PeersOnlineStatusChanged:

被订阅用户在线状态改变回调。

- (void)rtmKit:(AgoraRtmKit *_Nonnull)kit PeersOnlineStatusChanged:(NSArray<AgoraRtmPeerOnlineStatus*> *_Nonnull)onlineStatus

Parameters

kit

一个 AgoraRtmKit 实例。
onlineStatus

用户在线状态列表。详见 AgoraRtmPeerOnlineStatus。

Discussion

  • 首次订阅在线状态成功时，SDK 也会返回本回调，显示所有被订阅用户的在线状态。
  • 每当被订阅用户的在线状态发生改变，SDK 都会通过该回调通知订阅方。
  • 如果 SDK 在断线重连过程中有被订阅用户的在线状态发生改变，SDK 会在重连成功时通过该回调通知订阅方。

Declared In

AgoraRtmKit.h

– rtmKitTokenDidExpire:

（SDK 断线重连时触发）当前使用的 RTM Token 已超过 24 小时的签发有效期。

- (void)rtmKitTokenDidExpire:(AgoraRtmKit *_Nonnull)kit

Parameters

kit

一个 AgoraRtmKit 实例。

Discussion

  • 该回调仅会在 SDK 处于 AgoraRtmConnectionStateReconnecting 状态时因 RTM 后台监测到 Token 签发有效期过期而触发。SDK 处于 AgoraRtmConnectionStateConnected 状态时该回调不会被触发。
  • 收到该回调时，请尽快在你的业务服务端生成新的 Token 并调用 renewToken 方法把新的 Token 传给 Token 验证服务器。

Declared In

AgoraRtmKit.h