# agora_rtm_handler_t结构体 参考 (/zh-CN/api-reference/rtsa/c/structagora-rtm-handler-t)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
RTM 事件处理回调。
## 结构体成员变量说明 [#结构体成员变量说明]
### on_rtm_data [#on_rtm_data]
void(*) on_rtm_data(const char *rtm_uid, const void *msg, size_t msg_len, [rtm_message_type_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a35525a9e5a7992d762bf4e9084813f8d) msg_type, const char *custom_type)
RTM 消息回调。
发送消息的 RTM 用户 ID。
收到的消息内容。
消息长度。单位为字节。
收到的 RTM 消息类型。详见 [rtm_message_type_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a35525a9e5a7992d762bf4e9084813f8d) 。
自定义消息类型;未设置时为 NULL。
### on_rtm_event [#on_rtm_event]
void(* on_rtm_event)(const char *rtm_uid, [rtm_event_type_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#ab5b2cce4f434a399c2be533afaa837d7) event_type, [rtm_err_code_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a67e13664c08581f85cd18c0e36299395) err_code)
RTM 事件回调。
RTM 用户 ID。
事件类型。详见 [rtm_event_type_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#ab5b2cce4f434a399c2be533afaa837d7) 。
错误码。详见 [rtm_err_code_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a67e13664c08581f85cd18c0e36299395) 。
### on_rtm_send_data_result [#on_rtm_send_data_result]
void(* on_rtm_send_data_result)(const char *rtm_uid, uint32_t msg_id, [rtm_msg_state_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#af57ca27ae3585628b148da1406cc9ce6) state)
[agora_rtm_send_data](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#ab001eda008555d96e4e64dc9e66687bf) 方法调用结果回调。
RTM 用户 ID。
消息 ID。
RTM 消息的发送状态。详见 [rtm_msg_state_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#af57ca27ae3585628b148da1406cc9ce6) 。
### on_rtm_publish_result [#on_rtm_publish_result]
void(*) on_rtm_publish_result(const char *channel_name, uint32_t msg_id, [rtm_msg_state_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#af57ca27ae3585628b148da1406cc9ce6) state)
[agora_rtm_publish](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#ab3dfb2693ca2cc21a56862065a16d718) 方法调用结果回调。
消息发布到的频道名称。
由应用定义的消息 ID。
RTM 消息发送状态。详见 [rtm_msg_state_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#af57ca27ae3585628b148da1406cc9ce6) 。
### on_rtm_subscribe_data [#on_rtm_subscribe_data]
void(*) on_rtm_subscribe_data(const char *channel_name, const char *rtm_uid, const void *msg, size_t msg_len, [rtm_message_type_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a35525a9e5a7992d762bf4e9084813f8d) msg_type, const char *custom_type)
收到已订阅 RTM 频道的消息时触发的回调。
收到消息的频道名称。
消息发送者的 RTM 用户 ID。
收到的消息数据。
收到的消息数据长度,单位为字节。
收到的消息类型。详见 [rtm_message_type_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a35525a9e5a7992d762bf4e9084813f8d) 。
自定义消息类型;未设置时为 NULL。
### on_rtm_subscribe_result [#on_rtm_subscribe_result]
void(*) on_rtm_subscribe_result(const char *channel_name, [rtm_err_code_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a67e13664c08581f85cd18c0e36299395) err_code)
[agora_rtm_subscribe](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a30c2d99a514ebd98a4d335685668f595) 方法调用结果回调。
已订阅的频道名称。
订阅结果。详见 [rtm_err_code_e](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a67e13664c08581f85cd18c0e36299395) 。
---
该结构体的文档由以下文件生成:
- agora_rtc_api.h