# 告警通知和设备控制 (/zh-CN/solutions/smart-doorbell/reference/advanced-feature) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文介绍如何实现智能门铃场景的进阶功能: - 告警通知:以人形检测为例。当智能门铃检测识别到有人后,会主动推送告警事件至应用端。 - 设备控制:客户端可以调节设备音量等。 ## 告警通知 [#告警通知] 设备端检测到预定义的异常事件后,会将事件通知推送到客户端。如果客户端处于后台运行或关闭状态,你还需要集成离线推送服务,确保通知可以及时到达。你可以参考[第三方推送集成](https://doc.easemob.com/document/android/push/push_overview.html)集成环信的离线推送服务。 ## 设备控制 [#设备控制] 设备控制通过设备端与客户端之间的信令交互实现。设备端使用 RTSA Lite SDK 内置的 RTM 接口收发信令,无需额外集成独立 RTM SDK;客户端集成 RTM SDK,向设备端发送控制指令并接收响应。 :::info[客户端示例版本] 以下客户端代码示例使用 RTM 1.x 接口。使用 RTM 2 时,请参考[迁移指南](/zh-CN/realtime-media/rtm/reference/migration-guide)调整初始化、登录和消息收发代码,并确认所选客户端 RTM 版本与设备端 RTSA 版本的互通支持。 ::: ### 1. 生成 RTM Token [#1-生成-rtm-token] 使用信令接口需要通过 RTM Token 鉴权。你需要自行在业务后台生成 [RTM Token](/zh-CN/realtime-media/rtm/build/authentication-and-connection/token-generation)。业务后台会分配此次通话的主叫用户 ID、被叫用户 ID 及对应的 RTM Token,并分别下发至客户端和设备端。这些参数都是后续客户端使用的 RTM SDK 和设备端使用的 RTSA Lite SDK 登录 RTM 系统所需要的。 ### 2. 设备端和客户端登录 RTM 系统 [#2-设备端和客户端登录-rtm-系统] 设备端通过 RTSA Lite SDK 的 `agora_rtm_login` 方法登录 RTM 系统。 ```c rval = agora_rtm_login(p_config->p_rtm_uid, p_config->p_token, &rtm_handler); if (rval < 0) { printf("login rtm failed\n"); goto EXIT; } ``` 客户端通过 RTM SDK 的 `login` 方法登录 RTM 系统。 ```java mRtmClient.login(token, uid, new ResultCallback() { @Override public void onSuccess(Void responseInfo) { } @Override public void onFailure(ErrorInfo errorInfo) { CharSequence text = "User: " + uid + " failed to log in to the RTM system!" + errorInfo.toString(); int duration = Toast.LENGTH_SHORT; runOnUiThread(new Runnable() { public void run() { Toast toast = Toast.makeText(getApplicationContext(), text, duration); toast.show(); } }); } }); ``` ### 3. 设备端发送和接收信令 [#3-设备端发送和接收信令] 设备端通过 RTSA Lite SDK 的 `agora_rtm_send_data` 方法和 `on_rtm_data` 回调发送和接收信令。 :::caution[注意] 只有收到 `RTM_EVENT_TYPE_LOGIN` 且 `ERR_RTM_OK` 的成功回调后,才能调用 `agora_rtm_send_data`。 ::: ```c // 接收你登录的 RTM 系统中对端发送信令 static void __on_rtm_data(const char *user_id, const void *data, size_t data_len, rtm_message_type_e msg_type, const char *custom_type) { app_t *p_app = app_get_instance(); app_config_t *p_config = &p_app->config; if (msg_type == RTM_MESSAGE_TYPE_STRING) { if (p_config->rtm_role == 3) { printf("Receive data[%.*s] length[%zu]\n", (int)data_len, (const char *)data, data_len); } else { printf("data_callback %s data[], length[%zu]\n", user_id, data_len); } } else { printf("data_callback %s data[], length[%zu]\n", user_id, data_len); } if (p_app->config.rtm_recv_dump_flag && p_app->rtm_recv_file_fd != INVALID_FD) { if (write(p_app->rtm_recv_file_fd, data, data_len) != data_len) { printf("write error\n"); return; } } } // 监听本地用户状态 static void __on_rtm_event(const char *user_id, rtm_event_type_e event_type, rtm_err_code_e err_code) { LOGD("%s event type[%d], err code[%d]", user_id, event_type, err_code); if (event_type == RTM_EVENT_TYPE_LOGIN && err_code == ERR_RTM_OK) { app_t *p_app = app_get_instance(); p_app->b_rtm_login_success_flag = 1; } } // 监听本地信令发送结果 static void __on_rtm_send_data_result(const char *rtm_uid, uint32_t msg_id, rtm_msg_state_e state) { LOGD("user [%s] msg id[%u], state[%d]", rtm_uid, msg_id, state); } // 向指定 RTM 用户发送信令 app_t *p_app = app_get_instance(); static uint32_t message_id = 0; const char buffer[] = "device control"; const size_t buffer_len = sizeof(buffer) - 1; if (!p_app->b_rtm_login_success_flag) { LOGE("%s RTM login not successful, skip sending data", TAG_API); goto EXIT; } rval = agora_rtm_send_data(p_app->config.p_peer_uid, buffer, buffer_len, ++message_id, RTM_MESSAGE_TYPE_STRING, NULL); if (rval < 0) { LOGE("%s send data failed, rval=%d", TAG_API, rval); goto EXIT; } ``` ### 4. 客户端发送和接收信令 [#4-客户端发送和接收信令] 客户端通过 RTM SDK 的 `sendMessageToPeer` 方法和 `onMessageReceived` 回调发送和接收信令。 ```java // 发送信令 mRtmClient.sendMessageToPeer(peer_id, message, option, new ResultCallback() { @Override public void onSuccess(Void aVoid) { String text = "Message sent from " + uid + " To " + peer_id + " : " + message.getText() + "\n"; writeToMessageHistory(text); } @Override public void onFailure(ErrorInfo errorInfo) { String text = "Message fails to send from " + uid + " To " + peer_id + " Error : " + errorInfo + "\n"; writeToMessageHistory(text); } }); // 接收信令 @Override public void onMessageReceived(RtmMessage rtmMessage, String peerId) { String text = "Message received from " + peerId + " Message: " + rtmMessage.getText() + "\n"; writeToMessageHistory(text); } ``` ## 开发注意事项 [#开发注意事项] 在开发过程中,你需要注意如下事项: - RTC SDK、RTM SDK、RTSA Lite SDK 和你的 Token 生成器必须使用相同的 [App ID](/zh-CN/introduction/glossary#appid),否则无法互通。 - RTC SDK 和 RTSA Lite SDK 的音视频接口使用 [RTC Token](/zh-CN/realtime-media/rtc/build/setup-and-access/token-authentication) 进行鉴权,RTM SDK 和 RTSA Lite SDK 的云信令接口使用 [RTM Token](/zh-CN/realtime-media/rtm/build/authentication-and-connection/token-generation) 进行鉴权。两者生成方式不同且不可混用。