Search Docs
Loading...
Skip to content

Access Recordings

Learn how to get the captured photos and recorded videos from the CameraCaptureResult and CameraReactionResult types of the openCamera function.

Explore a full code sample on GitHub.

Success#

A Capture is either a Photo or a Video recording. Photo.images carries one image in standard mode or two stacked images in dual-camera mode. A Recording has a duration and contains an array of Videos — one Video for single-camera recordings or two for dual-camera recordings.

Each Video has:

  • A path to the video file that is stored in a temporary location. Make sure to copy the file to a permanent location if you want to access it later.
  • A rect that contains the position of each video as it was shown in the camera preview. For dual camera recordings, you can use these Rects to arrange the videos as they were laid out in the camera.

Each PhotoImage has the same uri + rect shape.

Standard and Dual Camera#

If the user has captured anything, the openCamera will return a CameraCaptureResult containing an array of Capture values. Iterate the array and pattern-match on photo vs video.

final captures = result.capture?.captures;
if (captures != null) {
  for (final capture in captures) {
    final photo = capture.photo;
    final video = capture.video;
    if (photo != null) {
      for (final image in photo.images) {
        print('Photo path: ${image.uri}');
        print('Photo rect: ${image.rect.toJson()}');
      }
    } else if (video != null) {
      print('Recording duration: ${video.duration}');
      for (final clip in video.videos) {
        print('Video path: ${clip.uri}');
        print('Video rect: ${clip.rect}');
      }
    }
  }
}

Video Reaction#

If the user has recorded a reaction, the openCamera will return a CameraReactionResult which will contain the video that was reacted to and an array of Recordings, each representing a segment of the recorded video.

print('Reaction video duration: ${result.reaction?.video.duration}');


// Get the reaction video data.
final originalVideos = result.reaction?.video.videos;
if (originalVideos != null) {
  for (final video in originalVideos) {
    print('Video path: ${video.uri}');
    print('Video rect: ${video.rect}');
  }
}

Cancellation#

If the user has cancelled the camera session the openCamera function will return null.

if (result == null) {
  print('The editor has been cancelled.');
  return;
}

Failure#

The openCamera function will throw if the user has not allowed accessing their camera and/or microphone or any other parsing/argument error occurred.

print('Error occurred in the camera session: $error');

Full Code#

Here’s the full code for both files:

recordings_camera_solution.dart#

import 'package:flutter/material.dart';
import 'package:imgly_camera/imgly_camera.dart';


class RecordingsCameraSolution extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: () async {
        const settings = CameraSettings(
          license:
              "YOUR-LICENSE-KEY", // Get your license from https://img.ly/forms/free-trial, pass null for evaluation mode with watermark
        );
        try {
          final result = await IMGLYCamera.openCamera(settings);
          if (result == null) {
            print('The editor has been cancelled.');
            return;
          }
          final captures = result.capture?.captures;
          if (captures != null) {
            for (final capture in captures) {
              final photo = capture.photo;
              final video = capture.video;
              if (photo != null) {
                for (final image in photo.images) {
                  print('Photo path: ${image.uri}');
                  print('Photo rect: ${image.rect.toJson()}');
                }
              } else if (video != null) {
                print('Recording duration: ${video.duration}');
                for (final clip in video.videos) {
                  print('Video path: ${clip.uri}');
                  print('Video rect: ${clip.rect}');
                }
              }
            }
          }
        } catch (error) {
          print('Error occurred in the camera session: $error');
        }
      },
      child: const Text('Open Camera'),
    );
  }
}