Awesome
<p align="center"> <a href="https://camerakit.io" target="_blank"> <img alt='CameraKit Header' src='.repo/gh-readme-header.svg' /> </a> </p> <p align="center"> <a href="https://play.google.com/store/apps/details?id=com.wonderkiln.camerakit.demo" target="_blank"> <img alt='Google Play Link' height="42px" src='.repo/gh-readme-googleplay-demo-button.svg'/> </a> <a href="https://spectrum.chat/camerakit/"> <img alt="Join Spectrum" height="42px" src=".repo/gh-readme-spectrum-button.svg" > </a> <a href="https://buddy.works/" target="_blank"> <img alt='Buddy.Works' height="41px" src='https://assets.buddy.works/automated-dark.svg'/> </a> </p>CameraKit helps you add reliable camera to your app quickly. Our open source camera platform provides consistent capture results, service that scales, and endless camera possibilities.
With CameraKit you are able to effortlessly do the following:
- 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.
- Create a
- Multiple capture methods.
METHOD_STANDARD
: an image captured normally using the camera APIs.METHOD_STILL
: a freeze frame of theCameraView
preview (similar to SnapChat and Instagram) for devices with slower cameras.METHOD_SPEED
: automatic capture method determination based on measured speed.
- Built-in continuous focus.
- Built-in tap to focus.
- Built-in pinch to zoom.
Sponsored By
<a href="https://www.expensify.com/"><img alt="Expensify" src=".repo/gh-readme-expensify-logo.svg" height="45px" width="375px" align="center"></a> <a href="https://www.buddy.works/"><img alt="Buddy.Works" src=".repo/gh-readme-buddyworks-logo.png" height="100px" width="250px" align="center"></a>
Trusted By
<a href="https://www.infitting.com/"><img alt="InFitting" src=".repo/gh-readme-infitting-logo.svg" height="30px" width="110px" align="center"></a> <a href="https://www.goosechase.com/"><img alt="GooseChase" src=".repo/gh-readme-goosechase-logo.svg" height="30px" width="175px" align="center"></a> <a href="https://www.alpha-apps.ae/"><img alt="Alpha Apps" src=".repo/gh-readme-alphaapps-logo.png" height="30px" width="78px" align="center"></a> <a href="https://www.expensify.com/"><img alt="Expensify" src=".repo/gh-readme-expensify-logo.svg" height="26px" width="220px" align="center"></a>
Get The Most From CameraKit
There are currently two versions of CameraKit that we support, v1.0.0-beta3.X
and v0.13.X
.
If photo is your only need, try out the latest and greatest CameraKit features with v1.0.0-beta3.11
. Our beta3.11
release does not yet support video, but that feature is coming!
In the meantime, if your application requires video we recommend sticking with v0.13.4
; the latest stable release with video implementation.
Use Case | Version | Notes | Documentation Link |
---|---|---|---|
Photo only | v1.0.0-beta3.11 | The latest and greatest CameraKit has to offer. Video support coming soon! | camerakit.io/docs/beta3.11 |
Photo and Video | v0.13.4 | Stable build with full photo and video support | camerakit.io/docs/0.13.4 |
Documentation Site
Setup instructions for 1.0.0-beta3.11
are below. To see the full documentation head over to our website, camerakit.io/docs.
Setup
To include CameraKit in your project, add the following to your app
level build.gradle
.
dependencies {
implementation 'com.camerakit:camerakit:1.0.0-beta3.11'
implementation 'com.camerakit:jpegkit:0.1.0'
implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.3.0'
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.0.0'
}
Usage
Create a CameraKitView
in your layout as follows:
<com.camerakit.CameraKitView
android:id="@+id/camera"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:adjustViewBounds="true"
android:keepScreenOn="true" <!-- keep screen awake while CameraKitView is active -->
app:camera_flash="auto"
app:camera_facing="back"
app:camera_focus="continuous"
app:camera_permissions="camera" />
Then create a new CameraKitView
object in your Activity
and override the following methods.
private CameraKitView cameraKitView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
cameraKitView = findViewById(R.id.camera);
}
@Override
protected void onStart() {
super.onStart();
cameraKitView.onStart();
}
@Override
protected void onResume() {
super.onResume();
cameraKitView.onResume();
}
@Override
protected void onPause() {
cameraKitView.onPause();
super.onPause();
}
@Override
protected void onStop() {
cameraKitView.onStop();
super.onStop();
}
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
cameraKitView.onRequestPermissionsResult(requestCode, permissions, grantResults);
}
ProGuard
If using ProGuard, add the following rules:
-dontwarn com.google.android.gms.**
-keepclasseswithmembers class com.camerakit.preview.CameraSurfaceView {
native <methods>;
}
License
CameraKit is MIT License