Skip to content

Liveness Check

Camera frame screen in the current UI design with the liveness animation image highlighted

Camera frame screen in the deprecated UI design with the liveness animation image highlighted

  • You can add a custom instructional image for the liveness check animation. If not set, the default image is used:
DocReader.shared.customization.uiConfiguration = DocReader.UIConfiguration {
    $0.setImage(UIImage(named: "liveness_animation")!, forItem: .RGLCustomizationImageLivenessAnimation)
}

UIImage *livenessAnimation = [[UIImage imageNamed:@"liveness_animation"] imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate];

RGLDocReader.shared.customization.uiConfiguration = [RGLUIConfiguration configurationWithBuilderBlock:^(RGLUIConfigurationBuilder * _Nonnull builder) {
    [builder setImage:livenessAnimation forItem:RGLCustomizationImageLivenessAnimation];
}];

DocumentReader.Instance().customization().edit().setImage(CustomizationImage.LIVENESS_ANIMATION, getDrawable(R.drawable.border_background)).apply()

DocumentReader.Instance().customization().edit().setImage(CustomizationImage.LIVENESS_ANIMATION, getDrawable(R.drawable.border_background)).apply()

DocumentReader.instance.customization.images.livenessAnimation = image;

DocumentReader.instance.customization.images.livenessAnimation = base64;

DocumentReader.setCustomization({
  images: {
    livenessAnimation: base64
  }
}, _ => { }, _ => { });

DocumentReader.setCustomization({
  images: {
    livenessAnimation: base64
  }
})

DocumentReader.setCustomization({
  images: {
    livenessAnimation: base64
  }
}, function (m) { }, function (e) { });

// Android
DocumentReader.Instance().Customization().Edit().SetImage(CustomizationImage.LivenessAnimation, image).Apply();

// iOS
RGLDocReader.Shared.Customization.UiConfiguration = RGLUIConfiguration.ConfigurationWithBuilderBlock((RGLUIConfigurationBuilder builder) =>
{
    builder.SetImage(image, Constants.RGLCustomizationImageLivenessAnimation);
});
  • To change the scaling of the liveness check instructional animation image, use:
DocReader.shared.customization.livenessAnimationImageContentMode = UIView.ContentMode.scaleAspectFit

[RGLDocReader shared].customization.livenessAnimationImageContentMode = UIViewContentModeScaleAspectFit;

DocumentReader.Instance().customization().edit()
        .setLivenessAnimationImageScaleType(ImageView.ScaleType.MATRIX)
        .setLivenessAnimationImageMatrix(Matrix())
        .apply()

DocumentReader.Instance().customization().edit()
        .setLivenessAnimationImageScaleType(ImageView.ScaleType.MATRIX)
        .setLivenessAnimationImageMatrix(new Matrix())
        .apply();

DocumentReader.instance.customization.livenessAnimationImageTransformsIOS = ViewContentMode.SCALE_ASPECT_FIT;
DocumentReader.instance.customization.livenessAnimationImageTransformsAndroid = [];

DocumentReader.instance.customization.livenessAnimationImageTransformsIOS = ViewContentMode.SCALE_ASPECT_FIT
DocumentReader.instance.customization.livenessAnimationImageTransformsAndroid = []

DocumentReader.setCustomization({
    livenessAnimationImageContentMode: Enum.UIViewContentMode.ScaleAspectFit,
    livenessAnimationImageMatrix: [],
}, (str) => { console.log(str) }, (error) => { console.log(error) });

DocumentReader.setCustomization({
    livenessAnimationImageContentMode: Enum.UIViewContentMode.ScaleAspectFit,
    livenessAnimationImageMatrix: []
});

DocumentReader.setCustomization({
    livenessAnimationImageContentMode: Enum.UIViewContentMode.ScaleAspectFit,
    livenessAnimationImageMatrix: [],
}, function (m) { }, function (e) { console.log(e); });

// Android
DocumentReader.Instance().Customization().Edit().SetLivenessAnimationImageScaleType(ImageView.ScaleType.Matrix).Apply();
Matrix matrix = new Matrix();
DocumentReader.Instance().Customization().Edit().SetLivenessAnimationImageMatrix(matrix).Apply();

// iOS
RGLDocReader.Shared.Customization.LivenessAnimationImageContentMode = UIViewContentMode.ScaleAspectFit;
  • Change the vertical position of the liveness check instructional animation image:
DocReader.shared.customization.livenessAnimationPositionMultiplier = 0.5

[RGLDocReader shared].customization.livenessAnimationPositionMultiplier = 0.5;

DocumentReader.Instance().customization().edit().setLivenessAnimationPositionMultiplier(0.5f).apply()

DocumentReader.Instance().customization().edit().setLivenessAnimationPositionMultiplier(0.5f).apply();

DocumentReader.instance.customization.livenessAnimationPositionMultiplier = .5;

DocumentReader.instance.customization.livenessAnimationPositionMultiplier = 0.5

DocumentReader.setCustomization({
    livenessAnimationPositionMultiplier: 0.5,
}, (str) => { console.log(str) }, (error) => { console.log(error) });

DocumentReader.setCustomization({
    livenessAnimationPositionMultiplier: 0.5
});

DocumentReader.setCustomization({
    livenessAnimationPositionMultiplier: 0.5,
}, function (m) { }, function (e) { console.log(e); });

// Android
DocumentReader.Instance().Customization().Edit().SetLivenessAnimationPositionMultiplier((Java.Lang.Float)0.5F).Apply();

// iOS
RGLDocReader.Shared.Customization.LivenessAnimationPositionMultiplier = 0.5F;

Next Steps