Usage¶

<androidx.constraintlayout.widget.ConstraintLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:layout_height="match_parent"
        android:layout_width="match_parent">

    <androidx.camera.view.PreviewView
            android:id="@+id/previewView"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toTopOf="parent"/>

</androidx.constraintlayout.widget.ConstraintLayout>

override fun onCreate() {
    onDetectionResultListener = OnDetectionResultListener { result ->
        // Show a hint to user about the conditions
    }
    localFaceDetector = LocalFaceDetector(context, onDetectionResultListener)
}

override fun onDestroy() {
    localFaceDetector.close()
}

enum class DetectionShortDescription {
    /**
     * The photo is acceptable.
     */
    Ok,

    /**
     * The face detector found more than one face in the image.
     */
    TooManyFaces,

    /**
     * The face detector can't find a face in the image. Face detection has a sensitivity level and may ignore very small faces.
     */
    FaceNotFound,

    /**
     * The facial area is not large enough for analysis. The face can be considered small for several reasons:
     * - Face size in pixels is too small.
     * - Interpupillary distance in pixels is too small.
     * - The difference between the image size and the face size is too large.
     */
    FaceTooSmall,

    /**
     * The face is cropped.
     */
    FaceCropped,

    /**
     * The out-of-plane rotation angle (face pitch and yaw) is too large.
     */
    FaceAngled,

    /**
     * There is occlusion of the face. This detection is designed to work with medical masks that cover the nose and mouth; other occlusions are not guaranteed. Occlusion detection has a probabilistic nature and may have errors.
     */
    FaceOccluded,

    /**
     * A face is too close.
     */
    FaceTooClose,

    /**
     * A face is too close to the border.
     */
    FaceCloseToBorder,

    /**
     * A face is moving.
     */
    FaceMoving,

    /**
     * We can't make any statements about the face because we don't have enough information.
     */
    Undefined,

    /**
     * Eyes are closed.
     */
    EyesClosed,

    /**
     * Dark image.
     */
    DarkImage,

    /**
     * Face is blurry.
     */
    FaceBlurry,

    /**
     * Mouth is open.
     */
    MouthOpen,

    /**
     * Sunglasses are detected.
     */
    SunglassesDetected,
}

override fun onCreate() {
    cameraController = IadCameraController(localFaceDetector, peviewView,  lifecycleOwner)
}

override fun onDestroy() {
    cameraController.close()
}

override fun onStart() {
    cameraController.openCamera()
}

override fun onResume() {
    cameraController.startPreview()
}

override fun onPause() {
    cameraController.stopPreview()
}

override fun onStop() {
    cameraController.closeCamera()
}

cameraController.onCameraErrorListener = OnCameraErrorListener { error ->
    // Handle the exception.
}

cameraController.onDetectionErrorListener = OnDetectionErrorListener { exception ->
    // Handle the exception.
}

cameraController.photoProcessor = object : ImageProcessor {
    override fun process(data: ByteArray, size: Size, format: Int, rotationAngle: Int) {
        // Photo processing: You can display the photo as a preview for the user.
        // Additionally, this event is an appropriate time to show a progress bar.
    }
}

cameraController.bundleProcessor = object : BundleProcessor {
    override fun process(bundle: ByteArray) {
        // Pass this bundle to IDLiveFace Plus server for processing.
        // The server returns an injection attack probability.
    }
}

cameraController.startDetection()

cameraController.takePhoto()