LandscapeVideoCamera
Highly flexible Android Camera which offers granular control over the video quality and filesize, while restricting recordings to be landscape only.
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:
- 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. - The default intent does not return the URI of the recorded file if it was specified when launching the intent.
- The default intent doesn't care whether users capture their video in portrait 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
- switch between front and rear facing camera
- ...
How to use
- Add the Jitpack repository to your project:
repositories {
maven { url "https://jitpack.io" }
}
- Add a dependency on the library:
compile 'com.github.jeroenmols:LandscapeVideoCamera:1.3.0'
- Specify the VideoCaptureActivity in your manifest:
<activity
android:name="com.jmolsmobile.landscapevideocapture.VideoCaptureActivity"
android:screenOrientation="sensor" >
</activity>
- 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" />
- Create a CaptureConfiguration using the Builder
// Choose one of both
CaptureConfiguration.Builder builder = new CaptureConfiguration.Builder(CaptureResolution resolution, CaptureQuality quality);
CaptureConfiguration.Builder builder = new CaptureConfiguration.Builder(int videoWidth, int videoHeight, int bitrate);
// Optional
builder.maxDuration(maxDurationSec);
builder.maxFileSize(maxFileSizeMb);
builder.frameRate(framesPerSec);
builder.showRecordingTime(); // Show the elapsed recording time
builder.noCameraToggle(); // Remove button to toggle between front and back camera
// Get the CaptureConfiguration
CaptureConfiguration configuration = builder.build();
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,...)
- Launch the
VideoCaptureActivityfor result, add the CaptureConfiguration as an parcelable extraEXTRA_CAPTURE_CONFIGURATIONand optionally add a String extraEXTRA_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);
- Check the resultcode (
RESULT_OK,RESULT_CANCELLEDorVideoCaptureActivity.RESULT_ERROR) and in case of success get the output filename in the intent extraEXTRA_OUTPUT_FILENAME.
644 Jan 7, 2023
301 Jan 7, 2023
119 Nov 25, 2022
1 Nov 10, 2021
0 Jan 1, 2022
81 Jun 29, 2022
642 Nov 27, 2022
73 May 20, 2022
1 Dec 31, 2022
513 Jan 1, 2023
5 Nov 28, 2022
331 Nov 20, 2022
21 Sep 28, 2022
33 Nov 19, 2022
0 Jan 3, 2022
16 Dec 15, 2022
1.2k Dec 29, 2022
1.3k Dec 27, 2022
48.4k Jan 3, 2023