• About TrustVision
  • Android SDK
  • iOS SDK
  • Flutter SDK
  • Web SDK
  • API Client Libraries
  • eKYC Platform
  • Integration Case Studies
  • TS eKYC/FA App
TrustVision API Documentation

React Native 4.0.x

1 Installation

1.1. Add Trust Vision React Native lib

Add to package.json file under dependencies group:

"react-native-trust-vision-SDK": "git+https://<github_token>:[email protected]/tsocial/<repo_name>#<version_tag_name>"

1.2. Run

$ yarn

1.3 iOS

1.3.1. Add to podfile

...
pod 'RNTrustVisionRnsdkFramework', path: '../node_modules/react-native-trust-vision-SDK'

...

# Add below lines to the end of podfile
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|
            config.build_settings['OTHER_SWIFT_FLAGS'] = '$(inherited) -no-verify-emitted-module-interface'
        end

        // you can add more modules which have the error "Undefined symbol" into the list
        if ['CocoaLumberjack', 'TensorFlowLiteC', 'TensorFlowLiteSwift', 'PromiseKit', 'CryptoSwift'].include? "#{target}"
            target.build_configurations.each do |config|
                config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
            end
        end
    end
end

1.3.2. Run

$ pod install

1.4 Android

Add to root-level build.gradle file (host app):

maven {
     url("$rootDir/../node_modules/react-native-trust-vision-SDK/android/repo")
}

eg:

allprojects {
    repositories {
        mavenLocal()
        ...
        maven {
             url("$rootDir/../node_modules/react-native-trust-vision-SDK/android/repo")
        }
        google()
        jcenter()
        maven { url 'https://jitpack.io' }
    }
}

Add to app/build.gradle

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

1.5 Usage

javascript
import { NativeEventEmitter } from "react-native";

import RNTrustVisionRnsdkFramework, {
  TVConst,
  TVErrorCode,
  TVThemeCustomization,
} from "react-native-trust-vision-SDK";

Full steps:

javascript
try {
  const initConfig = {
    jsonConfigurationByServer: jsonConfigurationByServer,
    languageCode: languageCode,
  };
  await RNTrustVisionRnsdkFramework.initializeWithConfig(initConfig);

  const tvsdkEmitter = new NativeEventEmitter(RNTrustVisionRnsdkFramework);
  // Listen to the events during the capturing
  const subscription = tvsdkEmitter.addListener("TVSDKEvent", (event) => {
    console.log("TVSDK - " + event.name + " - " + event.params.page_name);
  });

  const selfieConfig = {
    cameraOption: TVConst.SelfieCameraMode.FRONT,
    livenessMode: TVConst.LivenessMode.FLASH_ADVANCED,
    skipConfirmScreen: true,
    isEnableSound: false,
  };
  const faceAuthConfig = {
    cusUserId: "cusUserId",
    authType: TVConst.AuthenType.REGISTRATION,
    authMode: TVConst.AuthenMode.FLASH_8,
    selfieConfig: selfieConfig,
  };
  const faceAuthResult =
    await RNTrustVisionRnsdkFramework.startFaceAuthentication(faceAuthConfig);
} catch (e) {}

2. Initialize SDK

SDK needs to be initialized first

javascript
const initConfig = {
  jsonConfigurationByServer: jsonConfigurationByServer,
  languageCode: languageCode,
  theme: theme,
  endpoint: endpoint,
  accessKeyId: accessKeyId,
  accessKeySecret: accessKeySecret,
  endpointLogger: endpointLogger,
  accessKeyIdLogger: accessKeyIdLogger,
  accessKeySecretLogger: accessKeySecretLogger,
  xRequestId: xRequestId,
  xRequestId2: xRequestId2,
  imageEncryptionKey: imageEncryptionKey,
  securityPublicKey: securityPublicKey,
  flowId: flowId,
  headers: headers,
};
await RNTrustVisionRnsdkFramework.initializeWithConfig(initConfig);

Options:

  • languageCode: String the code of the language that will show and sound to user. E.g Vietnamese (vi), English ( en).
  • imageEncryptionKey: String (optional). the key to encrypt image data. It's optional. If it's null or empty then the image data will not be encrypted.
  • securityPublicKey: String (optional). the key to encrypt exif data. It's optional. If it's null or empty then the exif data will be encrypted by the default key.
  • theme: TVTheme (optional). The theme of the SDK. If it's null then the sdk will use the default theme or the theme that we customized for the client.

To call the APIs in the SDK, the host app needs to set the following parameters:

The host app will call the APIs itself, set the following parameters:

  • jsonConfigurationByServer: String. set this parameter if the host app will call the APIs itself. The jsonConfigurationByServer is the setting specialized for each client from TS server. It's the response json string get by API https://ekyc.trustingsocial.com/api-reference/customer-api/#get-client-settings. When it's null or unmatched with the expected type then the default setting in the SDK will be used.

If the log event feature is used, set the following parameters:

  • endpointLogger: String. The endpoint of the log event server.
  • accessKeyIdLogger: String. The access key id of the log event server.
  • accessKeySecretLogger: String. The secret key of the log event server.

3. Start the SDK

The SDK provides some built in functions to capture id, selfie, liveness...

3.2. Start ID card capturing

3.2.1. Set config parameters

javascript
const idConfig = {
  cardTypes: [cardType],
  cardSide: TVConst.CardSide.FRONT,
  isEnableSound: true,
  isReadBothSide: false,
  skipConfirmScreen: true,
  isEnablePhotoGalleryPicker: false,
  isEnableUploadFrames: true,
  isEnableUploadImages: true,
  isEnableSanityCheck: true,
  isEnableDetectingIdCardTampering: true,
  isEnableReadCardInfo: true,
  isEnableCheckNfcData: true,
  isEnableVerifyNfc: true,
};

Options:

  • cardTypes: [CardType]. Card types is allowed capture. List of supported cards can be found by RNTrustVisionRnsdkFramework.cardTypes after you initialize the SDK with the clientSettingsJsonString. If not, use :
javascript
const cardType = {
  id: "vn.national_id",
  name: "CMND cũ / CMND mới / CCCD",
  orientation: TVConst.Orientation.HORIZONTAL,
  hasBackSide: true,
  frontQr: {
    exist: true,
    type: "qr_code",
    widthHeightRatio: 1,
  },
};
  • cardSide: TVConst.CardSide. Card side
  • isEnableSound: bool. Sound is played or not
  • isReadBothSide: bool. Read both sides of id card or not
  • skipConfirmScreen: bool. Skip confirmation screen or not
  • isEnablePhotoGalleryPicker: bool. Allow user select id card image from phone gallery
  • isEnableScanQr: bool. Allow user scan QR code or not
  • isEnableScanNfc: bool. Allow user scan NFC or not
  • isEnableUploadFrames: boolean. Enable upload video frames or not. If it's false then the SDK won't call the API to upload the frames and the APIs that need the video frames will be skipped or called with empty frames data.
  • isEnableUploadImages: boolean. Enable upload images or not. If it's false then the SDK won't call the API to upload the images and the APIs that need the image will be skipped.
  • isEnableSanityCheck: boolean. Enable sanity check or not. If it's true then the SDK will call the API to check the sanity of the id card.
  • isEnableDetectingIdCardTampering: boolean. Enable ID Tampering Verification or not. If it's true then the SDK will call the API to check the tampering of the id card.
  • isEnableReadCardInfo: boolean. Enable read card info or not. If it's true then the SDK will call the API to read the card info.
  • isEnableCheckNfcData: boolean. Enable check NFC data or not. If it's true then the SDK will call the API to get sod and cached fields of the NFC data.
  • isEnableVerifyNfc: boolean. Enable verify NFC or not. If it's true then the SDK will call the API to verify the NFC.

3.2.2. Start flow

javascript
const result = await RNTrustVisionRnsdkFramework.startIdCapturing(config);

3.2.3. Handle Id card images

If the APIs is called by the SDK, please skip the image upload step.

if result.frontIdQr.is_required is true then result.frontIdQr.images array should be non-empty. Otherwise, clients should be warned to re-capture id card photos.

QR imagegs will be uploaded with this api: https://ekyc.trustingsocial.com/api-reference/customer-api/#upload-image

  • Fields:
    • data: result.frontIdQr.images[i].raw_image_base64
    • label: result.frontIdQr.images[i].label
    • metadata: result.frontIdQr.images[i].metadata

*The same logic will be applied to result.backIdQr

3.3. Start selfie capturing

3.3.1. Set config parameters

javascript
const config = {
  cameraOption: TVConst.SelfieCameraMode.FRONT,
  isEnableSound: true,
  livenessMode: TVConst.LivenessMode.FLASH_16,
  skipConfirmScreen: true,
  isEnableUploadFrames: true,
  isEnableUploadImages: true,
  isEnableSanityCheck: true,
  isEnableVerifyLiveness: true,
};

Options:

  • cameraOption: TVConst.SelfieCameraMode. Camera option
  • isEnableSound: bool. Sound is played or not
  • livenessMode: TVConst.LivenessMode. Liveness mode
  • skipConfirmScreen: bool. Skip confirmation screen or not
  • isEnableUploadFrames: boolean. Enable upload video frames or not. If it's false then the SDK won't call the API to upload the frames and the APIs that need the video frames will be skipped or called with empty frames data.
  • isEnableUploadImages: boolean. Enable upload images or not. If it's false then the SDK won't call the API to upload the images and the APIs that need the image will be skipped.
  • isEnableSanityCheck: boolean. Enable sanity check or not. If it's true then the SDK will call the API to check the sanity of the selfie.
  • isEnableVerifyLiveness: boolean. Enable liveness verification or not. If it's true then the SDK will call the API to verify the liveness of the selfie.

3.3.2. Start flow

javascript
const selfieCapturingResult =
  await RNTrustVisionRnsdkFramework.startSelfieCapturing(config);

3.3.3. Frame Batch recorded during the capturing.

If the APIs is called by the SDK, please skip this step.

Note: Ignore this section if Frame recording is disabled by client settings.

javascript
var frameBatchIdsDictionary = []; // this dictionary will be used for liveness verification
// frameBatchIdsDictionary.push({
//    key:   <id_returned_from_sdk>,
//    value: <id_returned_from_server>
// });

// Listen to the frame batches recorded during the capturing
const framesRecordedSubscription = tvsdkEmitter.addListener(
  "TVSDKFrameBatch",
  async (frameBatch) => {
    console.log("TVSDK - " + "FrameBatch: ", frameBatch);
    // upload frame batch to server using this api:
    // https://ekyc.trustingsocial.com/api-reference/customer-api/#upload-videoaudioframes
    const uploadingResult = await uploadFrameBatch(frameBatch);
    frameBatchIdsDictionary.push({
      key: frameBatch.batchId,
      value: uploadingResult.fileId,
    });
  }
);

3.3.4. Handle selfie capturing results

If the APIs is called by the SDK, please skip this step.

3.3.4.1 Remove invalid frame batch ids

Note: Ignore this section if Frame recording is disabled by client settings.

Only frame batches of Selfie capturing which id is containing in selfieCapturingResult.livenessFrameBatchIds are valid to be used for liveness verification.

javascript
// Remove all invalid batch ids:
Object.entries(frameBatchIdsDictionary).map(
  ([id_returned_from_sdk, id_returned_from_server]) => {
    if (
      !selfieCapturingResult.livenessFrameBatchIds.includes(
        id_returned_from_sdk
      )
    ) {
      delete frameBatchIdsDictionary[id_returned_from_sdk];
    }
  }
);
3.3.4.2. Use this api to get image id:

https://ekyc.trustingsocial.com/api-reference/customer-api/#upload-image id of frontal image i = image id of selfieCapturingResult.selfieImages[i].frontal_image.raw_image_base64 id of gesture image i = image id of selfieCapturingResult.selfieImages[i].gesture_image.raw_image_base64

3.3.4.3. Call this api to check liveness

https://ekyc.trustingsocial.com/api-reference/customer-api/#verify-face-liveness with params

  • images field, each element contains:
json
{
  "id": "<id of frontal image i>"
}
  • gesture_images field, each element contains:
json
{
  "gesture": "lower case string of <selfieCapturingResult.selfieImages[i].gesture_type>",
  "images": [
    {
      "id": "<id of gesture image i>"
    }
  ]
}
  • videos field is the list of frame batch ids returned from server, which are the values of frameBatchIdsDictionary Note: Ignore this field if Frame recording is disabled by client settings.
json
{
"id": "<frameBatchIdsDictionary's values[0]>"
},
{
"id": "<frameBatchIdsDictionary's values[1]>"
}
...
  • metadata field is selfieCapturingResult.livenessMetadata

3.4. Start QR scanning

3.4.1. Set config parameters

javascript
const config = {
  cardType: cardType,
  isEnableSound: false,
  skipConfirmScreen: true,
  cardSide: TVConst.CardSide.FRONT,
  isEnableUploadFrames: true,
  isEnableUploadImages: true,
};

Options:

  • cardType: CardType. Card type
  • cardSide: TVConst.CardSide. Card side
  • isEnableSound: bool. Sound is played or not
  • skipConfirmScreen: bool. Skip confirmation screen or not
  • isEnableUploadFrames: boolean. Enable upload video frames or not
  • isEnableUploadImages: boolean. Enable upload images or not

3.4.2. Start flow

javascript
const result = await RNTrustVisionRnsdkFramework.startQRScanning(config);

3.4.3. Upload QR images

If the APIs is called by the SDK, please skip this step.

if result.frontIdQr.isRequired is true then result.frontIdQr.images array should be non-empty. Otherwise, clients should be warned to re-scan QR code.

QR images will be uploaded with this api: https://ekyc.trustingsocial.com/api-reference/customer-api/#upload-image

javascript
const frontQrImage = result.frontIdQr.images[i];
const metadata = frontQrImage.metadata;
const label = frontQrImage.label;
const data = frontQrImage.imageByteArray;

*The same logic will be applied to result.backIdQr

3.5. Start NFC scanning

3.5.1. Set config parameters

javascript
const config = {
  nfcCode: nfcCode,
  hashSod: sod,
  issueDate: issueDate,
  cachedFields: cachedFields,
  isRequestReadImageNfc: true,
  isRequestIntegrityCheckNfc: true,
  isRequestCloneDetectionNfc: true,
  nfcMaxRetries: 5,
  isEnableCheckNfcData: true,
  isEnableVerifyNfc: true,
};

Options:

  • nfcCode: String is the id number of ID card
  • hashSod: String (optional) is the hash of SOD
  • issueDate: String (optional) is the issue date of ID card (DD/MM/YYYY)
  • cachedFields: List<String> (optional) is the list of fields that was cached from previous scanning
  • isRequestReadImageNfc: boolean (optional) read image in the chip when scan nfc or not
  • isRequestIntegrityCheckNfc: boolean (optional) check integrity of the chip when scanning nfc or not
  • isRequestCloneDetectionNfc: boolean (optional) check clone of the chip when scanning nfc or not
  • nfcMaxRetries: Int. (optional) The maximum number of times the SDK retries an NFC scanning before giving up
  • isEnableCheckNfcData: boolean. Enable check NFC data or not. If it's true then the SDK will call the API to get sod and cached fields of the NFC data.
  • isEnableVerifyNfc: boolean. Enable verify NFC or not. If it's true then the SDK will call the API to verify the NFC data.

3.5.2. Start flow

javascript
const result = await RNTrustVisionRnsdkFramework.startNfcScanning(config);

3.6 Start Face Authentication

3.6.1 Set config parameters

javascript
const selfieConfig = {
  cameraOption: TVConst.SelfieCameraMode.FRONT,
  livenessMode: TVConst.LivenessMode.FLASH_ADVANCED,
  skipConfirmScreen: true,
  isEnableSound: false,
};
const config = {
  cusUserId: "cusUserId",
  authType: TVConst.AuthenType.REGISTRATION,
  authMode: TVConst.AuthenMode.FLASH_ADVANCED,
  isEnableFaceAuthentication: true,
  isEnableFaceRegistration: true,
  selfieConfig: selfieConfig,
};
  • cusUserId: String. The customer user id
  • authType: AuthType. Type of authentication, AUTH or REGISTRATION
  • authMode: TVAuthMode. The source of authentication process, it might be Nfc or Selfie
  • selfieConfig: TVSelfieConfiguration. The configuration of selfie capturing
  • isEnableFaceAuthentication: boolean. Enable call API face authentication or not
  • isEnableFaceRegistration: boolean. Enable call API face registration or not

3.6.2 Start flow

javascript
await RNTrustVisionRnsdkFramework.startFaceAuthentication(config);

4. Result Handling:

  • result:

    • cardType: CardType. Card type

    • actionMode: TVConst.ActionMode. Action Mode

    • selfieImages: [SelfieImage]. List of selfie image objects

    • livenessVideos: [Base64 String]. List of liveness videos data base64

    • livenessMetadata: json

    • livenessVideoFramesList: [json]

    • idFrontImage: ImageClass. Id front image object

    • idBackImage: ImageClass. Id back image object

    • frontIdQr: TVCardQr. Front Id card's QR info

    • backIdQr: TVCardQr. Back Id card's QR info

    • frontIdCapturingVideoFramesList: json

    • backIdCapturingVideoFramesList: json

    • nfcInfoResult: TVNfcInfoResult. NFC info result

    • faceAuthRegisterResult: TVFaceAuthRegisterResult

    • faceAuthResult: TVFaceAuthResult

  • SelfieImage:

    • gesture_type: String. UP | DOWN | LEFT | RIGHT | FRONTAL
    • frontal_image: ImageClass. Frontal image object
    • gesture_image: ImageClass. Gesture image object
  • ImageClass:

    • raw_image_base64: String. Base64 string of image data
    • label: String. Image label
    • metadata: json. Image metadata
  • TVCardQr:

    • is_required: Bool. This side of card contains QR or not
    • images: [ImageClass]. QR images
  • Error:

    • errorCode: String. The specific error code
    • description: String. The human-readable error description can be show to end user
  • TVNfcInfoResult:

    • com: String
    • sod: String
    • dg1: String
    • dg2: String
    • dg13: String
    • dg14: String
    • dg15: String
    • verificationResult: TVNfcVerificationResult
  • TVNfcVerificationResult:

    • cloneStatus: TVNfcVerificationResultStatus
  • TVNfcVerificationResultStatus:

    • error: TVError
    • verdict: TVNfcVerdict. TVNfcVerdict.notChecked | TVNfcVerdict.alert | TVNfcVerdict.good | TVNfcVerdict.error
  • TVFaceAuthRegisterResult:

    • requestId: String
    • status: String. success | failure
  • TVFaceAuthResult:

    • requestId: String
    • status: String. success | failure
    • score: Float
    • matchResult: MatchResult. MatchResult.match | MatchResult.unmatched | MatchResult.unsure

5. UI Customization

This document introduces how to enable the ability to customize UI components of TrustingVision SDK.

5.1 Default UI prototypes

Check out the default UI of TrustingVision SDK. We provide you the ability to change and modify many UI components: background colors, font interfaces, font sizes, icons, buttons.

5.2 Before initialize the SDK

Initialize and change properties of TVTheme class. If any of which is not set, it will get default value.

After that, input the instance of TVTheme as a parameter of the TV SDK's initialization method. See Initialize TV SDK

TVTheme let you custom and override attributes, which includes:

Properties/FunctionsTypeDescription
idCapturingThemeTVIdCapturingThemeAttributes that change the UI of ID Card Detection screen.
idConfirmationThemeTVIdConfirmationThemeAttributes that change the UI of ID Confirmation screen.
selfieCapturingThemeTVSelfieCapturingThemeAttributes that change the UI of Selfie Capturing screen.
selfieConfirmationThemeTVSelfieConfirmationThemeAttributes that change the UI of Selfie Confirmation screen.
qrGuidelinePopupThemeTVQrPopupThemeModifying UI of QR guideline popup.
qrRetryPopupThemeTVQrPopupThemeModifying UI of QR retry popup.

5.3 Common UI components

Object TVThemeDefaultValues helps you to quickly change some common UI components that will be used across the whole SDK.

In case a specific Screen's theme is set, it will override TVThemeDefaultValues's properties.

PropertiesTypeDescription
normalLabelThemeTVLabelThemeNormal text of SDK.
titleLabelThemeTVLabelThemeThe title of every screen (located on the top-most, centered of screen).
errorLabelThemeTVLabelThemeThis text is shown as if any user misconduction or system failure occurred during the detection process.
instructionLabelThemeTVLabelThemeInstruction text.
timeoutLabelThemeTVLabelThemeThe count down text.

The object TVLabelTheme can be described in this table below:

Properties/FunctionsTypeLabel's
fontStyleStringfont style, valid values: "REGULAR", "BOLD", "BOLD_ITALIC", "ITALIC"
textSizeFloattext size
textColorString
(hex color e.g "#FFFFFF")
text color
textGravityStringtext alignment of its frame.
Valid values: "CENTER", "LEFT", "RIGHT"
backgroundColors[String]
(array of hex colors e.g ["#00FFFFFF", "#000000"])
background colors. If total elements of this array is >= 2, the background color is gradient, else it'd be solid.
isBackgroundGradientHorizontalBooleanbackground gradient direction
cornerRadiusFloatrounded corner
isHiddenBooleanwhether or not should hide the label
borderWidthFloatborder width
borderColorString
(hex color e.g "#00FFFFFF")
border color

5.4 ID Card Detection: UI customization

alt text

Class TVIdCapturingTheme

If a property is not set then the default value will be used.

Properties/FunctionsTypeDescription
titleLabelThemeTVLabelThemeSee Common UI components section.
instructionLabelThemeTVLabelTheme
errorLabelThemeTVLabelTheme
timeoutLabelThemeTVLabelTheme
normalLabelThemeTVLabelTheme
qrInstructionLabelThemeTVLabelThemeThe instruction text that show during QR scanning process.
closeButtonLocationStringThe position of close button to device orientation:

TOP_LEFT: to the left of the title
TOP_RIGHT: to the right of the title
NONE: hide the button
showTrademarkBooleanShow the trademark text or not.
backgroundColorString
(hex color e.g "#FFFFFF")
Background color of the screen. Default value is black with 60% opacity.
captureButtonImageString
(Base64 encoding)
The image of the capture button.
captureButtonDisableImageString
(Base64 encoding)
The image of the disabled capture button.
closeButtonImageString
(Base64 encoding)
The image of the close view button.
maskViewNeutralImageString
(Base64 encoding)
The mask image of camera view when start the ID Capture flow.
maskViewSuccessImageString
(Base64 encoding)
The mask image of camera view when detected a valid ID card.
maskViewErrorImageString
(Base64 encoding)
The mask image of camera view when cannot detect any ID card.
qrInstructionBackgroundImageString
(Base64 encoding)
The image behind the QR instruction text.
qrMaskViewNeutralImageString
(Base64 encoding)
The mask image of camera view when start QR detection or not detected any QR code.
qrMaskViewSuccessImageString
(Base64 encoding)
The mask image of camera view when detected a valid QR code.
qrMaskViewErrorImageString
(Base64 encoding)
The mask image of camera view when detected an invalid QR code.
loadingImageString
(Base64 encoding)
Loading indicator in image.

5.5 ID Card Confirmation: UI customization

alt text

Class TVIdConfirmationTheme

If a property is not set then the default value will be used.

Properties/FunctionsTypeDescription
titleLabelThemeTVLabelThemeSee Common UI components section.
errorLabelThemeTVLabelTheme
normalLabelThemeTVLabelTheme
closeButtonLocationStringThe position of close button to device orientation:
TOP_LEFT: to the left of the title
TOP_RIGHT: to the right of the title
NONE: hide the button
showTrademarkBooleanShow the trademark text or not.
backgroundColorString
(hex color e.g "#FFFFFF")
Background color of the screen. Default value is black with 60% opacity.
.
closeButtonImageString
(Base64 encoding)
The image of the close view button.
confirmButtonImageString
(Base64 encoding)
The image of the "Look good" button.
retryButtonImageString
(Base64 encoding)
The image of the "Try again" button.
icQrResultSuccessImageString
(Base64 encoding)
Icon before text that scanned QR successfully.
icQrResultErrorImageString
(Base64 encoding)
Icon before text that scanned QR failed.
maskViewImageString
(Base64 encoding)
The mask image of camera view showing captured image.
loadingImageString
(Base64 encoding)
Loading indicator in image.

5.6 Selfie Capturing: UI customization

alt text

Class TVSelfieCapturingTheme

If a property is not set then the default value will be used.

Properties/FunctionsTypeDescription
titleLabelThemeTVLabelThemeSee Common UI components section.
instructionLabelThemeTVLabelTheme
errorLabelThemeTVLabelTheme
timeoutLabelThemeTVLabelTheme
normalLabelThemeTVLabelTheme
closeButtonLocationStringThe position of close button to device orientation:
TOP_LEFT: to the left of the title
TOP_RIGHT: to the right of the title
NONE: hide the button
showTrademarkBooleanShow the trademark text or not.
backgroundColorString
(hex color e.g "#FFFFFF")
Background color of the screen. Default value is black with 60% opacity.
captureButtonImageString
(Base64 encoding)
The image of the capture button.
captureButtonDisableImageString
(Base64 encoding)
The image of the disabled capture button.
closeButtonImageString
(Base64 encoding)
The image of the close view button.
switchCameraSideImage String
(Base64 encoding)
The image of switch camera button.
maskViewNeutralImageString
(Base64 encoding)
The mask image of camera view when start the selfie flow.
maskViewSuccessImage String
(Base64 encoding)
The mask image of camera view when detected a valid face.
maskViewErrorImageString
(Base64 encoding)
The mask image of camera view when cannot detect any valid face.
progressTheme.isHiddenBooleanWhether or not should hide the current 4 steps view.
progressTheme.backgroundColorString
(hex color e.g "#00FFFFFF")
Background color of the circle progress theme.
progressTheme.progressColorString
(hex color e.g "#00FFFFFF")
Background color of the progress steps.
gestureTheme.isHiddenBooleanWhether of not should hide selfie steps' group view.
gestureTheme.turnLeftActiveImageString
(Base64 encoding)
Image for turn left step gesture when active.
gestureTheme.turnRightActiveImageString
(Base64 encoding)
Image for turn right step gesture when active.
gestureTheme.turnUpActiveImageString
(Base64 encoding)
Image for turn up step gesture when active.
gestureTheme.turnDownActiveImageString
(Base64 encoding)
Image for turn down step gesture when active.
gestureTheme.lookStraightActiveImageString
(Base64 encoding)
Image for look straight step gesture when active.
gestureTheme.turnLeftInactiveImageString
(Base64 encoding)
Image for turn left step gesture when inactive.
gestureTheme.turnRightInactiveImageString
(Base64 encoding)
Image for turn right step gesture when inactive.
gestureTheme.turnUpInactiveImageString
(Base64 encoding)
Image for turn up step gesture when inactive.
gestureTheme.turnDownInactiveImageString
(Base64 encoding)
Image for turn down step gesture when inactive.
gestureTheme.lookStraightInactiveImageString
(Base64 encoding)
Image for look straight step gesture when inactive.
gestureTheme.finishedGestureBackgroundImageString
(Base64 encoding)
Background for every step that completed.
gestureTheme.currentStepFocusImageString
(Base64 encoding)
Image overlay for current step indicator.
maskViewErrorImageString
(Base64 encoding)
The mask image of camera view when cannot detect any valid face.
maskViewErrorImageString
(Base64 encoding)
The mask image of camera view when cannot detect any valid face.
loadingImageString
(Base64 encoding)
Loading indicator in image.

5.7 Selfie Confirmation: UI customization

alt text

Class TVSelfieConfirmationTheme

If a property is not set then the default value will be used.

Properties/FunctionsTypeDescription
titleLabelThemeTVLabelThemeSee Common UI components section.
normalLabelThemeTVLabelTheme
closeButtonLocationStringThe position of close button to device orientation:
TOP_LEFT: to the left of the title
TOP_RIGHT: to the right of the title
NONE: hide the button
showTrademarkBooleanShow the trademark text or not.
backgroundColorString
(hex color e.g "#00FFFFFF")
Background color of the screen. Default value is black with 60% opacity.
closeButtonImageString
(Base64 encoding)
The image of the close view button.
maskViewImage String
(Base64 encoding)
The mask image of selfie captured image.
loadingImageString
(Base64 encoding)
Loading indicator in image.

5.8 QR Popup: UI customization

alt text

Class TVQrPopupTheme

If a property is not set then the default value will be used.

Properties/FunctionsTypeDescription
titleLabelThemeTVLabelThemeSee Common UI components section.
descriptionThemeTVLabelThemeTheme of description text.
primaryButtonThemeTVLabelThemeTheme of the main button of popup.
secondaryButtonThemeTVLabelThemeTheme of sub-button of popup.
timeoutLabelThemeTVLabelThemeTheme of timeout-warning text.
backgroundColorString
(hex color e.g "#FFFFFF")
Background color of the view.

5.9 UI Customization example

javascript
const customizedTVTheme = () => {
  const normalTextSize = 14.0;
  const labelBackgroundColors = ["#00ffffff"]; // transparent. Set multiple colors if you want gradient
  const normalLabelTextColor = "#ffffff"; // white
  const errorLabelTextColor = "#ff0000"; //red
  const labelBorderColor = "#00ffffff"; // transparent
  const screenBackgroundColor = "#0D0D51"; // blue
  const labelBorderWidth = 1.0;
  const labelPaddingHorizontal = 10.0;
  const labelPaddingVertical = 5.0;
  const cornerRadius = 0.0;

  const normalLabelTheme = {
    isHidden: false,
    textSize: normalTextSize,
    fontStyle: TVThemeCustomization.FontStyle.REGULAR,
    textColor: normalLabelTextColor,
    backgroundColors: labelBackgroundColors,
    isBackgroundGradientHorizontal: false,
    cornerRadius: cornerRadius,
    borderWidth: labelBorderWidth,
    borderColor: labelBorderColor, // transparent
    paddingHorizontal: labelPaddingHorizontal,
    paddingVertical: labelPaddingVertical,
    textGravity: TVThemeCustomization.TextGravity.CENTER,
  };

  const titleLabelTheme = {};
  Object.assign(titleLabelTheme, normalLabelTheme);
  titleLabelTheme["textSize"] = 16.0;
  titleLabelTheme["fontStyle"] = TVThemeCustomization.FontStyle.BOLD;

  const errorLabelTheme = {};
  Object.assign(errorLabelTheme, normalLabelTheme);
  errorLabelTheme["textSize"] = 12.0;
  errorLabelTheme["textColor"] = errorLabelTextColor;

  const timeoutLabelTheme = {};
  Object.assign(timeoutLabelTheme, errorLabelTheme);
  timeoutLabelTheme["isHidden"] = true;

  const idCapturingTheme = {
    titleLabelTheme: titleLabelTheme,
    instructionLabelTheme: normalLabelTheme,
    errorLabelTheme: errorLabelTheme,
    timeoutLabelTheme: timeoutLabelTheme,
    normalLabelTheme: normalLabelTheme,
    closeButtonLocation: TVThemeCustomization.ButtonLocation.TOP_LEFT,
    backgroundColor: "#80000000", // 50% black
    captureButtonImage: "your_base64_image",
    captureButtonDisableImage: "your_base64_image",
    closeButtonImage: "your_base64_image",
    maskViewNeutralImage: "your_base64_image",
    maskViewSuccessImage: "your_base64_image",
    maskViewErrorImage: "your_base64_image",
    loadingImage: "your_base64_image",
    qrInstructionLabelTheme: normalLabelTheme,
    qrInstructionBackgroundImage: "your_base64_image",
    qrMaskViewNeutralImage: "your_base64_image",
    qrMaskViewSuccessImage: "your_base64_image",
    qrMaskViewErrorImage: "your_base64_image",
  };

  const idConfirmationTheme = {
    titleLabelTheme: titleLabelTheme,
    errorLabelTheme: errorLabelTheme,
    normalLabelTheme: normalLabelTheme,
    closeButtonLocation: TVThemeCustomization.ButtonLocation.TOP_LEFT,
    backgroundColor: screenBackgroundColor,
    closeButtonImage: "your_base64_image",
    icQrResultSuccessImage: "your_base64_image",
    icQrResultErrorImage: "your_base64_image",
    confirmButtonImage: "your_base64_image",
    retryButtonImage: "your_base64_image",
    maskViewImage: "your_base64_image",
    loadingImage: "your_base64_image",
  };

  const gestureTheme = {
    currentStepFocusImage: "your_base64_image",
    turnLeftActiveImage: "your_base64_image",
    finishedGestureBackgroundImage: "your_base64_image",
    turnRightActiveImage: "your_base64_image",
    turnUpActiveImage: "your_base64_image",
    turnDownActiveImage: "your_base64_image",
    lookStraightActiveImage: "your_base64_image",
    turnLeftInactiveImage: "your_base64_image",
    turnRightInactiveImage: "your_base64_image",
    turnUpInactiveImage: "your_base64_image",
    turnDownInactiveImage: "your_base64_image",
    lookStraightInactiveImage: "your_base64_image",
  };

  const selfieCapturingTheme = {
    titleLabelTheme: titleLabelTheme,
    instructionLabelTheme: normalLabelTheme,
    errorLabelTheme: errorLabelTheme,
    timeoutLabelTheme: timeoutLabelTheme,
    normalLabelTheme: normalLabelTheme,
    closeButtonLocation: TVThemeCustomization.ButtonLocation.TOP_LEFT,
    gestureTheme: gestureTheme,
    backgroundColor: screenBackgroundColor,
    captureButtonImage: "your_base64_image",
    captureButtonDisableImage: "your_base64_image",
    closeButtonImage: "your_base64_image",
    maskViewNeutralImage: "your_base64_image",
    maskViewSuccessImage: "your_base64_image",
    maskViewErrorImage: "your_base64_image",
    loadingImage: "your_base64_image",
    switchCameraSideImage: "your_base64_image",
  };

  const selfieConfirmationTheme = {
    titleLabelTheme: titleLabelTheme,
    instructionLabelTheme: normalLabelTheme,
    errorLabelTheme: errorLabelTheme,
    normalLabelTheme: normalLabelTheme,
    closeButtonLocation: TVThemeCustomization.ButtonLocation.TOP_LEFT,
    backgroundColor: screenBackgroundColor,
    closeButtonImage: "your_base64_image",
    confirmButtonImage: "your_base64_image",
    retryButtonImage: "your_base64_image",
    maskViewImage: "your_base64_image",
    loadingImage: "your_base64_image",
  };

  const qrPopupLabelTheme = {
    textSize: 16.0,
    textColor: "#99002F75" /* 60% opacity */,
  };

  const qrPopupPrimaryButtonTheme = {
    cornerRadius: 3.0,
    textSize: 16.0,
    textColor: "#ffffff",
    backgroundColors: ["#0276F1"], // set multiple color if you want gradients
  };

  const qrGuidelinePopupTheme = {
    backgroundColor: "#ffffff",
    headerImage: "your_base64_image",
    titleLabelTheme: { isHidden: true }, // hide label,
    descriptionTheme: qrPopupLabelTheme,
    primaryButtonTheme: qrPopupPrimaryButtonTheme,
    secondaryButtonTheme: { isHidden: true }, // hide button
    timeoutLabelTheme: qrPopupLabelTheme,
  };

  const qrRetryPopupTheme = {
    backgroundColor: "#ffffff",
    headerImage: "your_base64_image",
    titleLabelTheme: qrPopupLabelTheme,
    descriptionTheme: qrPopupLabelTheme,
    primaryButtonTheme: qrPopupLabelTheme,
    secondaryButtonTheme: qrPopupLabelTheme,
    timeoutLabelTheme: { isHidden: true }, // hide label
  };

  const tvTheme = {
    idCapturingTheme: idCapturingTheme,
    idConfirmationTheme: idConfirmationTheme,
    selfieCapturingTheme: selfieCapturingTheme,
    selfieConfirmationTheme: selfieConfirmationTheme,
    qrGuidelinePopupTheme: qrGuidelinePopupTheme,
    qrRetryPopupTheme: qrRetryPopupTheme,
  };

  return tvTheme;
};