blob: 4b66ad3dfe32cd18943e2186f7db8204ff26b54d [file] [log] [blame] [view]
# Camera Windows Plugin
The Windows implementation of [`camera`][camera].
*Note*: This plugin is under development.
See [missing implementations and limitations](#missing-features-on-the-windows-platform).
## Usage
### Depend on the package
This package is not an [endorsed][endorsed-federated-plugin]
implementation of the [`camera`][camera] plugin, so in addition to depending
on [`camera`][camera] you'll need to
[add `camera_windows` to your pubspec.yaml explicitly][install].
Once you do, you can use the [`camera`][camera] APIs as you normally would.
## Missing features on the Windows platform
### Device orientation
Device orientation detection
is not yet implemented: [issue #97540][device-orientation-issue].
### Pause and Resume video recording
Pausing and resuming the video recording
is not supported due to Windows API limitations.
### Exposure mode, point and offset
Support for explosure mode and offset
is not yet implemented: [issue #97537][camera-control-issue].
Exposure points are not supported due to
limitations of the Windows API.
### Focus mode and point
Support for explosure mode and offset
is not yet implemented: [issue #97537][camera-control-issue].
### Flash mode
Support for flash mode is not yet implemented: [issue #97537][camera-control-issue].
Focus points are not supported due to
current limitations of the Windows API.
### Streaming of frames
Support for image streaming is not yet implemented: [issue #97542][image-streams-issue].
## Error handling
Camera errors can be listened using the platform's `onCameraError` method.
Listening to errors is important, and in certain situations,
disposing of the camera is the only way to reset the situation.
<!-- Links -->
[camera]: https://pub.dev/packages/camera
[endorsed-federated-plugin]: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin
[install]: https://pub.dev/packages/camera_windows/install
[camera-control-issue]: https://github.com/flutter/flutter/issues/97537
[device-orientation-issue]: https://github.com/flutter/flutter/issues/97540
[image-streams-issue]: https://github.com/flutter/flutter/issues/97542