feat: New useCameraPermission() and useMicrophonePermission() hooks (#1823)

* Create `useCameraPermission()` and `useMicrophonePermission()` hooks

* Fix exports

* Await `requestPermission()`
This commit is contained in:
Marc Rousavy
2023-09-21 11:40:04 +02:00
committed by GitHub
parent 977b859e46
commit 327aade4d8
4 changed files with 103 additions and 4 deletions

View File

@@ -0,0 +1,85 @@
import { useCallback, useEffect, useState } from 'react';
import { Camera } from '../Camera';
interface PermissionState {
/**
* Whether the specified permission has explicitly been granted.
* By default, this will be `false`. To request permission, call `requestPermission()`.
*/
hasPermission: boolean;
/**
* Requests the specified permission from the user.
* @returns Whether the specified permission has now been granted, or not.
*/
requestPermission: () => Promise<boolean>;
}
/**
* Returns whether the user has granted permission to use the Camera, or not.
*
* If the user doesn't grant Camera Permission, you cannot use the `<Camera>`.
*
* @example
* ```tsx
* const { hasPermission, requestPermission } = useCameraPermission()
*
* if (!hasPermission) {
* return <PermissionScreen onPress={requestPermission} />
* } else {
* return <Camera ... />
* }
* ```
*/
export function useCameraPermission(): PermissionState {
const [hasPermission, setHasPermission] = useState(false);
const requestPermission = useCallback(async () => {
const result = await Camera.requestCameraPermission();
const hasPermissionNow = result === 'granted';
setHasPermission(hasPermissionNow);
return hasPermissionNow;
}, []);
useEffect(() => {
Camera.getCameraPermissionStatus().then((s) => setHasPermission(s === 'granted'));
}, []);
return {
hasPermission,
requestPermission,
};
}
/**
* Returns whether the user has granted permission to use the Microphone, or not.
*
* If the user doesn't grant Audio Permission, you can use the `<Camera>` but you cannot
* record videos with audio (the `audio={..}` prop).
*
* @example
* ```tsx
* const { hasPermission, requestPermission } = useMicrophonePermission()
* const canRecordAudio = hasPermission
*
* return <Camera video={true} audio={canRecordAudio} />
* ```
*/
export function useMicrophonePermission(): PermissionState {
const [hasPermission, setHasPermission] = useState(false);
const requestPermission = useCallback(async () => {
const result = await Camera.requestMicrophonePermission();
const hasPermissionNow = result === 'granted';
setHasPermission(hasPermissionNow);
return hasPermissionNow;
}, []);
useEffect(() => {
Camera.getMicrophonePermissionStatus().then((s) => setHasPermission(s === 'granted'));
}, []);
return {
hasPermission,
requestPermission,
};
}