camera_macos

Description:

camera macos

Camera macOS #
Implementation of AVKit camera for macOS.
Can take pictures and record videos, even with external cameras.
Getting Started #

Setup
Basic usage

Taking a picture
Recording a video


Limitations and notes
Future Developments
License


Setup #
In your project, add these two rows to the macos/Runner/Info.plist file:
<key>NSCameraUsageDescription</key>
<string>your usage description here</string>
<key>NSMicrophoneUsageDescription</key>
<string>your usage description here</string>
copied to clipboard
and these two rows in the Debug.Entitlements and Release.Entitlements files.
<key>com.apple.security.device.audio-input</key>
<true/>
<key>com.apple.security.device.camera</key>
<true/>
copied to clipboard
Basic usage #
Integrate CameraMacOSView in your widget tree.
You can choose a BoxFit method and a CameraMacOSMode (photo or video).
When the camera is initialized, a CameraMacOSController object is created and can be used to do basic things such as taking pictures and recording videos.
final GlobalKey cameraKey = GlobalKey("cameraKey");
late CameraMacOSController macOSController;

//... build method ...

CameraMacOSView(
key: cameraKey,
fit: BoxFit.fill,
cameraMode: CameraMacOSMode.photo,
onCameraInizialized: (CameraMacOSController controller) {
setState(() {
this.macOSController = controller;
});
},
),
copied to clipboard
External cameras #
The package supports external cameras too, not just the main Mac camera: you can specify an optional deviceId for the camera and an optional audioDeviceId for the microphone.
Both IDs are related to the uniqueID property of AVCaptureDevice, and can be obtained with the listDevices method.
String? deviceId;
String? audioDeviceId;

// List devices

List<CameraMacOSDevice> videoDevices = await CameraMacOS.instance.listDevices({ deviceType: CameraMacOSMode.video });
List<CameraMacOSDevice> audioDevices = await CameraMacOS.instance.listDevices({ deviceType: CameraMacOSMode.audio });

// Set devices
deviceId = videoDevices.first.deviceId
audioDeviceId = audioDevices.first.deviceId

//... build method ...

CameraMacOSView(
deviceId: deviceId, // optional camera parameter, defaults to the Mac primary camera
audioDeviceId: audioDeviceId, // optional microphone parameter, defaults to the Mac primary microphone
cameraMode: CameraMacOSMode.video,
onCameraInizialized: (CameraMacOSController controller) {
// ...
},
),
copied to clipboard
A CameraMacOSDevice object contains the following properties (mapped to the original AVCaptureDevice class):

deviceId
localizedName
manufacturer
deviceType (video or audio)

Once you've created a CameraMacOSView widget, you will be granted access to a CameraMacOSController object, which is your bridge to do the main two features, taking pictures and recording videos.
You also have information about the camera object you've just created with the CameraMacOSArguments property inside the controller.
Set Focus Point of Camera #
Setting the focus point can be done with the setFocusPoint method.
macOSController.setFocusPoint(Offset(0.5,0.5));
copied to clipboard
The CameraMacOSView widget enables it by default.
Note: the offset needs to be between 0 and 1.
Toggling Torch #
Setting the torch to on, off, or auto can be done with the toggleTorch method.
macOSController.toggleTorch(Torch.on);
copied to clipboard
The CameraMacOSView widget disables it by default.
Setting Orientation #
Setting the orientation to 0, 90, 180, or 270 can be done with the setOrientation method.
Note: This feature for is only available for macOS < 14.0 and Swift < 15.
macOSController.setOrientation(CameraOrientation.orientation0deg);
copied to clipboard
The CameraMacOSView widget defaults to 0.
Setting Zoom #
WARNING: This feature is only available for imageStream right now.
Setting the zoom from 1 - inifity can be done with the setZoomLevel method.
macOSController.setZoomLevel(1.0);
copied to clipboard
The CameraMacOSView widget defaults to 1.
Taking a picture #
Taking pictures can be done with the takePicture method.
Note: for now, you cannot change the zoom or apply effects to the photos.
CameraMacOSFile? file = await macOSController.takePicture();
if(file != null) {
Uint8List? bytes = file.bytes;
// do something with the file...
}

copied to clipboard
Streaming an Image #
Streaming an image can be done with the startImageStream method, and can be stopped with the stopImageStream method.
macOSController.startImageStream((CameraImageData imageData){
//place your code here
});

macOSController.stopImageStream();

copied to clipboard
Note: the streamed data is in argb8888 format
Recording a video #
Recording videos can be done with the recordVideo method, and can be stopped with the stopVideoRecording.
macOSController.recordVideo(
url: // get url from packages such as path_provider,
maxVideoDuration: 30, // duration in seconds,
onVideoRecordingFinished: (CameraMacOSFile? file, CameraMacOSException? exception) {
// called when maxVideoDuration has been reached
// do something with the file or catch the exception
}
);

CameraMacOSFile? file = await macOSController.stopVideoRecording();

if(file != null) {
Uint8List? bytes = file.bytes;
// do something with the file...
}

copied to clipboard
Video settings
You can enable or disable audio recording with the enableAudio flag.
Default videos settings are:

max resolution available to the selected camera - can be changed by setting the resolution property
max audio quality available to the selected video - can be changed by setting the audioQuality property
default microphone codec (apple lossless) - can be changed by setting the audioFormat property
default video format (mp4) - can be changed by setting the videoFormat property

You can set a maximum video duration (in seconds) for recording videos with maxVideoDuration.
A native timer will fire after time has passed, and will call the onVideoRecordingFinished method.
You can also set a saved video file location. Default is in the Library/Cache directory of the application.
Audio recording can be enabled or disabled with the enableAudio flag both in the camera initialization phase or within the recordVideo method (default true).
Output #
After a video or a picture is taken, a CameraMacOSFile object is generated, containing the bytes of the content. If you specify a url save destination for a video, it will return back the file path too.
Widget refreshing #

If you change the widget Key, deviceId or the CameraMacOsMode, the widget will reinitialize.

Limitations and notes #

The package supports macOS 10.11 and onwards.
The plugin is just a temporary substitutive package for the official Flutter team's camera package. It will work only on macOS.
Orientation is only available for macOS < 14.0 and Swift < 15.
Zoom is currently unsupported

Future developments #

Zoom for video and texture

License #
MIT