Skip to content

camera.md

Latest commit

 

History

History
75 lines (60 loc) · 3.48 KB

camera.md

File metadata and controls

75 lines (60 loc) · 3.48 KB
Raw

Camera

Apps install VisionCamera 5.2.3 and Nitro Image 0.15.2 directly, together with Nitro Modules 0.37.0. Spark ships version-pinned macOS compatibility patches and applies them automatically when the app depends on these libraries.

bun add react-native-vision-camera@5.2.3 react-native-nitro-image@0.15.2 react-native-nitro-modules@0.37.0
import {
  Camera, useCameraDevices, useCameraPermission, usePhotoOutput,
} from "react-native-vision-camera";

import { Button } from "react-native";

function PhotoCamera() {
  const devices = useCameraDevices();
  const { hasPermission, requestPermission } = useCameraPermission();
  const photoOutput = usePhotoOutput({ containerFormat: "jpeg" });
  if (!hasPermission) return <Button title="Allow camera" onPress={() => void requestPermission()} />;
  return devices[0] ? <Camera device={devices[0]} isActive outputs={[photoOutput]} /> : null;
}

Import camera components, hooks, and types from react-native-vision-camera. Import NitroImage and its Image type from react-native-nitro-image to display captured photos. These libraries retain their upstream APIs and lifetimes.

Imperative callers use the same VisionCamera factory without mounting React:

import { VisionCamera } from "react-native-vision-camera";

const granted = await VisionCamera.requestCameraPermission();
const factory = await VisionCamera.createDeviceFactory();
const devices = factory.cameraDevices;
// Owners dispose native resources using VisionCamera's documented lifetimes.
factory.dispose();

Automatic patches

Spark's install hook applies the checked-in Nitro, Nitro Image, and VisionCamera patches. Native preparation verifies/applies them again before native discovery, autolinking, and compatibility signatures. This covers disabled install scripts, reinstalls, and interrupted preparation without a camera install command. Config reads and install hooks use the app/SDK manifests rather than walking the dependency graph. Declare camera directly in the app for these hooks, including mobile autolinking. Desktop native discovery and patch preflight also prepare transitive camera dependencies from their already-resolved installed graph. Only camera optional dependencies join native discovery; other optional native libraries retain their existing discovery policy. Patching is local, idempotent, and version-specific. Conflicting sources or versions fail with an actionable error. Atomic file replacement preserves package-manager cache hardlinks. Production selection can prune the camera when unused; selecting VisionCamera retains Nitro Image and Nitro Modules.

Camera integration does not replace the existing desktop SDK preparation for Runtimes, Windows Nitro, SQLite, and WebView.

Platforms and permissions

iOS and Android use the upstream implementations. Spark's macOS patches add AppKit support on macOS 14+. Windows and web are unsupported. The existing macOS prototype evidence and limits remain applicable; this delivery change does not establish live capture or mobile acceptance.

Applications supply meaningful camera and microphone usage descriptions in their native configuration. On macOS, set NSCameraUsageDescription and, when recording audio, NSMicrophoneUsageDescription under macos.infoPlist in desktop.config.json. Configure the corresponding iOS usage descriptions and Android manifest permissions through your normal Expo/native configuration. The framework does not request permissions merely because it is installed.