Android Yoonit Camera

◻ Modern Android Camera API Camera X ◻ Camera preview (Front & Back) ◻ Yoonit Facefy integration ◻ PyTorch integration ◻ Computer vision pipeline ◻ Face detection, capture and image crop ◻ Understanding of the human face ◻ Frame capture ◻ Capture timed images ◻ QR Code scanning

Sponsors

Platinum

Become a sponsor!

Table of Contents

• Installation
• Usage
  • Camera Preview
  • Start capturing face images
  • Start scanning QR Codes
• API
  • Variables
  • Methods
  • Events
    • Face Analysis
    • Head Movements
    • Image Quality
  • KeyError
  • Message
• To contribute and make it better

Installation

Add the JitPack repository to your root build.gradle at the end of repositories

allprojects {
	repositories {
	..
	maven { url 'https://jitpack.io' }
	}
}

Add the dependency

dependencies {
	implementation 'com.github.Yoonit-Labs:android-yoonit-camera:master-SNAPSHOT'
}

Usage

All the functionalities that the android-yoonit-camera provides is accessed through the CameraView, that includes the camera preview. Below we have the basic usage code, for more details, see the API section.

Camera Preview

Do not forget request camera permission. Use like this in the your layout XML:

<ai.cyberlabs.yoonit.camera.CameraView
  android:id="@+id/camera_view"
  android:layout_width="match_parent"
  android:layout_height="match_parent" />

And inside your code:

var cameraView: CameraView
this.cameraView = camera_view
this.cameraView.startPreview()

Start capturing face images

With camera preview, we can start capture detected face and generate images:

this.cameraView.startCaptureType("face")

Set camera event listener to get the result:

this.cameraView.setCameraEventListener(this.buildCameraEventListener())
..
fun buildCameraEventListener(): CameraEventListener = object : CameraEventListener {
..
	override fun onImageCaptured(
        type: String,
        count: Int,
        total: Int,
        imagePath: String,
        inferences: ArrayList<Pair<String, FloatArray>>,
        darkness: Double,
        lightness: Double,
        sharpness: Double
    ) {
        // YOU CODE
    }

    override fun onFaceDetected(
        x: Int,
        y: Int,
        width: Int,
        height: Int,
        leftEyeOpenProbability: Float?,
        rightEyeOpenProbability: Float?,
        smilingProbability: Float?,
        headEulerAngleX: Float,
        headEulerAngleY: Float,
        headEulerAngleZ: Float
    ) {
        // YOU CODE
    }
..
}

Start scanning QR Codes

With camera preview, we can start scanning QR codes:

this.cameraView.startCaptureType("qrcode")

Set camera event listener to get the result:

this.cameraView.setCameraEventListener(this.buildCameraEventListener())
..
fun buildCameraEventListener(): CameraEventListener = object : CameraEventListener {
..
    override fun onQRCodeScanned(content: String) {
        // YOUR CODE
    }
..
}

API

Variables

Methods

Events

Face Analysis

The face analysis is the response send by the onFaceDetected. Here we specify all the parameters.

Head Movements

Here we explaining the above gif and how reached the "results". Each "movement" (vertical, horizontal and tilt) is a state, based in the angle in degrees that indicate head direction;

Image Quality

The image quality is the classification of the three attributes: darkness, lightness and sharpness. Result available in the onImageCaptured event. Let's see each parameter specifications:

KeyError

Pre-define key error constants used by the onError event.

Message

Pre-define message constants used by the onMessage event.

To contribute and make it better

Clone the repo, change what you want and send PR. For commit messages we use Conventional Commits.

Contributions are always welcome!

Code with ❤ by the Yoonit Team