Dynamsoft Camera Enhancer User Guide for Android (Java)

The Dynamsoft Camera Enhancer Android SDK enables you to easily control cameras from your Android applications to stream live video and acquire realtime frames.

Example Usage

See how Dynamsoft Camera Enhancer helps in camera control and video recognition:

Barcode scanning from video stream: check Dynamsoft Barcode Reader Android User Guide

Step-by-step guide on how to integrate Dynamsoft Camera Enhancer SDK to your Android app:

App Prerequisites

System Requirements:
- Supported OS: Android 5 or higher (Android 7 or higher recommended).
- Supported ABI: arm64-v8a/armeabi-v7a/x86/x86_64.
Environment: Android Studio 3.4+.

Installation

If you don’t have SDK yet, please download the Dynamsoft Camera Enhancer(DCE) SDK from the Dynamsoft website and unzip the package. After decompression, the root directory of the DCE installation package is DynamsoftCameraEnhancer, which is represented by [INSTALLATION FOLDER].

Build Your First Application

The following sample will demonstrate how to acquire a frame from video streaming by DCE.

Note:

The following steps are completed in Android Studio 4.2.

You can download the similar complete source code from Here.

For more samples on using Dynamsoft Camera Enhancer supporting Barcode Reader please click here.

Create a New Project

Open Android Studio and select New Project… in the File > New > New Project… menu to create a new project.
Choose the correct template for your project. In this sample, we’ll use Empty Activity.
When prompted, choose your app name (HelloWorld) and set the Save location, Language, and Minimum SDK (21)

Note: With minSdkVersion set to 21, your app is available on more than 94.1% of devices on the Google Play Store (last update: March 2021).

Include the library

There are two ways to include the Dynamsoft Camera Enhancer SDK into your project:

Local Binary Dependency

Copy the file [INSTALLATION FOLDER]\Lib\DynamsoftCameraEnhancerAndroid.aar to the target directory HelloWorld\app\libs

Open the file HelloWorld\app\build.gradle, and add reference in the dependencies:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.aar'])
}

Click Sync Now. After the synchronization completes, the SDK is added to the project.
import the package int the file MainActivity.java
```
import com.dynamsoft.dce.*;
```

Remote Binary Dependency

Open the file HelloWorld\app\build.gradle, and add the remote repository:

repositories {
    maven {
        url "https://download2.dynamsoft.com/maven/aar"
    }
}

Add reference in the dependencies:

dependencies {
    implementation 'com.dynamsoft:dynamsoftcameraenhancer:4.0.2@aar'
}

Click Sync Now. After the synchronization completes, the SDK is added to the project.
import the package in the file MainActivity.java
```
 import com.dynamsoft.dce.*;
```

License Activation (Optional)

A valid license is required when using the following features:

Frame Sharpness Filter
Sensor Filter
Auto Zoom
Enhanced Focus
Fast Mode
Smart torch

The above features are enabled by triggering method enableFeatures. If you are not using these features, you can skip the license activation step.

To activate the license:

Include the library

dependencies {
    implementation 'com.dynamsoft:dynamsoftlicense:3.0.10@aar'
}

Initialize the license in your code.

LicenseManager.initLicense(LICENSE, this, (isSuccess, error) -> {
    if (!isSuccess) {
        Log.e(TAG, "InitLicense Error: " + error);
    }
});

Note:

Network connection is required for the license to work.

“DLS2***” is a time-limited public trial license used in the sample.

If the license has expired, please request a trial license through the customer portal.

Create Camera View

In the Project window, open app > res > layout > activity_main.xml, create a DCE camera view section under the root node.

 <com.dynamsoft.dce.CameraView
     android:id="@+id/cameraView"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     tools:layout_editor_absoluteX="25dp"
     tools:layout_editor_absoluteY="0dp" />

Initialize the camera view, and bind to the Camera Enhancer object.

 private CameraView cameraView;
 ...
 mCameraView = findViewById(R.id.cameraView);

Initialize the CameraEnhancer and Bind the CameraView

Create an instance of Dynamsoft Camera Enhancer

CameraEnhancer mCameraEnhancer;
mCameraEnhancer = new CameraEnhancer(cameraView, this);

Add Code to Open the Camera

Override the MainActivity.onResume and MainActivity.onPause function to open and close camera.

@Override
protected void onResume() {
    super.onResume();
    needCapture = false;
    try {
        // open the default camera.
        mCameraEnhancer.open();
    } catch (CameraEnhancerException e) {
        e.printStackTrace();
    }
}
@Override
protected void onPause() {
    super.onPause();
    try {
        // close the default camera.
        mCameraEnhancer.close();
    } catch (CameraEnhancerException e) {
        e.printStackTrace();
    }
}

Capture Frame

In the Project window, open app > res > layout > activity_main.xml, and add a Button to capture frame.

<Button
    android:id="@+id/btn_capture"
    android:layout_width="70dp"
    android:layout_height="70dp"
    android:layout_alignParentBottom="true"
    android:layout_centerHorizontal="true"
    android:layout_marginBottom="25dp"
    android:background="@drawable/icon_capture"/>

Add UI variables and event response codes

Button btnCapture;
...
btnCapture = findViewById(R.id.btn_capture);

btnCapture.setOnClickListener(v -> {
    // Here we just set a flag, the actual capture action will be executed in the `frameOutputCallback`
    needCapture = true;
});

Add a frame listener to acquire the latest frame from video streaming. Here we capture a frame and show it on the other activity(ShowPictureActivity).

static ImageData mFrame;
...
mCameraEnhancer.addListener((frame, nowTime) -> {
    if(needCapture){
        needCapture = false;

        // Capture a frame, display it in the image view of the other activity.
        mFrame = frame;
        Intent intent = new Intent(MainActivity.this,ShowPictureActivity.class);
        startActivity(intent);
    }
});

Additional Steps

In the Project window, open app > res > layout > activity_show_picture.xml, and add a ImageView.

<ImageView
    android:id="@+id/iv_picture"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    />

Display the captured frame in ImageView.

public class ShowPictureActivity extends AppCompatActivity {
    private Toolbar toolbar;
    ImageView ivPicture;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_show_picture);
        ivPicture = findViewById(R.id.iv_picture);
   
        toolbar = findViewById(R.id.toolbar);
        toolbar.setNavigationOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                onBackPressed();
            }
        });
        ImageData frame = MainActivity.mFrame;
        // Convert to Bitmap from the captured frame.
        Bitmap bitmap = null;
        try {
            bitmap = frame.toBitmap();
        } catch (CoreException e) {
            e.printStackTrace();
        }
        // Display it in ImageView
        ivPicture.setImageBitmap(bitmap);
    }
   
}

Build and Run the Project

Select the device that you want to run your app on from the target device drop-down menu in the toolbar.
Click Run app button, then Android Studio installs your app on your connected device and starts it.

Note:

You can download the similar complete source code from Here.

For more samples on using Dynamsoft Camera Enhancer supporting Barcode Reader please click here.