Mobbeel for developers

Mobbeel for developers

  • MobbScan
  • MobbID
  • MobbSign
  • Clients
  • FAQ

›Additional configuration

MobbScan Android SDK

  • Configure MobbScan Android SDK

Getting Started

  • Getting started with MobbScan
  • Detect and scan a document in two different calls
  • Detect and scan MRZ
  • Detect and scan a PDF417
  • Scanning documents with NFC
  • Error Handling

Additional configuration

  • Configure the detection process
  • Perform face matching with MobbScan
  • Select images returned by a scan
  • Fix scan orientation
  • Record a video while user performs a scan
  • Adding a video step
  • Configure Play Store distribution

MobbScan UI customization

  • Customize MobbScan Default Interfaces
  • Customize MobbScan document scan UI
  • Customize MobbScan MRZ scan UI
  • Customize Unattended Process UI
  • Customize feedback messages

MobbScan-Agent configurations

  • Getting the verification result

Migration Guides

  • Migration 2.25.x to 2.26.x
  • Migration 2.24.x to 2.25.x
  • Migration to 2.24.x
  • Migration to 2.22.x
  • Migration 2.19.x to 2.21.x
  • Migration 2.18.x to 2.19.x
  • Migration 2.13.x to 2.14.x

Information

  • Changelog
  • API Reference

Record a video while user performs a scan

MobbScan offers you the possibility to record an unattended video of the user while performing the verification process.

Configuration

Before adding the unattended video to your application, you should modify the following:

  1. configure an extra dependency in your build.gradle configuration file (dependencies section).

    dependencies {
        ...
        implementation 'com.twilio:video-android:7.6.1'
        ...
    }
    
  2. Add required permission in the AndroidManifest.xml of your project:

    <!-- Required to record audio -->
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    

Adding the recording process

MobbScan provides you with a default activity that will open a new

Kotlin
Java
MobbScanAPI.getInstance().startUnattendedVideo(scanId) { result, resultData, error ->
// Your finished listener code here
}
MobbScanAPI.getInstance().startUnattendedVideo(scanId, new VideoUnattendedFinishedListener() {
@Override
public void onFinished(VideoUnattendedResult result, MobbScanVideoDetectionResultData resultData, MobbScanAPIError error) {
// Your finished listener code here...
}
});

Configuring timeout

This process depends on the user to scan the document in order to finish recording the video. In order to keep the video between some time and size limits, the unattended video process has a timeout.

This timeout is by default set at 3 minutes.

If you want to change this value, you can use the following method call instead of the regular one:

Kotlin
Java
MobbScanAPI.getInstance().startUnattendedVideo(scanId, YOUR_TIMEOUT_IN_SECONDS) { result, resultData, error ->
// Your finished listener code here
}
MobbScanAPI.getInstance().startUnattendedVideo(scanId, YOUR_TIMEOUT_IN_SECONDS, new VideoUnattendedFinishedListener() {
@Override
public void onFinished(VideoUnattendedResult result, MobbScanVideoDetectionResultData resultData, MobbScanAPIError error) {
// Your finished listener code here...
}
});

NOTE: The timeout should be between 1 and 5 minutes. Otherwise, the SDK will throw an IllegalStateException.

Customizing the recording UI

Customize default UI

You can customize the colors, sizes and font family of the default UI overriding the values of the following files:

  • colors.xml:
    <color name="unattended_spinner_color">#FF3D6B</color>
    <color name="unattended_action_title_color">#FFFFFF</color>
    <color name="unattended_countdown_color">#FFFFFF</color>
    <color name="unattended_configure_background_color">#FFFFFF</color>
    <color name="unattended_configure_title_color">#2C2B2B</color>
    <color name="background_default_color">#95000000</color>
    <color name="rectangle_default_color">#FFFFFF</color>
    <color name="rectangle_detect_color">#3FC336</color>
    <color name="text_color">#FFFFFF</color>
    <color name="mrz_text_green">#ADFF2F</color>
    <color name="face_overlay_color">#80FFFFFF</color>
    <color name="face_outline_color">#FFFFFF</color>
    <color name="face_progress_color">#55D672</color>
    <color name="face_recording_color">#E0263B</color>
  • dimens.xml:
    <dimen name="unattended_action_text_size">18sp</dimen>
    <dimen name="unattended_countdown_text_size">40sp</dimen>
    <dimen name="unattended_configure_title_text_size">18sp</dimen>
    <dimen name="rectangle_detector_border_size">4dp</dimen>
    <dimen name="face_detector_border_size">10dp</dimen>
  • styles.xml:
    <style name="UnattendedVideoTheme" parent="@android:style/Theme.NoTitleBar.Fullscreen">
        <item name="android:fontFamily">sans-serif-light</item>
        <item name="unattended_configure_service_bg">@color/unattended_configure_background_color</item>
        <item name="unattended_configure_service_text_size">@dimen/unattended_configure_title_text_size</item>
        <item name="unattended_configure_service_text_color">@color/unattended_configure_title_color</item>
        <item name="unattended_detection_bg">@color/background_default_color</item>
        <item name="unattended_detection_rectangle_base_color">@color/rectangle_default_color</item>
        <item name="unattended_detection_rectangle_detected_color">@color/rectangle_detect_color</item>
        <item name="unattended_detection_action_text_size">@dimen/unattended_action_text_size</item>
        <item name="unattended_detection_action_text_color">@color/unattended_action_title_color</item>
        <item name="unattended_detection_countdown_text_size">@dimen/unattended_countdown_text_size</item>
        <item name="unattended_detection_countdown_text_color">@color/unattended_countdown_color</item>
    </style>

Add a back arrow

In case you want to show a back arrow in the top left corner of the unattended video screen, MobbScan provides you with this option.

In order to activate it, you have to perform the next call to the MobbscanConfiguration object you can pass to the initAPI method. If you do not know how to use this object, please refer to configure detection process for more information.

Kotlin
Java
val mobbScanConfiguration = MobbScanConfiguration()
mobbScanConfiguration.activateUnattendedBackButton()

MobbScanAPI.getInstance().initAPI(YOUR_LICENSE, YOUR_CONTEXT, LICENSE_LISTENER, mobbScanConfiguration)
MobbScanConfiguration mobbScanConfiguration = new MobbScanConfiguration();
mobbScanConfiguration.activateUnattendedBackButton();

MobbScanAPI.getInstance().initAPI(YOUR_LICENSE, YOUR_CONTEXT, LICENSE_LISTENER, mobbScanConfiguration);

Making this method call will show an arrow in the default activity. When clicked, this button will make the exact same actions as the system's navbar back button. This action is not configurable at the moment.

Configure Back Button icon

If you want to change the icon of the newly added back button, you only have to create a drawable resource in your app with the following name: unattended_back_button_image.

This will override the default icon that the SDK shows and will place yours in its place.

← Fix scan orientationAdding a video step →
  • Configuration
  • Adding the recording process
    • Configuring timeout
  • Customizing the recording UI
    • Customize default UI
    • Add a back arrow
Mobbeel for developers
Product Documentation
MobbIDMobbScanMobbSign
Connect
LinkedInFacebookX
More
FAQContact Us
Mobbeel Solutions SL
Copyright © 2025 Mobbeel Solutions SL