Android v2.x.x Full

TrustVisionSDK.init(this, YOUR_APP_KEY, YOUR_APP_SECRET, this);

app
root
repo
    +--com
        +--trustvision
            +--tv_api_sdk
                +--2.0.x
                    +--tv_api_sdk-2.x.x.aar
                    +--tv_api_sdk-2.x.x.pom
                maven-metadata.xml
            +--tv_core_sdk
            +--tv_sdk
...

repositories {
    maven { url "https://maven.google.com" }
    maven { url "path/to/tvsdk/folder" }
    ...
}

android {
    ...
    aaptOptions {
        noCompress "tflite"
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation('com.trustvision:tv_sdk:2.x.x@aar') {
    transitive = true
}
testImplementation 'junit:junit:4.12'

}

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    TrustVisionSDK.init(this, appKey, appSecret, new TrustVisionSDK.TVInitializeListener() {
        @Override
        public void onInitSuccess() {
            List<TVCardType> cards = TrustVisionSDK.getCardTypes();
        }

        @Override
        public void onInitError() {

        }
    });
}

List<TVCardType> cards = TrustVisionSDK.getCardTypes();

TrustVisionSDK.startTransaction(referenceID, channelName new TVTransactionCallback() {
    @Override
    public void onError(TVDetectionError error) {

    }

    @Override
    public void onSuccess(TVTransactionData transactionData) {
        HomeActivity.this.transactionID = transactionData.getTransactionId();
        HomeActivity.this.channelId = transactionData.getChannelId();
    }
});

TVSDKConfiguration.Builder builder = new TVSDKConfiguration.Builder()
.setActionMode(TVActionMode.FULL)
.setLivenessMode(TVLivenessMode.PASSIVE)
.setEnableSound(true)
.setEnableTiltChecking(true)
.setCardType(selectedCard)
.setCardSide(TVSDKConfiguration.TVCardSide.FRONT)
.setReadBothSide(false)
.setEnableReadCardInfo(false)
.setEnableIDSanityCheck(true)
.setEnableSelfieSanityCheck(true)
.setSkipConfirmScreen(false);

TVIDConfiguration configuration = builder.build();

TrustVisionActivity.startTrustVisionSDK(context, configuration, new TVIDCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {

    }

    @Override
    public void onSuccess(TVDetectionResult result) {

    }

    @Override
    public void onCanceled() {

    }
});

TVIDConfiguration.Builder builder = new TVIDConfiguration.Builder()
.setCardType(selectedCard)
.setBackside(false)
.setEnableReadCardInfo(false)
.setEnableSanityCheck(true)
TVIDConfiguration configuration = builder.build();

TrustVisionActivity.startIDCapturing(context, languageCode, configuration, new TVIDCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {

    }

    @Override
    public void onSuccess(TVDetectionResult result) {

    }

    @Override
    public void onCanceled() {

    }
});

TVSelfieConfiguration.Builder builder = new TVSelfieConfiguration.Builder()
.setCameraOption(TVSDKConfiguration.TVCameraOption.FRONT)
.setEnableSound(false)
.requireSanity(true)
.setLivenessMode(TVLivenessMode.PASSIVE);

TrustVisionActivity.startSelfieCapturing(context, languageCode, builder.build(), new TVCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {

    }

    @Override
    public void onSuccess(TVDetectionResult result) {

    }

    @Override
    public void onCanceled() {

    }
});

TVVkycConfiguration.Builder builder = new TVVkycConfiguration.Builder()

TrustVisionActivity.startVkyc(context, builder.build(), new TVCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {

    }

    @Override
    public void onSuccess(TVDetectionResult result) {

    }

    @Override
    public void onCanceled() {

    }
});

TVSelfVkycConfiguration.Builder builder = new TVSelfVkycConfiguration.Builder()
    .setCameraOption(TVSDKConfiguration.TVCameraOption.FRONT)
    .setEnableSound(false)
    .setEnableSanityCheck(false)
    .setEnableVerticalChecking(false);

TrustVisionActivity.startSelfVkyc(context, builder.build(), new TVCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {

    }

    @Override
    public void onSuccess(TVDetectionResult result) {

    }

    @Override
    public void onCanceled() {

    }
});

TrustVisionSDK.faceMatching(imageId1, imageId2, new TVCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {
        Log.d("", error.getDetailErrorCode() + ":" + error.getDetailErrorDescription();
    }

    @Override
    public void onSuccess(TVDetectionResult result) {
        TVCompareFacesResult faceMatchingResult = result.getFaceCompareResult();

        // check response
        switch faceMatchingResult.getMatchResult() {
            case TVCompareFacesResult.MatchResult.MATCHED:
            case TVCompareFacesResult.MatchResult.UNSURE:
            case TVCompareFacesResult.MatchResult.UNMATCHED:
        }
    }

    @Override
   public void onCanceled() {

   }
});

// [FlowStartingFunc]: startTrustVisionSDK, startIdCapturing

TrustVisionActivity.[FlowStartingFunc](..., builder.build(), new TVCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {

    }

    @Override
    public void onSuccess(TVDetectionResult result) {
        // ID CARD SANITY RESULT
        TVSanityResult idSanity = result.getIdSanityResult();
        if (idSanity != null && !idSanity.isGood()) {
            String error = idSanity.getError();
            switch (error) {
                case "image_too_blur":
                    // Image is too blurry
                case "image_too_dark":
                    // Image is too dark
                case "image_too_bright":
                    // Image is too bright
                case "image_has_hole":
                    // Image has holes
                case "image_has_cut":
                    // Images has been cut
                case "image_has_hole_and_cut":
                    // Images has holes and has been cut
                case "photo_not_qualified":
                    // Image is blurry or not clear
                case "no_card_or_incomplete_card":
                    // the captured image may contain a part of the card or no card at all
                case "nocard_or_multicard_image":
                    // the captured image may contain several cards or no card at all
            }
        }
    }
});

// [FlowStartingFunc]: startTrustVisionSDK, startSelfieCapturing

TrustVisionActivity.[FlowStartingFunc](..., builder.build(), new TVCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {

    }

    @Override
    public void onSuccess(TVDetectionResult result) {
        // PORTRAIT SANITY RESULT
        TVSanityResult selfieSanity = result.getSelfieSanityResult()
        if (selfieSanity != null && !selfieSanity.isGood()) {
            String error = selfieSanity.getError();
            switch (error) {
                case "image_too_blur":
                    // Image is too blurry
                case "image_too_dark":
                    // Image is too dark
                case "image_too_bright":
                    // Image is too bright
                case "not_white_background":
                    // The background is not white enough
                case "not_qualified":
                    // The face is not qualified, could be occluded, covered or having something unusal
                case "image_has_multiple_faces":
                    // Image has multiple faces
                case "image_has_no_faces":
                    // Image does not have any face
                case "right":
                    // Face is looking to the right
                case "left":
                    // Face is looking to the left
                case "open_eye,closed_eye":
                    // Right eye is closed
                case "closed_eye,open_eye":
                    // Left eye is closed
                case "open_eye,sunglasses":
                    // Sunglass covers the right eye
                case "sunglasses,open_eye":
                    // Sunglass covers the left eye
                case "closed_eye,closed_eye":
                    // Both eyes are closed
                case "closed_eye,sunglasses":
                    // Left eye is closed, sunglass covers the right eye
                case "sunglasses,closed_eye":
                    // Sunglass covers the right eye, right eye is closed
                case "sunglasses,sunglasses":
                    // Sunglasses cover both eyes

            }
        }
    }
});

// [FlowStartingFunc]: newCameraViewController, startIdCapturing, startSelfieCapturing, faceMatching

TrustVisionActivity.[FlowStartingFunc](..., builder.build(), new TVCapturingCallBack() {
    @Override
    public void onError(TVDetectionError error) {
        String message = error.getDetailErrorCode() + ":" + error.getErrorDescription();
        Log.d("", message);
        showToast(message);

        ///////////////////////////////////////
        // ERROR HANDLER
        int code = error.getErrorCode();
        String detailErrorCode = error.getDetailErrorCode();
        String description = error.getErrorDescription();

        switch code {
            case TVDetectionError.DETECTION_ERROR_AUTHENTICATION_MISSING:
                // Access key or secret is missing. Make sure the SDK is initialized
            case TVDetectionError.DETECTION_ERROR_PERMISSION_MISSING:
                // No camera permission.
            case TVDetectionError.DETECTION_ERROR_CAMERA_ERROR:
                // The camera can't be opened.
            case TVDetectionError.DETECTION_ERROR_SDK_INTERNAL:
                // The SDK has an unexpected error.
            case TVDetectionError.DETECTION_ERROR_API_ERROR:
                // API errors
                switch (detailErrorCode.toLowerCase()) {
                    // Connection errors
                    case "timeout_error":
                        // Network timeout. Poor internet connection.
                    case "network_error":
                        // Network error. No internet connection

                    // ID card OCR & Tampering errors
                    case "incorrect_card_type":
                        // the input image is not same type with selected card
                    case "nocard_or_multicard_image":
                        // the input image is no card or multi cards are detected
                    case "no_card_or_incomplete_card":
                        // the captured image may contain a part of the card or no card at all

                    // Liveness check and face matching errors
                    case "image_has_no_faces":
                        // face not detected in selfie image
                    case "image_has_multipe_faces":
                        // multiple faces are detected in selfie image

                    // Common errors that are responsed from Server
                    case "access_denied_exception":
                        // You are not authorized to perform the action.
                    case "request_time_too_skewed":
                        // The X-TV-Timestamp header is expired or the current timestamp on device is not correct, need to be updated
                    case "invalid_parameter_exception":
                        // Input parameter violates a constraint.
                    case "image_too_large_exception":
                        // The input image size exceeds the allowed limit (15MB).
                    case "invalid_image_format_exception":
                        // The provided image format is not supported (JPG/PNG)
                    case "rate_limit_exception":
                        // The number of requests exceeded your throughput limit.
                    case "internal_server_error":
                        // Some unexpected error occurs while processing the request
                }
        }
    }

    @Override
    public void onSuccess(TVDetectionResult result) {

    }
});

- **getGestureType**: the gesture type of the selfie image.
- **getFrontalImage**: the frontal image of the selfie image.
- **getGestureImage**: the gesture image of the selfie image.