Giter VIP home page Giter VIP logo

cameraview-ex's Introduction

Build Status Download License

CameraViewEx

This is an extended version of Google's cameraview library with better stability and many more features.

CameraViewEx highly simplifies integration of camera implementation and various camera features into any Android project. It uses new camera2 api with advanced features on API level 21 and higher and smartly switches to camera1 on older devices (API < 21).

Minimum API 14 is required to use CameraViewEx.

API Level Camera API Preview View
14-20 Camera1 TextureView
21+ Camera2 TextureView

Why another camera library?

Every camera library out there has some issues. Some good ones uses only camera1 api which cannot give best performance possible with today's devices, some are not updated anymore, some does not have all the features while some has a lot of features but uses complex api. CameraViewEx tries to solve all these issues while providing simpler api and more features.

Features

  • High quality image capture
  • Multiple camera modes like single capture, continuous frame, and video capture
  • Ability to enable all or multiple modes simultaneously
  • Preview frame listener
  • Any size preview
  • Customizable continuous frame and single capture output size (different from preview size and aspect ratio)
  • Support multiple formats for output images like jpeg, yuv_420_888, rgba_8888
  • Pinch to zoom
  • Touch to focus
  • Configurable auto white balance, auto focus, flash, noise reduction, and optical / video stabilization
  • Highly configurable video recording with most of the options from MediaRecorder
  • Support multiple aspect ratios
  • Switch between front and back camera
  • Adjustable output image quality
  • Zero shutter lag mode
  • Shutter animation for single capture

jcenter() to mavenCentral() migration

Change the import from,

implementation "com.priyankvasa.android:cameraview-ex:3.5.5-alpha"

to

implementation "dev.priyankvasa.android:cameraview-ex:3.5.5-alpha"

The top level domain has changed from com to dev.

Only the following versions are migrated

Usage

Import dependency

In app build.gradle,

dependencies {
    // ...
    implementation "com.priyankvasa.android:cameraview-ex:3.5.5-alpha"
}

In layout xml

<com.priyankvasa.android.cameraviewex.CameraView
    android:id="@+id/camera"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:adjustViewBounds="true"
    android:keepScreenOn="true"
    app:aspectRatio="4:3"
    app:autoFocus="continuous_picture"
    app:awb="auto"
    app:cameraMode="single_capture"
    app:continuousFrameSize="W1440,1080"
    app:facing="back"
    app:flash="auto"
    app:jpegQuality="high"
    app:noiseReduction="high_quality"
    app:opticalStabilization="true"
    app:outputFormat="jpeg"
    app:pinchToZoom="true"
    app:shutter="short_time"
    app:singleCaptureSize="1920,H1080"
    app:touchToFocus="true"
    app:zsl="true" />

Setup camera

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)

    // Callbacks on UI thread
    camera.addCameraOpenedListener { /* Camera opened. */ }
        .addCameraErrorListener { t: Throwable, errorLevel: ErrorLevel -> /* Camera error! */ }
        .addCameraClosedListener { /* Camera closed. */ }
}

override fun onResume() {
    super.onResume()
    camera.start()
}

override fun onPause() {
    camera.stop()
    super.onPause()
}

override fun onDestroyView() {
    camera.destroy()
    super.onDestroyView()
}

Capture still picture

// enable only single capture mode
camera.setCameraMode(Modes.CameraMode.SINGLE_CAPTURE)
// OR keep other modes as is and enable single capture mode
camera.enableCameraMode(Modes.CameraMode.SINGLE_CAPTURE)
// Output format is whatever set for [app:outputFormat] parameter
// Callback on UI thread
camera.addPictureTakenListener { image: Image -> /* Picture taken. */ }
camera.capture()
// Disable single capture mode
camera.disableCameraMode(Modes.CameraMode.SINGLE_CAPTURE)

Process preview frames

// enable only continuous frame mode
camera.setCameraMode(Modes.CameraMode.CONTINUOUS_FRAME)
// OR keep other modes as is and enable continuous frame mode
camera.enableCameraMode(Modes.CameraMode.CONTINUOUS_FRAME)
// Output format is always ImageFormat.YUV_420_888
// Callback on background thread
camera.setContinuousFrameListener(maxFrameRate = 10f /*optional*/) { image: Image -> /* Frame available. */ }
// Disable continuous frame mode
camera.disableCameraMode(Modes.CameraMode.CONTINUOUS_FRAME)

Record video

// enable only video capture mode
camera.setCameraMode(Modes.CameraMode.VIDEO_CAPTURE)
// OR keep other modes as is and enable video capture mode
camera.enableCameraMode(Modes.CameraMode.VIDEO_CAPTURE)

// Callback on UI thread
camera.addVideoRecordStartedListener { /* Video recording started */ }

// Callback on UI thread
camera.addVideoRecordStoppedListener { isSuccess ->
    // Video recording stopped
    // isSuccess is true if video was recorded and saved successfully
}

camera.startVideoRecording(outputFile) {
    // Configure video (MediaRecorder) parameters
    audioEncoder = AudioEncoder.Aac
    videoFrameRate = 30
    videoStabilization = true
}
// When done recording
camera.stopVideoRecording()

// On APIs 24 and above video recording can be paused and resumed as well
camera.pauseVideoRecording()
camera.resumeVideoRecording()

// Disable video capture mode
camera.disableCameraMode(Modes.CameraMode.VIDEO_CAPTURE)

Set multiple modes simultaneously

  • In xml
<com.priyankvasa.android.cameraviewex.CameraView
    android:id="@+id/camera"
    app:cameraMode="single_capture|continuous_frame|video_capture" />
  • Or in code
camera.setCameraMode(Modes.CameraMode.SINGLE_CAPTURE or Modes.CameraMode.CONTINUOUS_FRAME or Modes.CameraMode.VIDEO_CAPTURE)

// Setup all the listeners including preview frame listener

camera.startVideoRecording(outputFile)
camera.capture()

// The listeners will receive their respective outputs

Switch through cameras for set facing

camera.facing = Modes.Facing.FACING_BACK // Open default back facing camera
camera.nextCamera() // Switch to next back facing camera

Sample apps

Configuration

CameraView property XML Attribute Possible Values
(bold value is the default one)
Camera1 Support (API 14 to 20) Camera2 Support (API 21+)
cameraMode app:cameraMode single_capture, continuous_frame, video_capture ✔️ ✔️
facing app:facing back, front, external ✔️ ✔️
aspectRatio app:aspectRatio 4:3, 16:9, 3:2, 16:10, 17:10, 8:5
(or any other ratio supported by device)
✔️ ✔️
continuousFrameSize app:continuousFrameSize W1920,H1080, W1440,1080, 1280,H720
(or any other size)
✔️ ✔️
singleCaptureSize app:singleCaptureSize W1920,H1080, W1440,1080, 1280,H720
(or any other size)
✔️ ✔️
touchToFocus app:touchToFocus false, true ✔️
autoFocus app:autoFocus off, auto, macro, continuous_video,
continuous_picture, edof
✔️ ✔️
pinchToZoom app:pinchToZoom false, true ✔️
flash app:flash off, on, torch, auto, redEye ✔️ ✔️
awb app:awb off, auto, incandescent, fluorescent, warm_fluorescent,
daylight, cloudy_daylight, twilight, shade
✔️
opticalStabilization app:opticalStabilization false, true ✔️
noiseReduction app:noiseReduction off, fast, high_quality, minimal, zero_shutter_lag ✔️
shutter app:shutter off, short_time, long_time ✔️ ✔️
outputFormat app:outputFormat jpeg, yuv_420_888, rgba_8888 ✔️ ✔️
jpegQuality app:jpegQuality default (90), low (60), medium (80), high (100) ✔️ ✔️
zsl app:zsl false, true ✔️
cameraId
(get only)
N/A Id of currently opened camera device ✔️ ✔️
cameraIdsForFacing
(get only)
N/A Sorted set of ids of camera devices for selected facing ✔️ ✔️
isActive
(get only)
N/A True if this CameraView instance is active and usable, false otherwise. It is set to false after CameraView.destroy() call. ✔️ ✔️
isCameraOpened
(get only)
N/A True if camera is opened, false otherwise. ✔️ ✔️
isSingleCaptureModeEnabled
(get only)
N/A True if single capture mode is enabled, false otherwise. ✔️ ✔️
isContinuousFrameModeEnabled
(get only)
N/A True if continuous frame mode is enabled, false otherwise. ✔️ ✔️
isVideoCaptureModeEnabled
(get only)
N/A True if video capture mode is enabled, false otherwise. ✔️ ✔️
isVideoRecording
(get only)
N/A True if there is a video recording in progress, false otherwise. ✔️ ✔️
supportedAspectRatios
(get only)
N/A Returns list of AspectRatio supported by selected camera. ✔️ ✔️
maxDigitalZoom
(get only)
N/A Returns a float value which is the maximum possible digital zoom value supported by selected camera. ✔️
currentDigitalZoom N/A Set camera digital zoom value. Must be between 1.0 and CameraView.maxDigitalZoom inclusive. ✔️

Documentation

For detailed documentation, please refer these docs.

Contribution Guidelines

See CONTRIBUTING.md.

cameraview-ex's People

Contributors

pvasa avatar pcm2a avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.