https://github.com/duanhong169/Camera

📸 Use Android camera to take pictures and videos, based on `camera2` api.
https://github.com/duanhong169/Camera

android-camera android-camera-preview android-camera-view android-camera2 android-library android-video-recorder

Last synced: 3 months ago
JSON representation

📸 Use Android camera to take pictures and videos, based on `camera2` api.

• Host: GitHub
• URL: https://github.com/duanhong169/Camera
• Owner: duanhong169
• License: apache-2.0
• Created: 2018-07-02T09:03:28.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-09-18T12:08:00.000Z (about 6 years ago)
• Last Synced: 2024-04-22T04:49:57.235Z (7 months ago)
• Topics: android-camera, android-camera-preview, android-camera-view, android-camera2, android-library, android-video-recorder
• Language: Java
• Homepage:
• Size: 453 KB
• Stars: 129
• Watchers: 8
• Forks: 44
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-android - Camera - Use Android camera to take pictures and videos, based on camera2 api. (Libraries / GUI)
• awesome-android - Camera - Use Android camera to take pictures and videos, based on camera2 api. (Libraries / GUI)

README

        
# Camera [![gitHub release](https://img.shields.io/github/release/duanhong169/Camera.svg?style=social)](https://github.com/duanhong169/Camera/releases) [![platform](https://img.shields.io/badge/platform-android-brightgreen.svg)](https://developer.android.com/index.html)  [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Camera-green.svg?style=flat)](https://android-arsenal.com/details/1/7018) [![license](https://img.shields.io/badge/license-Apache%202-green.svg)](https://github.com/duanhong169/Camera/blob/master/LICENSE) [![Build status](https://build.appcenter.ms/v0.1/apps/09612c7d-00b4-4b16-86b5-054c45d749f8/branches/master/badge)](https://appcenter.ms)

Use Android camera to take pictures and videos, based on [camera2](https://developer.android.com/reference/android/hardware/camera2/package-summary) api.

 

## Features

* Auto filled `CameraView` for previewing

* Support both image capture & video record

* Configurable audio/video size and aspect ratio, auto focus, tap to focus, flash control, pinch to zoom, etc.

## Gradle

```

dependencies {

    implementation 'com.github.duanhong169:camera:${latestVersion}'

    ...

}

```

> Replace `${latestVersion}` with the latest version code. See [releases](https://github.com/duanhong169/Camera/releases).

## Usage

* Add `CameraView` into your layout xml:

```xml

```

> See [`top_defaults_camera_attrs.xml`](./camera/src/main/res/values/top_defaults_camera_attrs.xml) for all supported attributes.

* Create a `Photographer` with the `CameraView`:

```java

@Override

protected void onCreate(@Nullable Bundle savedInstanceState) {

    super.onCreate(savedInstanceState);

    

    // ...

    CameraView preview = findViewById(R.id.preview);

    photographer = PhotographerFactory.createPhotographerWithCamera2(this, preview);

    

    // ...

}

```

* Implement and set `Photographer.OnEventListener` to receive events from the camera:

```java

    photographer.setOnEventListener(new SimpleOnEventListener() {

        @Override

        public void onDeviceConfigured() {}

        @Override

        public void onPreviewStarted() {}

        @Override

        public void onZoomChanged(float zoom) {}

        @Override

        public void onPreviewStopped() {}

        @Override

        public void onStartRecording() {}

        @Override

        public void onFinishRecording(String filePath) {}

        @Override

        public void onShotFinished(String filePath) {}

        @Override

        public void onError(Error error) {}

    });

```

* Start/stop preview in `onResume()`/`onPause()`:

```java

    @Override

    protected void onResume() {

        super.onResume();

        photographer.startPreview();

    }

    @Override

    protected void onPause() {

        photographer.stopPreview();

        super.onPause();

    }

```

* `PhotographerHelper` is your friend:

```java

photographerHelper = new PhotographerHelper(photographer); // init with photographer

photographerHelper.setFileDir(Commons.MEDIA_DIR); // set directory for image/video saving

photographerHelper.flip(); // flip back/front camera

photographerHelper.switchMode(); // switch between image capture/video record

```

See a complete usage in the app sample code.

## Credits

* [google/cameraview](https://github.com/google/cameraview)

* [googlesamples/android-Camera2Basic](https://github.com/googlesamples/android-Camera2Basic)

* [googlesamples/android-Camera2Video](https://github.com/googlesamples/android-Camera2Video)

## License

See the [LICENSE](./LICENSE) file.