Skip to content

Powerful custom Android Camera with granular control over the video quality and filesize, restricting recordings to landscape only.

License

Notifications You must be signed in to change notification settings

amomsen/LandscapeVideoCamera

 
 

Repository files navigation

LandscapeVideoCapture Build Status Coverage Status

Highly flexible Android Camera which offers granular control over the video quality and filesize, while restricting recordings to be landscape only.

Get it on Google Play

There are a number of issues with the default Android intent to capture videos (MediaStore.ACTION_VIDEO_CAPTURE) which led me to create this library project:

  1. The default intent only accepts integer quality parameters of 0 (MMS quality) or 1 (highest available quality), using the intent extra MediaStore.EXTRA_VIDEO_QUALITY.
  2. The default intent does not return the URI of the recorded file if it was specified when launching the intent.
  3. The default intent doesn't care wheter users capture their video in portait mode or landscape.

Features

This library provides a full and reusable custom camera, which:

  • Forces the users to rotate their device to landscape
  • Allows to specify the filename, or have the library generate one for you
  • Allows very granular control over the capture settings:
    • Resolution
    • Bitrate
    • Max filesize
    • Max video duration
    • audio/video codec
    • ...

Screenshots

Portrait

Not recording

Not recording

Not recording

How to use

  1. Add the Jitpack repository to your project:

     repositories {
         maven { url "https://jitpack.io" }
     }
    
  2. Add a dependency on the library:

     compile 'com.github.JeroenMols:LandscapeVideoCamera:1.1.2'
    
  3. Specify the VideoCaptureActivity in your manifest:

    <activity
        android:name="com.jmolsmobile.landscapevideocapture.VideoCaptureActivity"
        android:screenOrientation="sensor" >
    </activity>
    
  4. Request the following permissions in your manifest:

    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    
  5. Create a CaptureConfiguration - object with the desired parameters. (optional)

    CaptureConfiguration configuration = CaptureConfiguration(CaptureResolution resolution, CaptureQuality quality);
    CaptureConfiguration configuration = CaptureConfiguration(CaptureResolution resolution, CaptureQuality quality, int maxDurationSecs, int maxFilesizeMb);
    CaptureConfiguration configuration = CaptureConfiguration(int videoWidth, int videoHeight, int bitrate);
    CaptureConfiguration configuration = CaptureConfiguration(int videoWidth, int videoHeight, int bitrate, int maxDurationSecs, int maxFilesizeMb);
    

Note: When no CaptureConfiguration is specified, a default configuration will be used.

Note 2: Subclass the CaptureConfiguration class to set more advanced configurations. (codecs, audio bitrate,...)

  1. Launch the VideoCaptureActivity for result, add the CaptureConfiguration as an parcelable extra EXTRA_CAPTURE_CONFIGURATION and optionally add a String extra EXTRA_OUTPUT_FILENAME.

    final Intent intent = new Intent(getActivity(), VideoCaptureActivity.class);
    intent.putExtra(VideoCaptureActivity.EXTRA_CAPTURE_CONFIGURATION, config);
    intent.putExtra(VideoCaptureActivity.EXTRA_OUTPUT_FILENAME, filename);
    startActivityForResult(intent, RESULT_CODE);
    
  2. Check the resultcode (RESULT_OK, RESULT_CANCELLED or VideoCaptureActivity.RESULT_ERROR) and in case of success get the output filename in the intent extra EXTRA_OUTPUT_FILENAME.

Questions

@molsjeroen

Thanks

Android Arsenal

About

Powerful custom Android Camera with granular control over the video quality and filesize, restricting recordings to landscape only.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.6%
  • Shell 0.4%