React SDKAPI ReferenceFunctions
usePermissions()
function usePermissions(): UsePermissionsResult;Aggregated permission states for camera, microphone, location, and sensors.
Queries permission state on mount (without prompting) and provides
requestAll() to trigger browser permission prompts.
Can be used independently of useCapture — e.g., for a permission gate
screen before the camera opens.
Returns
Example
function PermissionGate({ children }) {
const { camera, microphone, location, requestAll, isRequesting } = usePermissions();
if (camera === 'unknown') return <LoadingSpinner />;
if (camera === 'denied') return <SettingsPrompt />;
if (camera === 'prompt') {
return <Button onPress={requestAll} disabled={isRequesting}>Grant Permissions</Button>;
}
return children;
}