import { Platform, UnavailabilityError, type EventSubscription } from 'expo-modules-core'; import { type Ref, Component, createRef } from 'react'; import { CameraCapturedPicture, CameraOrientation, CameraPictureOptions, CameraViewProps, CameraRecordingOptions, CameraViewRef, ScanningOptions, ScanningResult, VideoCodec, AvailableLenses, } from './Camera.types'; import ExpoCamera from './ExpoCamera'; import CameraManager from './ExpoCameraManager'; import { PictureRef } from './PictureRef'; import { ConversionTables, ensureNativeProps } from './utils/props'; const EventThrottleMs = 500; const _PICTURE_SAVED_CALLBACKS: Record = {}; let loggedRenderingChildrenWarning = false; let _GLOBAL_PICTURE_ID = 1; function ensurePictureOptions(options?: CameraPictureOptions): CameraPictureOptions { if (!options || typeof options !== 'object') { return {}; } if (options.quality === undefined) { options.quality = 1; } if (options.mirror) { console.warn( 'The `mirror` option is deprecated. Please use the `mirror` prop on the `CameraView` instead.' ); } if (options.onPictureSaved) { const id = _GLOBAL_PICTURE_ID++; _PICTURE_SAVED_CALLBACKS[id] = options.onPictureSaved; options.id = id; options.fastMode = true; } return options; } function ensureRecordingOptions(options: CameraRecordingOptions = {}): CameraRecordingOptions { if (!options || typeof options !== 'object') { return {}; } if (options.mirror) { console.warn( 'The `mirror` option is deprecated. Please use the `mirror` prop on the `CameraView` instead.' ); } return options; } function _onPictureSaved({ nativeEvent, }: { nativeEvent: { data: CameraCapturedPicture; id: number }; }) { const { id, data } = nativeEvent; const callback = _PICTURE_SAVED_CALLBACKS[id]; if (callback) { callback(data); delete _PICTURE_SAVED_CALLBACKS[id]; } } export default class CameraView extends Component { /** * Property that determines if the current device has the ability to use `DataScannerViewController` (iOS 16+) or the Google code scanner (Android). */ static isModernBarcodeScannerAvailable: boolean = CameraManager.isModernBarcodeScannerAvailable; /** * Check whether the current device has a camera. This is useful for web and simulators cases. * This isn't influenced by the Permissions API (all platforms), or HTTP usage (in the browser). * You will still need to check if the native permission has been accepted. * @platform web */ static async isAvailableAsync(): Promise { if (!CameraManager.isAvailableAsync) { throw new UnavailabilityError('expo-camera', 'isAvailableAsync'); } return CameraManager.isAvailableAsync(); } // @needsAudit /** * Queries the device for the available video codecs that can be used in video recording. * @return A promise that resolves to a list of strings that represents available codecs. * @platform ios */ static async getAvailableVideoCodecsAsync(): Promise { if (!CameraManager.getAvailableVideoCodecsAsync) { throw new UnavailabilityError('Camera', 'getAvailableVideoCodecsAsync'); } return CameraManager.getAvailableVideoCodecsAsync(); } /** * Get picture sizes that are supported by the device. * @return Returns a Promise that resolves to an array of strings representing picture sizes that can be passed to `pictureSize` prop. * The list varies across Android devices but is the same for every iOS. */ async getAvailablePictureSizesAsync(): Promise { return (await this._cameraRef.current?.getAvailablePictureSizes()) ?? []; } /** * Returns the available lenses for the currently selected camera. * * @return Returns a Promise that resolves to an array of strings representing the lens type that can be passed to `selectedLens` prop. * @platform ios */ async getAvailableLensesAsync(): Promise { return (await this._cameraRef.current?.getAvailableLenses()) ?? []; } /** * Returns an object with the supported features of the camera on the current device. */ getSupportedFeatures(): { isModernBarcodeScannerAvailable: boolean; toggleRecordingAsyncAvailable: boolean; } { return { isModernBarcodeScannerAvailable: CameraManager.isModernBarcodeScannerAvailable, toggleRecordingAsyncAvailable: CameraManager.toggleRecordingAsyncAvailable, }; } /** * Resumes the camera preview. */ async resumePreview(): Promise { return this._cameraRef.current?.resumePreview(); } /** * Pauses the camera preview. It is not recommended to use `takePictureAsync` when preview is paused. */ async pausePreview(): Promise { return this._cameraRef.current?.pausePreview(); } // Values under keys from this object will be transformed to native options static ConversionTables = ConversionTables; static defaultProps: CameraViewProps = { zoom: 0, facing: 'back', enableTorch: false, mode: 'picture', flash: 'off', }; _cameraHandle?: number | null; _cameraRef = createRef(); _lastEvents: { [eventName: string]: string } = {}; _lastEventsTimes: { [eventName: string]: Date } = {}; /** * Takes a picture and returns an object that references the native image instance. * > **Note**: Make sure to wait for the [`onCameraReady`](#oncameraready) callback before calling this method. * * > **Note:** Avoid calling this method while the preview is paused. On Android, this will throw an error. On iOS, this will take a picture of the last frame that is currently on screen. * * @param optionsWithRef An object in form of `CameraPictureOptions` type and `pictureRef` key set to `true`. * @return Returns a Promise that resolves to `PictureRef` class which contains basic image data, and a reference to native image instance which can be passed * to other Expo packages supporting handling such an instance. */ async takePictureAsync( optionsWithRef: CameraPictureOptions & { pictureRef: true } ): Promise; /** * Takes a picture and saves it to app's cache directory. Photos are rotated to match device's orientation * (if `options.skipProcessing` flag is not enabled) and scaled to match the preview. * > **Note**: Make sure to wait for the [`onCameraReady`](#oncameraready) callback before calling this method. * * > **Note:** Avoid calling this method while the preview is paused. On Android, this will throw an error. On iOS, this will take a picture of the last frame that is currently on screen. * * @param options An object in form of `CameraPictureOptions` type. * @return Returns a Promise that resolves to `CameraCapturedPicture` object, where `uri` is a URI to the local image file on Android, * iOS, and a base64 string on web (usable as the source for an `Image` element). The `width` and `height` properties specify * the dimensions of the image. * * `base64` is included if the `base64` option was truthy, and is a string containing the JPEG data * of the image in Base64. Prepend it with `'data:image/jpg;base64,'` to get a data URI, which you can use as the source * for an `Image` element for example. * * `exif` is included if the `exif` option was truthy, and is an object containing EXIF * data for the image. The names of its properties are EXIF tags and their values are the values for those tags. * * > On native platforms, the local image URI is temporary. Use [`FileSystem.copy`](filesystem/#copydestination-1) * > to make a permanent copy of the image. */ async takePictureAsync(options?: CameraPictureOptions): Promise; async takePictureAsync(options?: CameraPictureOptions) { const pictureOptions = ensurePictureOptions(options); if (Platform.OS === 'ios' && options?.pictureRef) { return this._cameraRef.current?.takePictureRef?.(options); } return this._cameraRef.current?.takePicture(pictureOptions); } /** * On Android, we will use the [Google code scanner](https://developers.google.com/ml-kit/vision/barcode-scanning/code-scanner). * On iOS, presents a modal view controller that uses the [`DataScannerViewController`](https://developer.apple.com/documentation/visionkit/scanning_data_with_the_camera) available on iOS 16+. * @platform android * @platform ios */ static async launchScanner(options?: ScanningOptions): Promise { if (!options) { options = { barcodeTypes: [] }; } if (Platform.OS !== 'web' && CameraView.isModernBarcodeScannerAvailable) { await CameraManager.launchScanner(options); } } /** * Dismiss the scanner presented by `launchScanner`. * > **info** On Android, the scanner is dismissed automatically when a barcode is scanned. * @platform ios */ static async dismissScanner(): Promise { if (Platform.OS !== 'web' && CameraView.isModernBarcodeScannerAvailable) { await CameraManager.dismissScanner(); } } /** * Invokes the `listener` function when a bar code has been successfully scanned. The callback is provided with * an object of the `ScanningResult` shape, where the `type` refers to the bar code type that was scanned and the `data` is the information encoded in the bar code * (in this case of QR codes, this is often a URL). See [`BarcodeType`](#barcodetype) for supported values. * @param listener Invoked with the [ScanningResult](#scanningresult) when a bar code has been successfully scanned. * * @platform ios * @platform android */ static onModernBarcodeScanned(listener: (event: ScanningResult) => void): EventSubscription { return CameraManager.addListener('onModernBarcodeScanned', listener); } /** * Starts recording a video that will be saved to cache directory. Videos are rotated to match device's orientation. * Flipping camera during a recording results in stopping it. * @param options A map of `CameraRecordingOptions` type. * @return Returns a Promise that resolves to an object containing video file `uri` property and a `codec` property on iOS. * The Promise is returned if `stopRecording` was invoked, one of `maxDuration` and `maxFileSize` is reached or camera preview is stopped. * @platform android * @platform ios */ async recordAsync(options?: CameraRecordingOptions) { const recordingOptions = ensureRecordingOptions(options); return this._cameraRef.current?.record(recordingOptions); } /** * Pauses or resumes the video recording. Only has an effect if there is an active recording. On `iOS`, this method only supported on `iOS` 18. * * @example * ```ts * const { toggleRecordingAsyncAvailable } = getSupportedFeatures() * * return ( * {toggleRecordingAsyncAvailable && ( *