Skip to content

[camera_android_camerax] Document camera package fps setting has no effect – always records at 30fps #167719

Closed
flutter/packages
#10301

Description

@mahenjrc

Steps to reproduce

  1. Use the Flutter camera package (0.11.0+2) on a device (Android) that supports 60 fps video.
  2. Initialize the camera with fps: 60 in the constructor.
  3. Record a video and inspect the frame rate.

Expected results

The video should be recorded at 60 fps when the device supports it and the fps value is set accordingly.

Actual results

The video is always recorded at 30 fps, regardless of the fps setting.

Code sample

Code sample
cameraController = CameraController(
        camera ?? _cameras![0],
        ResolutionPreset.veryHigh,
        enableAudio: true,
        imageFormatGroup: ImageFormatGroup.jpeg,
        fps: 60,
      );

Flutter Doctor output

Doctor output
flutter doctor -v
[√] Flutter (Channel stable, 3.27.1, on Microsoft Windows [Version 10.0.26100.3775], locale en-US)
    • Flutter version 3.27.1 on channel stable at C:\flutter\flutter_3.27.1
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 17025dd882 (4 months ago), 2024-12-17 03:23:09 +0900
    • Engine revision cb4b5fff73
    • Dart version 3.6.0
    • DevTools version 2.40.2

[√] Windows Version (Installed version of Windows is version 10 or higher)

[√] Android toolchain - develop for Android devices (Android SDK version 35.0.1)
    • Android SDK at C:\Users\M\AppData\Local\Android\sdk
    • Platform android-35, build-tools 35.0.1
    • Java binary at: C:\Program Files\Android\Android Studio\jbr\bin\java
    • Java version OpenJDK Runtime Environment (build 17.0.11+0--11852314)
    • All Android licenses accepted.

[√] Chrome - develop for the web
    • Chrome at C:\Program Files\Google\Chrome\Application\chrome.exe

[√] Visual Studio - develop Windows apps (Visual Studio Community 2022 17.13.6)
    • Visual Studio at C:\Program Files\Microsoft Visual Studio\2022\Community
    • Visual Studio Community 2022 version 17.13.35931.197
    • Windows 10 SDK version 10.0.22621.0

[√] Android Studio (version 2024.1)
    • Android Studio at C:\Program Files\Android\Android Studio
    • Flutter plugin can be installed from:
       https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
       https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build 17.0.11+0--11852314)

[√] VS Code (version 1.99.3)
    • VS Code at C:\Users\M\AppData\Local\Programs\Microsoft VS Code
    • Flutter extension version 3.106.0

[√] Connected device (4 available)
    • sdk gphone64 x86 64 (mobile) • emulator-5554 • android-x64    • Android 15 (API 35) (emulator)
    • Windows (desktop)            • windows       • windows-x64    • Microsoft Windows [Version 10.0.26100.3775]
    • Chrome (web)                 • chrome        • web-javascript • Google Chrome 135.0.7049.97
    • Edge (web)                   • edge          • web-javascript • Microsoft Edge 135.0.3179.66

[√] Network resources
    • All expected network resources are available.

• No issues found!

Activity

  1. danagbemava-nc commented on Apr 25, 2025

    @danagbemava-nc
    Member

    Hi @mahenjrc, what device are you testing on? How are you determining that it is not being recorded at 60fps?

  2. added
    waiting for responseThe Flutter team cannot make further progress on this issue until the original reporter responds
    on Apr 25, 2025
  3. mahenjrc commented on Apr 25, 2025

    @mahenjrc
    Author

    Hi @danagbemava-nc, I tested this on a Pixel 8 and Samsung Galaxy A52. To check the frame rate, I accessed the file system using Android Studio to download the recorded video and viewed the Details tab under Properties. It showed the frame rate as 29.99 fps.

    Image

  4. removed
    waiting for responseThe Flutter team cannot make further progress on this issue until the original reporter responds
    on Apr 25, 2025
  5. danagbemava-nc commented on Apr 28, 2025

    @danagbemava-nc
    Member

    Hi @mahenjrc, as you're recording the video, what does the frame rate appear to be? Is the tool you're using to check the fps able to determine if other videos are 60fps?

  6. added
    waiting for responseThe Flutter team cannot make further progress on this issue until the original reporter responds
    on Apr 28, 2025
  7. mahenjrc commented on May 5, 2025

    @mahenjrc
    Author

    When recording the video the frame rate appeared the same as before even after setting it to 60fps. However it does show 60fps in other videos as I recorded a video using the native camera on each device and checked the properties, which showed 60fps (59.99).

  8. removed
    waiting for responseThe Flutter team cannot make further progress on this issue until the original reporter responds
    on May 5, 2025
  9. danagbemava-nc commented on May 5, 2025

    @danagbemava-nc
    Member

    Reproducible using the camera example app with the fps set to 60. I was able to reproduce this on my Pixel 7. The video metadata extracted from the cache directory viewed in QuickTime Player is in the screenshot below

    Image
    complete code sample
    // Copyright 2013 The Flutter Authors. All rights reserved.
    // Use of this source code is governed by a BSD-style license that can be
    // found in the LICENSE file.
    
    import 'dart:async';
    import 'dart:io';
    
    import 'package:camera/camera.dart';
    import 'package:flutter/foundation.dart';
    import 'package:flutter/material.dart';
    import 'package:flutter/scheduler.dart';
    import 'package:video_player/video_player.dart';
    
    /// Camera example home widget.
    class CameraExampleHome extends StatefulWidget {
      /// Default Constructor
      const CameraExampleHome({super.key});
    
      @override
      State<CameraExampleHome> createState() {
        return _CameraExampleHomeState();
      }
    }
    
    /// Returns a suitable camera icon for [direction].
    IconData getCameraLensIcon(CameraLensDirection direction) {
      switch (direction) {
        case CameraLensDirection.back:
          return Icons.camera_rear;
        case CameraLensDirection.front:
          return Icons.camera_front;
        case CameraLensDirection.external:
          return Icons.camera;
      }
      // This enum is from a different package, so a new value could be added at
      // any time. The example should keep working if that happens.
      // ignore: dead_code
      return Icons.camera;
    }
    
    void _logError(String code, String? message) {
      // ignore: avoid_print
      print('Error: $code${message == null ? '' : '\nError Message: $message'}');
    }
    
    class _CameraExampleHomeState extends State<CameraExampleHome>
        with WidgetsBindingObserver, TickerProviderStateMixin {
      CameraController? controller;
      XFile? imageFile;
      XFile? videoFile;
      VideoPlayerController? videoController;
      VoidCallback? videoPlayerListener;
      bool enableAudio = true;
      double _minAvailableExposureOffset = 0.0;
      double _maxAvailableExposureOffset = 0.0;
      double _currentExposureOffset = 0.0;
      late final AnimationController _flashModeControlRowAnimationController;
      late final CurvedAnimation _flashModeControlRowAnimation;
      late final AnimationController _exposureModeControlRowAnimationController;
      late final CurvedAnimation _exposureModeControlRowAnimation;
      late final AnimationController _focusModeControlRowAnimationController;
      late final CurvedAnimation _focusModeControlRowAnimation;
      double _minAvailableZoom = 1.0;
      double _maxAvailableZoom = 1.0;
      double _currentScale = 1.0;
      double _baseScale = 1.0;
    
      // Counting pointers (number of user fingers on screen)
      int _pointers = 0;
    
      @override
      void initState() {
        super.initState();
        WidgetsBinding.instance.addObserver(this);
    
        _flashModeControlRowAnimationController = AnimationController(
          duration: const Duration(milliseconds: 300),
          vsync: this,
        );
        _flashModeControlRowAnimation = CurvedAnimation(
          parent: _flashModeControlRowAnimationController,
          curve: Curves.easeInCubic,
        );
        _exposureModeControlRowAnimationController = AnimationController(
          duration: const Duration(milliseconds: 300),
          vsync: this,
        );
        _exposureModeControlRowAnimation = CurvedAnimation(
          parent: _exposureModeControlRowAnimationController,
          curve: Curves.easeInCubic,
        );
        _focusModeControlRowAnimationController = AnimationController(
          duration: const Duration(milliseconds: 300),
          vsync: this,
        );
        _focusModeControlRowAnimation = CurvedAnimation(
          parent: _focusModeControlRowAnimationController,
          curve: Curves.easeInCubic,
        );
      }
    
      @override
      void dispose() {
        WidgetsBinding.instance.removeObserver(this);
        _flashModeControlRowAnimationController.dispose();
        _flashModeControlRowAnimation.dispose();
        _exposureModeControlRowAnimationController.dispose();
        _exposureModeControlRowAnimation.dispose();
        _focusModeControlRowAnimationController.dispose();
        _focusModeControlRowAnimation.dispose();
        super.dispose();
      }
    
      // #docregion AppLifecycle
      @override
      void didChangeAppLifecycleState(AppLifecycleState state) {
        final CameraController? cameraController = controller;
    
        // App state changed before we got the chance to initialize.
        if (cameraController == null || !cameraController.value.isInitialized) {
          return;
        }
    
        if (state == AppLifecycleState.inactive) {
          cameraController.dispose();
        } else if (state == AppLifecycleState.resumed) {
          _initializeCameraController(cameraController.description);
        }
      }
      // #enddocregion AppLifecycle
    
      @override
      Widget build(BuildContext context) {
        return Scaffold(
          appBar: AppBar(title: const Text('Camera example')),
          body: Column(
            children: <Widget>[
              Expanded(
                child: Container(
                  decoration: BoxDecoration(
                    color: Colors.black,
                    border: Border.all(
                      color:
                          controller != null && controller!.value.isRecordingVideo
                              ? Colors.redAccent
                              : Colors.grey,
                      width: 3.0,
                    ),
                  ),
                  child: Padding(
                    padding: const EdgeInsets.all(1.0),
                    child: Center(child: _cameraPreviewWidget()),
                  ),
                ),
              ),
              _captureControlRowWidget(),
              _modeControlRowWidget(),
              Padding(
                padding: const EdgeInsets.all(5.0),
                child: Row(
                  children: <Widget>[_cameraTogglesRowWidget(), _thumbnailWidget()],
                ),
              ),
            ],
          ),
        );
      }
    
      /// Display the preview from the camera (or a message if the preview is not available).
      Widget _cameraPreviewWidget() {
        final CameraController? cameraController = controller;
    
        if (cameraController == null || !cameraController.value.isInitialized) {
          return const Text(
            'Tap a camera',
            style: TextStyle(
              color: Colors.white,
              fontSize: 24.0,
              fontWeight: FontWeight.w900,
            ),
          );
        } else {
          return Listener(
            onPointerDown: (_) => _pointers++,
            onPointerUp: (_) => _pointers--,
            child: CameraPreview(
              controller!,
              child: LayoutBuilder(
                builder: (BuildContext context, BoxConstraints constraints) {
                  return GestureDetector(
                    behavior: HitTestBehavior.opaque,
                    onScaleStart: _handleScaleStart,
                    onScaleUpdate: _handleScaleUpdate,
                    onTapDown:
                        (TapDownDetails details) =>
                            onViewFinderTap(details, constraints),
                  );
                },
              ),
            ),
          );
        }
      }
    
      void _handleScaleStart(ScaleStartDetails details) {
        _baseScale = _currentScale;
      }
    
      Future<void> _handleScaleUpdate(ScaleUpdateDetails details) async {
        // When there are not exactly two fingers on screen don't scale
        if (controller == null || _pointers != 2) {
          return;
        }
    
        _currentScale = (_baseScale * details.scale).clamp(
          _minAvailableZoom,
          _maxAvailableZoom,
        );
    
        await controller!.setZoomLevel(_currentScale);
      }
    
      /// Display the thumbnail of the captured image or video.
      Widget _thumbnailWidget() {
        final VideoPlayerController? localVideoController = videoController;
    
        return Expanded(
          child: Align(
            alignment: Alignment.centerRight,
            child: Row(
              mainAxisSize: MainAxisSize.min,
              children: <Widget>[
                if (localVideoController == null && imageFile == null)
                  Container()
                else
                  SizedBox(
                    width: 64.0,
                    height: 64.0,
                    child:
                        (localVideoController == null)
                            ? (
                            // The captured image on the web contains a network-accessible URL
                            // pointing to a location within the browser. It may be displayed
                            // either with Image.network or Image.memory after loading the image
                            // bytes to memory.
                            kIsWeb
                                ? Image.network(imageFile!.path)
                                : Image.file(File(imageFile!.path)))
                            : Container(
                              decoration: BoxDecoration(
                                border: Border.all(color: Colors.pink),
                              ),
                              child: Center(
                                child: AspectRatio(
                                  aspectRatio:
                                      localVideoController.value.aspectRatio,
                                  child: VideoPlayer(localVideoController),
                                ),
                              ),
                            ),
                  ),
              ],
            ),
          ),
        );
      }
    
      /// Display a bar with buttons to change the flash and exposure modes
      Widget _modeControlRowWidget() {
        return Column(
          children: <Widget>[
            Row(
              mainAxisAlignment: MainAxisAlignment.spaceEvenly,
              children: <Widget>[
                IconButton(
                  icon: const Icon(Icons.flash_on),
                  color: Colors.blue,
                  onPressed: controller != null ? onFlashModeButtonPressed : null,
                ),
                // The exposure and focus mode are currently not supported on the web.
                ...!kIsWeb
                    ? <Widget>[
                      IconButton(
                        icon: const Icon(Icons.exposure),
                        color: Colors.blue,
                        onPressed:
                            controller != null ? onExposureModeButtonPressed : null,
                      ),
                      IconButton(
                        icon: const Icon(Icons.filter_center_focus),
                        color: Colors.blue,
                        onPressed:
                            controller != null ? onFocusModeButtonPressed : null,
                      ),
                    ]
                    : <Widget>[],
                IconButton(
                  icon: Icon(enableAudio ? Icons.volume_up : Icons.volume_mute),
                  color: Colors.blue,
                  onPressed: controller != null ? onAudioModeButtonPressed : null,
                ),
                IconButton(
                  icon: Icon(
                    controller?.value.isCaptureOrientationLocked ?? false
                        ? Icons.screen_lock_rotation
                        : Icons.screen_rotation,
                  ),
                  color: Colors.blue,
                  onPressed:
                      controller != null
                          ? onCaptureOrientationLockButtonPressed
                          : null,
                ),
              ],
            ),
            _flashModeControlRowWidget(),
            _exposureModeControlRowWidget(),
            _focusModeControlRowWidget(),
          ],
        );
      }
    
      Widget _flashModeControlRowWidget() {
        return SizeTransition(
          sizeFactor: _flashModeControlRowAnimation,
          child: ClipRect(
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceEvenly,
              children: <Widget>[
                IconButton(
                  icon: const Icon(Icons.flash_off),
                  color:
                      controller?.value.flashMode == FlashMode.off
                          ? Colors.orange
                          : Colors.blue,
                  onPressed:
                      controller != null
                          ? () => onSetFlashModeButtonPressed(FlashMode.off)
                          : null,
                ),
                IconButton(
                  icon: const Icon(Icons.flash_auto),
                  color:
                      controller?.value.flashMode == FlashMode.auto
                          ? Colors.orange
                          : Colors.blue,
                  onPressed:
                      controller != null
                          ? () => onSetFlashModeButtonPressed(FlashMode.auto)
                          : null,
                ),
                IconButton(
                  icon: const Icon(Icons.flash_on),
                  color:
                      controller?.value.flashMode == FlashMode.always
                          ? Colors.orange
                          : Colors.blue,
                  onPressed:
                      controller != null
                          ? () => onSetFlashModeButtonPressed(FlashMode.always)
                          : null,
                ),
                IconButton(
                  icon: const Icon(Icons.highlight),
                  color:
                      controller?.value.flashMode == FlashMode.torch
                          ? Colors.orange
                          : Colors.blue,
                  onPressed:
                      controller != null
                          ? () => onSetFlashModeButtonPressed(FlashMode.torch)
                          : null,
                ),
              ],
            ),
          ),
        );
      }
    
      Widget _exposureModeControlRowWidget() {
        final ButtonStyle styleAuto = TextButton.styleFrom(
          foregroundColor:
              controller?.value.exposureMode == ExposureMode.auto
                  ? Colors.orange
                  : Colors.blue,
        );
        final ButtonStyle styleLocked = TextButton.styleFrom(
          foregroundColor:
              controller?.value.exposureMode == ExposureMode.locked
                  ? Colors.orange
                  : Colors.blue,
        );
    
        return SizeTransition(
          sizeFactor: _exposureModeControlRowAnimation,
          child: ClipRect(
            child: ColoredBox(
              color: Colors.grey.shade50,
              child: Column(
                children: <Widget>[
                  const Center(child: Text('Exposure Mode')),
                  Row(
                    mainAxisAlignment: MainAxisAlignment.spaceEvenly,
                    children: <Widget>[
                      TextButton(
                        style: styleAuto,
                        onPressed:
                            controller != null
                                ? () => onSetExposureModeButtonPressed(
                                  ExposureMode.auto,
                                )
                                : null,
                        onLongPress: () {
                          if (controller != null) {
                            controller!.setExposurePoint(null);
                            showInSnackBar('Resetting exposure point');
                          }
                        },
                        child: const Text('AUTO'),
                      ),
                      TextButton(
                        style: styleLocked,
                        onPressed:
                            controller != null
                                ? () => onSetExposureModeButtonPressed(
                                  ExposureMode.locked,
                                )
                                : null,
                        child: const Text('LOCKED'),
                      ),
                      TextButton(
                        style: styleLocked,
                        onPressed:
                            controller != null
                                ? () => controller!.setExposureOffset(0.0)
                                : null,
                        child: const Text('RESET OFFSET'),
                      ),
                    ],
                  ),
                  const Center(child: Text('Exposure Offset')),
                  Row(
                    mainAxisAlignment: MainAxisAlignment.spaceEvenly,
                    children: <Widget>[
                      Text(_minAvailableExposureOffset.toString()),
                      Slider(
                        value: _currentExposureOffset,
                        min: _minAvailableExposureOffset,
                        max: _maxAvailableExposureOffset,
                        label: _currentExposureOffset.toString(),
                        onChanged:
                            _minAvailableExposureOffset ==
                                    _maxAvailableExposureOffset
                                ? null
                                : setExposureOffset,
                      ),
                      Text(_maxAvailableExposureOffset.toString()),
                    ],
                  ),
                ],
              ),
            ),
          ),
        );
      }
    
      Widget _focusModeControlRowWidget() {
        final ButtonStyle styleAuto = TextButton.styleFrom(
          foregroundColor:
              controller?.value.focusMode == FocusMode.auto
                  ? Colors.orange
                  : Colors.blue,
        );
        final ButtonStyle styleLocked = TextButton.styleFrom(
          foregroundColor:
              controller?.value.focusMode == FocusMode.locked
                  ? Colors.orange
                  : Colors.blue,
        );
    
        return SizeTransition(
          sizeFactor: _focusModeControlRowAnimation,
          child: ClipRect(
            child: ColoredBox(
              color: Colors.grey.shade50,
              child: Column(
                children: <Widget>[
                  const Center(child: Text('Focus Mode')),
                  Row(
                    mainAxisAlignment: MainAxisAlignment.spaceEvenly,
                    children: <Widget>[
                      TextButton(
                        style: styleAuto,
                        onPressed:
                            controller != null
                                ? () => onSetFocusModeButtonPressed(FocusMode.auto)
                                : null,
                        onLongPress: () {
                          if (controller != null) {
                            controller!.setFocusPoint(null);
                          }
                          showInSnackBar('Resetting focus point');
                        },
                        child: const Text('AUTO'),
                      ),
                      TextButton(
                        style: styleLocked,
                        onPressed:
                            controller != null
                                ? () =>
                                    onSetFocusModeButtonPressed(FocusMode.locked)
                                : null,
                        child: const Text('LOCKED'),
                      ),
                    ],
                  ),
                ],
              ),
            ),
          ),
        );
      }
    
      /// Display the control bar with buttons to take pictures and record videos.
      Widget _captureControlRowWidget() {
        final CameraController? cameraController = controller;
    
        return Row(
          mainAxisAlignment: MainAxisAlignment.spaceEvenly,
          children: <Widget>[
            IconButton(
              icon: const Icon(Icons.camera_alt),
              color: Colors.blue,
              onPressed:
                  cameraController != null &&
                          cameraController.value.isInitialized &&
                          !cameraController.value.isRecordingVideo
                      ? onTakePictureButtonPressed
                      : null,
            ),
            IconButton(
              icon: const Icon(Icons.videocam),
              color: Colors.blue,
              onPressed:
                  cameraController != null &&
                          cameraController.value.isInitialized &&
                          !cameraController.value.isRecordingVideo
                      ? onVideoRecordButtonPressed
                      : null,
            ),
            IconButton(
              icon:
                  cameraController != null &&
                          cameraController.value.isRecordingPaused
                      ? const Icon(Icons.play_arrow)
                      : const Icon(Icons.pause),
              color: Colors.blue,
              onPressed:
                  cameraController != null &&
                          cameraController.value.isInitialized &&
                          cameraController.value.isRecordingVideo
                      ? cameraController.value.isRecordingPaused
                          ? onResumeButtonPressed
                          : onPauseButtonPressed
                      : null,
            ),
            IconButton(
              icon: const Icon(Icons.stop),
              color: Colors.red,
              onPressed:
                  cameraController != null &&
                          cameraController.value.isInitialized &&
                          cameraController.value.isRecordingVideo
                      ? onStopButtonPressed
                      : null,
            ),
            IconButton(
              icon: const Icon(Icons.pause_presentation),
              color:
                  cameraController != null && cameraController.value.isPreviewPaused
                      ? Colors.red
                      : Colors.blue,
              onPressed:
                  cameraController == null ? null : onPausePreviewButtonPressed,
            ),
          ],
        );
      }
    
      /// Display a row of toggle to select the camera (or a message if no camera is available).
      Widget _cameraTogglesRowWidget() {
        final List<Widget> toggles = <Widget>[];
    
        void onChanged(CameraDescription? description) {
          if (description == null) {
            return;
          }
    
          onNewCameraSelected(description);
        }
    
        if (_cameras.isEmpty) {
          SchedulerBinding.instance.addPostFrameCallback((_) async {
            showInSnackBar('No camera found.');
          });
          return const Text('None');
        } else {
          for (final CameraDescription cameraDescription in _cameras) {
            toggles.add(
              SizedBox(
                width: 90.0,
                child: RadioListTile<CameraDescription>(
                  title: Icon(getCameraLensIcon(cameraDescription.lensDirection)),
                  groupValue: controller?.description,
                  value: cameraDescription,
                  onChanged: onChanged,
                ),
              ),
            );
          }
        }
    
        return Row(children: toggles);
      }
    
      String timestamp() => DateTime.now().millisecondsSinceEpoch.toString();
    
      void showInSnackBar(String message) {
        ScaffoldMessenger.of(
          context,
        ).showSnackBar(SnackBar(content: Text(message)));
      }
    
      void onViewFinderTap(TapDownDetails details, BoxConstraints constraints) {
        if (controller == null) {
          return;
        }
    
        final CameraController cameraController = controller!;
    
        final Offset offset = Offset(
          details.localPosition.dx / constraints.maxWidth,
          details.localPosition.dy / constraints.maxHeight,
        );
        cameraController.setExposurePoint(offset);
        cameraController.setFocusPoint(offset);
      }
    
      Future<void> onNewCameraSelected(CameraDescription cameraDescription) async {
        if (controller != null) {
          return controller!.setDescription(cameraDescription);
        } else {
          return _initializeCameraController(cameraDescription);
        }
      }
    
      Future<void> _initializeCameraController(
        CameraDescription cameraDescription,
      ) async {
        final CameraController cameraController = CameraController(
          cameraDescription,
          kIsWeb ? ResolutionPreset.max : ResolutionPreset.medium,
          enableAudio: enableAudio,
          imageFormatGroup: ImageFormatGroup.jpeg,
          fps: 60,
        );
    
        controller = cameraController;
    
        // If the controller is updated then update the UI.
        cameraController.addListener(() {
          if (mounted) {
            setState(() {});
          }
          if (cameraController.value.hasError) {
            showInSnackBar(
              'Camera error ${cameraController.value.errorDescription}',
            );
          }
        });
    
        try {
          await cameraController.initialize();
          await Future.wait(<Future<Object?>>[
            // The exposure mode is currently not supported on the web.
            ...!kIsWeb
                ? <Future<Object?>>[
                  cameraController.getMinExposureOffset().then(
                    (double value) => _minAvailableExposureOffset = value,
                  ),
                  cameraController.getMaxExposureOffset().then(
                    (double value) => _maxAvailableExposureOffset = value,
                  ),
                ]
                : <Future<Object?>>[],
            cameraController.getMaxZoomLevel().then(
              (double value) => _maxAvailableZoom = value,
            ),
            cameraController.getMinZoomLevel().then(
              (double value) => _minAvailableZoom = value,
            ),
          ]);
        } on CameraException catch (e) {
          switch (e.code) {
            case 'CameraAccessDenied':
              showInSnackBar('You have denied camera access.');
            case 'CameraAccessDeniedWithoutPrompt':
              // iOS only
              showInSnackBar('Please go to Settings app to enable camera access.');
            case 'CameraAccessRestricted':
              // iOS only
              showInSnackBar('Camera access is restricted.');
            case 'AudioAccessDenied':
              showInSnackBar('You have denied audio access.');
            case 'AudioAccessDeniedWithoutPrompt':
              // iOS only
              showInSnackBar('Please go to Settings app to enable audio access.');
            case 'AudioAccessRestricted':
              // iOS only
              showInSnackBar('Audio access is restricted.');
            default:
              _showCameraException(e);
          }
        }
    
        if (mounted) {
          setState(() {});
        }
      }
    
      void onTakePictureButtonPressed() {
        takePicture().then((XFile? file) {
          if (mounted) {
            setState(() {
              imageFile = file;
              videoController?.dispose();
              videoController = null;
            });
            if (file != null) {
              showInSnackBar('Picture saved to ${file.path}');
            }
          }
        });
      }
    
      void onFlashModeButtonPressed() {
        if (_flashModeControlRowAnimationController.value == 1) {
          _flashModeControlRowAnimationController.reverse();
        } else {
          _flashModeControlRowAnimationController.forward();
          _exposureModeControlRowAnimationController.reverse();
          _focusModeControlRowAnimationController.reverse();
        }
      }
    
      void onExposureModeButtonPressed() {
        if (_exposureModeControlRowAnimationController.value == 1) {
          _exposureModeControlRowAnimationController.reverse();
        } else {
          _exposureModeControlRowAnimationController.forward();
          _flashModeControlRowAnimationController.reverse();
          _focusModeControlRowAnimationController.reverse();
        }
      }
    
      void onFocusModeButtonPressed() {
        if (_focusModeControlRowAnimationController.value == 1) {
          _focusModeControlRowAnimationController.reverse();
        } else {
          _focusModeControlRowAnimationController.forward();
          _flashModeControlRowAnimationController.reverse();
          _exposureModeControlRowAnimationController.reverse();
        }
      }
    
      void onAudioModeButtonPressed() {
        enableAudio = !enableAudio;
        if (controller != null) {
          onNewCameraSelected(controller!.description);
        }
      }
    
      Future<void> onCaptureOrientationLockButtonPressed() async {
        try {
          if (controller != null) {
            final CameraController cameraController = controller!;
            if (cameraController.value.isCaptureOrientationLocked) {
              await cameraController.unlockCaptureOrientation();
              showInSnackBar('Capture orientation unlocked');
            } else {
              await cameraController.lockCaptureOrientation();
              showInSnackBar(
                'Capture orientation locked to ${cameraController.value.lockedCaptureOrientation.toString().split('.').last}',
              );
            }
          }
        } on CameraException catch (e) {
          _showCameraException(e);
        }
      }
    
      void onSetFlashModeButtonPressed(FlashMode mode) {
        setFlashMode(mode).then((_) {
          if (mounted) {
            setState(() {});
          }
          showInSnackBar('Flash mode set to ${mode.toString().split('.').last}');
        });
      }
    
      void onSetExposureModeButtonPressed(ExposureMode mode) {
        setExposureMode(mode).then((_) {
          if (mounted) {
            setState(() {});
          }
          showInSnackBar('Exposure mode set to ${mode.toString().split('.').last}');
        });
      }
    
      void onSetFocusModeButtonPressed(FocusMode mode) {
        setFocusMode(mode).then((_) {
          if (mounted) {
            setState(() {});
          }
          showInSnackBar('Focus mode set to ${mode.toString().split('.').last}');
        });
      }
    
      void onVideoRecordButtonPressed() {
        startVideoRecording().then((_) {
          if (mounted) {
            setState(() {});
          }
        });
      }
    
      void onStopButtonPressed() {
        stopVideoRecording().then((XFile? file) {
          if (mounted) {
            setState(() {});
          }
          if (file != null) {
            showInSnackBar('Video recorded to ${file.path}');
            videoFile = file;
            _startVideoPlayer();
          }
        });
      }
    
      Future<void> onPausePreviewButtonPressed() async {
        final CameraController? cameraController = controller;
    
        if (cameraController == null || !cameraController.value.isInitialized) {
          showInSnackBar('Error: select a camera first.');
          return;
        }
    
        if (cameraController.value.isPreviewPaused) {
          await cameraController.resumePreview();
        } else {
          await cameraController.pausePreview();
        }
    
        if (mounted) {
          setState(() {});
        }
      }
    
      void onPauseButtonPressed() {
        pauseVideoRecording().then((_) {
          if (mounted) {
            setState(() {});
          }
          showInSnackBar('Video recording paused');
        });
      }
    
      void onResumeButtonPressed() {
        resumeVideoRecording().then((_) {
          if (mounted) {
            setState(() {});
          }
          showInSnackBar('Video recording resumed');
        });
      }
    
      Future<void> startVideoRecording() async {
        final CameraController? cameraController = controller;
    
        if (cameraController == null || !cameraController.value.isInitialized) {
          showInSnackBar('Error: select a camera first.');
          return;
        }
    
        if (cameraController.value.isRecordingVideo) {
          // A recording is already started, do nothing.
          return;
        }
    
        try {
          await cameraController.startVideoRecording();
        } on CameraException catch (e) {
          _showCameraException(e);
          return;
        }
      }
    
      Future<XFile?> stopVideoRecording() async {
        final CameraController? cameraController = controller;
    
        if (cameraController == null || !cameraController.value.isRecordingVideo) {
          return null;
        }
    
        try {
          return cameraController.stopVideoRecording();
        } on CameraException catch (e) {
          _showCameraException(e);
          return null;
        }
      }
    
      Future<void> pauseVideoRecording() async {
        final CameraController? cameraController = controller;
    
        if (cameraController == null || !cameraController.value.isRecordingVideo) {
          return;
        }
    
        try {
          await cameraController.pauseVideoRecording();
        } on CameraException catch (e) {
          _showCameraException(e);
          rethrow;
        }
      }
    
      Future<void> resumeVideoRecording() async {
        final CameraController? cameraController = controller;
    
        if (cameraController == null || !cameraController.value.isRecordingVideo) {
          return;
        }
    
        try {
          await cameraController.resumeVideoRecording();
        } on CameraException catch (e) {
          _showCameraException(e);
          rethrow;
        }
      }
    
      Future<void> setFlashMode(FlashMode mode) async {
        if (controller == null) {
          return;
        }
    
        try {
          await controller!.setFlashMode(mode);
        } on CameraException catch (e) {
          _showCameraException(e);
          rethrow;
        }
      }
    
      Future<void> setExposureMode(ExposureMode mode) async {
        if (controller == null) {
          return;
        }
    
        try {
          await controller!.setExposureMode(mode);
        } on CameraException catch (e) {
          _showCameraException(e);
          rethrow;
        }
      }
    
      Future<void> setExposureOffset(double offset) async {
        if (controller == null) {
          return;
        }
    
        setState(() {
          _currentExposureOffset = offset;
        });
        try {
          offset = await controller!.setExposureOffset(offset);
        } on CameraException catch (e) {
          _showCameraException(e);
          rethrow;
        }
      }
    
      Future<void> setFocusMode(FocusMode mode) async {
        if (controller == null) {
          return;
        }
    
        try {
          await controller!.setFocusMode(mode);
        } on CameraException catch (e) {
          _showCameraException(e);
          rethrow;
        }
      }
    
      Future<void> _startVideoPlayer() async {
        if (videoFile == null) {
          return;
        }
    
        final VideoPlayerController vController =
            kIsWeb
                ? VideoPlayerController.networkUrl(Uri.parse(videoFile!.path))
                : VideoPlayerController.file(File(videoFile!.path));
    
        videoPlayerListener = () {
          if (videoController != null) {
            // Refreshing the state to update video player with the correct ratio.
            if (mounted) {
              setState(() {});
            }
            videoController!.removeListener(videoPlayerListener!);
          }
        };
        vController.addListener(videoPlayerListener!);
        await vController.setLooping(true);
        await vController.initialize();
        await videoController?.dispose();
        if (mounted) {
          setState(() {
            imageFile = null;
            videoController = vController;
          });
        }
        await vController.play();
      }
    
      Future<XFile?> takePicture() async {
        final CameraController? cameraController = controller;
        if (cameraController == null || !cameraController.value.isInitialized) {
          showInSnackBar('Error: select a camera first.');
          return null;
        }
    
        if (cameraController.value.isTakingPicture) {
          // A capture is already pending, do nothing.
          return null;
        }
    
        try {
          final XFile file = await cameraController.takePicture();
          return file;
        } on CameraException catch (e) {
          _showCameraException(e);
          return null;
        }
      }
    
      void _showCameraException(CameraException e) {
        _logError(e.code, e.description);
        showInSnackBar('Error: ${e.code}\n${e.description}');
      }
    }
    
    /// CameraApp is the Main Application.
    class CameraApp extends StatelessWidget {
      /// Default Constructor
      const CameraApp({super.key});
    
      @override
      Widget build(BuildContext context) {
        return const MaterialApp(home: CameraExampleHome());
      }
    }
    
    List<CameraDescription> _cameras = <CameraDescription>[];
    
    Future<void> main() async {
      // Fetch the available cameras before initializing the app.
      try {
        WidgetsFlutterBinding.ensureInitialized();
        _cameras = await availableCameras();
      } on CameraException catch (e) {
        _logError(e.code, e.description);
      }
      runApp(const CameraApp());
    }
    
    flutter doctor -v
    [✓] Flutter (Channel stable, 3.29.3, on macOS 15.4 24E248 darwin-arm64, locale en-US) [3.1s]
        • Flutter version 3.29.3 on channel stable at /Users/deanli/dev/stable
        • Upstream repository https://github.com/flutter/flutter.git
        • Framework revision ea121f8859 (3 weeks ago), 2025-04-11 19:10:07 +0000
        • Engine revision cf56914b32
        • Dart version 3.7.2
        • DevTools version 2.42.3
    
    [✓] Android toolchain - develop for Android devices (Android SDK version 36.0.0) [2.6s]
        • Android SDK at /Users/deanli/Library/Android/sdk
        • Platform android-36, build-tools 36.0.0
        • Java binary at: /Users/deanli/Applications/Android Studio Meerkat Feature Drop 2024.3.2 RC 4.app/Contents/jbr/Contents/Home/bin/java
          This JDK is specified in your Flutter configuration.
          To change the current JDK, run: `flutter config --jdk-dir="path/to/jdk"`.
        • Java version OpenJDK Runtime Environment (build 21.0.6+-13368085-b895.109)
        • All Android licenses accepted.
    
    [✓] Xcode - develop for iOS and macOS (Xcode 16.4) [2.2s]
        • Xcode at /Applications/Xcode-16.4.0-Beta.app/Contents/Developer
        • Build 16F1t
        • CocoaPods version 1.16.2
    
    [✓] Chrome - develop for the web [16ms]
        • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
    
    [✓] Android Studio (version 2024.3) [15ms]
        • Android Studio at /Users/deanli/Applications/Android Studio Meerkat Feature Drop 2024.3.2 RC 4.app/Contents
        • Flutter plugin can be installed from:
          🔨 https://plugins.jetbrains.com/plugin/9212-flutter
        • Dart plugin can be installed from:
          🔨 https://plugins.jetbrains.com/plugin/6351-dart
        • android-studio-dir = /Users/deanli/Applications/Android Studio Meerkat Feature Drop 2024.3.2 RC 4.app
        • Java version OpenJDK Runtime Environment (build 21.0.6+-13368085-b895.109)
    
    [✓] Android Studio (version 2024.2) [14ms]
        • Android Studio at /Users/deanli/Applications/Android Studio.app/Contents
        • Flutter plugin can be installed from:
          🔨 https://plugins.jetbrains.com/plugin/9212-flutter
        • Dart plugin can be installed from:
          🔨 https://plugins.jetbrains.com/plugin/6351-dart
        • Java version OpenJDK Runtime Environment (build 21.0.5+-12932927-b750.29)
    
    [✓] VS Code (version 1.99.2) [13ms]
        • VS Code at /Applications/Visual Studio Code.app/Contents
        • Flutter extension version 3.108.0
    
    [✓] Connected device (8 available) [7.8s]
        • Pixel 7 (mobile)                      • 28291FDH2001SA                       • android-arm64  • Android 15 (API 35)
        • Dean’s iPad (wireless) (mobile)       • 00008103-000825C811E3401E            • ios            • iOS 18.5 22F5053f
        • iPhone 16 Pro Max (wireless) (mobile) • 00008140-00194CC23A68801C            • ios            • iOS 18.5 22F5068a
        • Nexus (wireless) (mobile)             • 00008020-001875E83A38002E            • ios            • iOS 18.4.1 22E252
        • iPhone 16 Pro (mobile)                • 63C28242-27C4-477D-A63A-BC88BADB1BCA • ios            • com.apple.CoreSimulator.SimRuntime.iOS-18-5 (simulator)
        • macOS (desktop)                       • macos                                • darwin-arm64   • macOS 15.4 24E248 darwin-arm64
        • Mac Designed for iPad (desktop)       • mac-designed-for-ipad                • darwin         • macOS 15.4 24E248 darwin-arm64
        • Chrome (web)                          • chrome                               • web-javascript • Google Chrome 135.0.7049.115
        ! Error: Browsing on the local area network for iPhone. Ensure the device is unlocked and attached with a cable or associated with the same local area network as this Mac.
          The device must be opted into Developer Mode to connect wirelessly. (code -27)
    
    [✓] Network resources [1,737ms]
        • All expected network resources are available.
    
    • No issues found!
    
    [!] Flutter (Channel master, 3.32.0-1.0.pre.400, on macOS 15.4 24E248 darwin-arm64, locale en-US) [2.8s]
        • Flutter version 3.32.0-1.0.pre.400 on channel master at /Users/deanli/dev/master
        ! Warning: `flutter` on your path resolves to /Users/deanli/dev/stable/bin/flutter, which is not inside your current Flutter SDK checkout at /Users/deanli/dev/master. Consider adding /Users/deanli/dev/master/bin to the front of your path.
        ! Warning: `dart` on your path resolves to /Users/deanli/dev/stable/bin/dart, which is not inside your current Flutter SDK checkout at /Users/deanli/dev/master. Consider adding /Users/deanli/dev/master/bin to the front of your path.
        • Upstream repository https://github.com/flutter/flutter.git
        • Framework revision 14c45d944e (5 hours ago), 2025-05-04 18:28:40 -0700
        • Engine revision 14c45d944e
        • Dart version 3.9.0 (build 3.9.0-76.0.dev)
        • DevTools version 2.46.0-dev.0
        • If those were intentional, you can disregard the above warnings; however it is recommended to use "git" directly to perform update checks and upgrades.
    
    [✓] Android toolchain - develop for Android devices (Android SDK version 36.0.0) [1,776ms]
        • Android SDK at /Users/deanli/Library/Android/sdk
        • Emulator version 35.5.9.0 (build_id 13248646) (CL:N/A)
        • Platform android-36, build-tools 36.0.0
        • Java binary at: /Users/deanli/Applications/Android Studio Meerkat Feature Drop 2024.3.2 RC 4.app/Contents/jbr/Contents/Home/bin/java
          This JDK is specified in your Flutter configuration.
          To change the current JDK, run: `flutter config --jdk-dir="path/to/jdk"`.
        • Java version OpenJDK Runtime Environment (build 21.0.6+-13368085-b895.109)
        • All Android licenses accepted.
    
    [✓] Xcode - develop for iOS and macOS (Xcode 16.4) [1,386ms]
        • Xcode at /Applications/Xcode-16.4.0-Beta.app/Contents/Developer
        • Build 16F1t
        • CocoaPods version 1.16.2
    
    [✓] Chrome - develop for the web [11ms]
        • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
    
    [✓] Android Studio (version 2024.3) [10ms]
        • Android Studio at /Users/deanli/Applications/Android Studio Meerkat Feature Drop 2024.3.2 RC 4.app/Contents
        • Flutter plugin can be installed from:
          🔨 https://plugins.jetbrains.com/plugin/9212-flutter
        • Dart plugin can be installed from:
          🔨 https://plugins.jetbrains.com/plugin/6351-dart
        • android-studio-dir = /Users/deanli/Applications/Android Studio Meerkat Feature Drop 2024.3.2 RC 4.app
        • Java version OpenJDK Runtime Environment (build 21.0.6+-13368085-b895.109)
    
    [✓] Android Studio (version 2024.2) [9ms]
        • Android Studio at /Users/deanli/Applications/Android Studio.app/Contents
        • Flutter plugin can be installed from:
          🔨 https://plugins.jetbrains.com/plugin/9212-flutter
        • Dart plugin can be installed from:
          🔨 https://plugins.jetbrains.com/plugin/6351-dart
        • Java version OpenJDK Runtime Environment (build 21.0.5+-12932927-b750.29)
    
    [✓] VS Code (version 1.99.2) [9ms]
        • VS Code at /Applications/Visual Studio Code.app/Contents
        • Flutter extension version 3.108.0
    
    [✓] Connected device (7 available) [7.2s]
        • Pixel 7 (mobile)                      • 28291FDH2001SA                       • android-arm64  • Android 15 (API 35)
        • Dean’s iPad (wireless) (mobile)       • 00008103-000825C811E3401E            • ios            • iOS 18.5 22F5053f
        • iPhone 16 Pro Max (wireless) (mobile) • 00008140-00194CC23A68801C            • ios            • iOS 18.5 22F5068a
        • Nexus (wireless) (mobile)             • 00008020-001875E83A38002E            • ios            • iOS 18.4.1 22E252
        • iPhone 16 Pro (mobile)                • 63C28242-27C4-477D-A63A-BC88BADB1BCA • ios            • com.apple.CoreSimulator.SimRuntime.iOS-18-5 (simulator)
        • macOS (desktop)                       • macos                                • darwin-arm64   • macOS 15.4 24E248 darwin-arm64
        • Chrome (web)                          • chrome                               • web-javascript • Google Chrome 135.0.7049.115
        ! Error: Browsing on the local area network for iPhone. Ensure the device is unlocked and attached with a cable or associated with the same local area network as this Mac.
          The device must be opted into Developer Mode to connect wirelessly. (code -27)
    
    [✓] Network resources [900ms]
        • All expected network resources are available.
    
    ! Doctor found issues in 1 category.
    
  10. added
    platform-androidAndroid applications specifically
    packageflutter/packages repository. See also p: labels.
    has reproducible stepsThe issue has been confirmed reproducible and is ready to work on
    and removed
    in triagePresently being triaged by the triage team
    on May 5, 2025
  11. 7 remaining items

  12. added
    P2Important issues not at the top of the work list
    triaged-androidTriaged by Android platform team
    c: new featureNothing broken; request for a new capability
    on May 6, 2025
  13. moved this from [Blocking] Harder to delegate to [Blocking] Easy to delegate in Deprecating camera_androidon Jul 7, 2025
  14. github-actions commented on Dec 11, 2025

    @github-actions

    This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

  15. locked as resolved and limited conversation to collaborators on Dec 11, 2025
  16. moved this from [Blocking] Easy to delegate to Done in Deprecating camera_androidon Jan 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Important issues not at the top of the work listc: new featureNothing broken; request for a new capabilityfound in release: 3.29Found to occur in 3.29found in release: 3.32Found to occur in 3.32has reproducible stepsThe issue has been confirmed reproducible and is ready to work onp: cameraThe camera pluginpackageflutter/packages repository. See also p: labels.platform-androidAndroid applications specificallyr: fixedIssue is closed as already fixed in a newer versionteam-androidOwned by Android platform teamtriaged-androidTriaged by Android platform team

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions