Emergency SDK API Reference
The Vonage Emergency SDK enables developers to integrate emergency calling capabilities (such as 911, 112, 999) into their applications. This SDK provides a robust, reliable, and standards-compliant solution for making emergency calls across iOS, Android, and Web platforms.
Overview
The Emergency SDK is designed specifically for critical emergency communications, offering:
- Direct Emergency Calling: Place calls directly to emergency services (911, 112, etc.) from your application
- Automatic Reconnection: Built-in resilience to handle network interruptions during emergency calls
- Real-time Media Control: Mute/unmute and earmuff functionality for managing call audio
- Cross-Platform Support: Consistent API across iOS, Android, and Web platforms
- Reliable Disconnection Handling: Automatic reconnection attempts when calls are unexpectedly disconnected
Key Features
Emergency Call Management
- Initiate emergency calls with authentication and caller identification
- Hang up active emergency calls
- Reconnect to interrupted emergency calls using reconnect tokens
Media Controls
- Mute/Unmute: Control outgoing audio during emergency calls
- Earmuff Mode: Temporarily disable incoming audio without affecting the call
Event Handling
- Receive notifications when the emergency operator hangs up
- Get alerts for unexpected call disconnections
Table of Contents
Actions
- emergencyCall - Initiate an emergency call to services like 911, 112, or 999
- hangUpEmergencyCall - Terminate an active emergency call
- reconnectEmergencyCall - Reconnect to an interrupted emergency call
- muteEmergencyCall - Mute outgoing audio during an emergency call
- unmuteEmergencyCall - Unmute outgoing audio during an emergency call
- enableEarmuffEmergencyCall - Enable earmuff mode to block incoming audio
- disableEarmuffEmergencyCall - Disable earmuff mode to restore incoming audio
Events
- onEmergencyCallHangup - Fired when the remote party hangs up the emergency call
- onEmergencyCallDisconnected - Fired when the emergency call is unexpectedly disconnected
Error Reference
- Errors - Complete guide to error codes and error handling
Important Considerations
- Emergency calls require proper authentication tokens
- Always handle errors appropriately, especially for critical emergency communications
- Test thoroughly in development environments before deploying to production
- Comply with local regulations and emergency service requirements in your target regions