tuya Event Alert Device Messages
The camera sends alerts of events including motion, human shape, pet, and doorbell call to the cloud to get reflected in the message center on the mobile app. Event alerts support image or video message and incoming call prompt.
Development guide
Components
svc_api_ipc
API description
- Solution 1
Report alerts using DP 212. If the event type is included in the NOTIFICATION_NAME_E enum (in the file: tuya_ipc_notify.h), use the following API to report the alert. - Solution 2
If the event type is not included in the NOTIFICATION_NAME_E enum, check if it is included in the TUYA_ALARM_TYPE_E enum (in the file: tuya_ipc_event.h). If yes, you can use the following API to report the alert.
Data structure
The data struct for alert details:
The following sample code shows the initial values for reporting an image alert.
FAQs
Is there a limit on the frequency of alert reporting?
It is recommended to report an alert for every motion event. Take the debounce time into consideration based on motion detection
How do I deal with the API if motion detection is turned off on the mobile app?
If you use tuya_ipc_notify_alarm, set is_notify to FALSE. If you use tuya_ipc_trigger_alarm_without_event, set is_notify in TUYA_ALARM_T to FALSE.
What event types do you support
Events included in NOTIFICATION_NAME_E. Events included in TUYA_ALARM_TYPE_E. To add an event type, submit a service ticket
How do you secure image transfer
Images are encrypted and transmitted in an encrypted channel. Messages are transmitted in an encrypted channel.
What image file format is supported?
JPEG format
What is the image size limit
An image must be less than 307,120 bytes
How do I know if an alert is reported successfully?
In the log, check https for the result of delivering the image and DP 212 message. Go to the Tuya Developer Platform. Choose Product Device Management, and enter the device ID to check if DP 212 is reported successfully.
Why doesn’t the message center display a successfully reported event
Submit a service ticket to request a check for the configuration of the respective event type in DP 212
Documents / Resources
![]() |
tuya Event Alert Device Messages [pdf] User Guide Event 20Alert_TuyaOS_TuyaOS, Event Alert Device Messages, Alert Device Messages, Device Messages |
References
- User Manual ul>