CameraView/README.md

CameraKit is an extraordinarily easy to use utility to work with the infamous Android Camera and Camera2 APIs. Built by Dylan McIntyre.

Try out all the unique features using the CameraKit Demo from the Google Play store!

Table of Contents

• Features
• Setup
• Usage
  • Extra Attributes
  • Capturing Images
  • Capturing Video
• Automatic Permissions Behavior
• Dynamic Behavior
• Capture Mode Behavior
• Credits
• License

Features

• Image and video capture seamlessly working with the same preview session.
• Automatic system permission handling.
• Automatic preview scaling.
  • Create a CameraView of any size (not just presets!).
  • Automatic output cropping to match your CameraView bounds.
• Multiple capture modes.
  • PICTURE_MODE_QUALITY: an image captured normally using the camera APIs.
  • PICTURE_MODE_SPEED: a freeze frame of the CameraView preview (similar to SnapChat and Instagram) for devices with slower cameras.
  • Automatic picture mode determination based on measured speed.

Setup

Add CameraKit to the dependencies block in your app level build.gradle:

compile 'com.flurgle:camerakit:1.0.0'

Usage

To use CameraKit, simply add a CameraView to your layout:

<com.flurgle.camerakit.CameraView
    android:id="@+id/camera"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Make sure you override onResume and onPause in your activity, and make calls respectively to CameraView.start() and CameraView.stop().

@Override
protected void onResume() {
    super.onResume();
    cameraView.start();
}

@Override
protected void onPause() {
    cameraView.stop();
    super.onPause();
}

Extra Attributes

Extra attributes

Capturing images

Capturing photos

Capturing Video

Capturing video

Automatic Permissions Behavior

Automatic permissions behavior

Dynamic Sizing Behavior

Dynamic sizing behavior

Capture Mode Behavior

Capture mode behavior

Credits

Dylan McIntyre

License

CameraKit-Android is MIT licensed.