Permissions and Device Access
Use Permissions and Device Access to manage camera and microphone authorization before starting a video appointment.
The app requires explicit user consent to enable real-time audio and video communication.
This screen includes:
- A system permission prompt titled Allow Camera and Mic Access.
- Guidance text that explains why camera and microphone access is required.
- Instructions for enabling permissions through device or browser settings.
- An OK button that acknowledges the message and closes the dialog.
- A Get Assistance option that opens a support resource.
- A close control (×) that dismisses the prompt.
Workflow
Grant Permissions Before Starting a Video Session
Camera and microphone access is required to start a video appointment.
- On the Appointment Details screen, select Start Video.
- Review the permission request for camera and microphone access.
- Grant access when prompted by the operating system or browser.
- Confirm that the app validates both permissions.
- Join the active video session automatically after permissions are grant
Handle Permission Denial
If the user denies access, the video session cannot start.
- Review the guidance message displayed by the app.
- Enable camera and microphone permissions in device or browser settings.
- Return to the app and retry Start Video.
Validations
These scenarios describe how the app validates permission state before starting a session.
| Scenario | App Behavior | SDK Output | Example |
|---|---|---|---|
| Camera or microphone permission is missing. | The app blocks session start and displays guidance. | Permission error or blocked action. | — |
| Only one permission is granted. | The app prevents session start. | Validation error for missing permission. | — |
| Both permissions are granted. | The app starts the video session. | Video room initialization response. | — |
| Permission prompt is dismissed. | The app remains in a non-connected state. | No session state change. | — |
Actions
These scenarios describe how the app responds to permission-related actions.
| Scenario | App Behavior | SDK Output | Example |
|---|---|---|---|
| The user grants access. | The app starts the video session. | Session initialization state. | — |
| The user denies access. | The app blocks the session and shows guidance. | Authorization or permission error. | — |
| The user updates permissions in settings. | The app allows retry of session start. | Subsequent permission validation response. | — |
WebView Considerations
Permission handling differs in mobile WebView environments.
- Only one native permission prompt appears per session.
- After denial, the app cannot trigger another system prompt.
- Always display a fallback modal with manual enablement steps for iOS and Android.
Endpoint Resources
Present Permission Prompt
PUT
/appointments/{appointment-id}/video-room/video-permission
Displays the permission request dialog for the specified appointment.
Update Permission State
POST
/appointments/{appointment-id}/video-room/permission-update
Updates permission state after the user grants or modifies access.