SDL_GetCameraPermissionState - Query if camera access has been approved by the user.
Contents
Availability
This function is available since SDL 3.2.0.
Description
Cameras will not function between when the device is opened by the app and when the user permits access
to the hardware. On some platforms, this presents as a popup dialog where the user has to explicitly
approve access; on others the approval might be implicit and not alert the user at all.
This function can be used to check the status of that approval. It will return 0 if still waiting for
user response, 1 if the camera is approved for use, and -1 if the user denied access.
Instead of polling with this function, you can wait for a SDL_EVENT_CAMERA_DEVICE_APPROVED (or
SDL_EVENT_CAMERA_DEVICE_DENIED) event in the standard SDL event loop, which is guaranteed to be sent once
when permission to use the camera is decided.
If a camera is declined, there's nothing to be done but call SDL_CloseCamera() to dispose of it.
Function Parameters
camera the opened camera device to query.
Name
SDL_GetCameraPermissionState - Query if camera access has been approved by the user.
Return Value
Returns -1 if user denied access to the camera, 1 if user approved access, 0 if no decision has been made
yet.
See Also
SDL_OpenCamera(3), SDL_CloseCamera(3) Simple Directmedia Layer SDL 3.2.20 SDL_GetCameraPermissionState(3)
Synopsis
#include<SDL3/SDL_camera.h>intSDL_GetCameraPermissionState(SDL_Camera*camera);
Thread Safety
It is safe to call this function from any thread.
