5.8
Show scanner
This page covers the description of how to open the camera activity
Show scanner
After the initialization is completed and the scenario is set, you can start document scanning process. There are several options on how to open the camera activity.
#1
Use this method to open camera preview activity using the default back camera, which will pass frames for recognition and return results in the completion block when they are ready. Activity will be opened from the context which has been passed to the method:
Java
Kotlin
1
DocumentReader.Instance().showScanner(MainActivity.this, completion);
Copied!
1
DocumentReader.Instance().showScanner(this@MainActivity, completion)
Copied!
#2
Use this method to open camera preview activity using the specified camera, which will pass frames for recognition and return results in the completion block when they are ready. Activity will be opened from the context which has been passed to the method:
Java
Kotlin
1
DocumentReader.Instance().showScanner(MainActivity.this, 0, completion);
Copied!
1
DocumentReader.Instance().showScanner(this@MainActivity, 0, completion)
Copied!
Completion callback
The current results are returned in the completion block from each camera shot with different actions (
DocReaderAction enum) during the scanning process:- COMPLETE - scanning process was finished
- PROCESS - scanning process is not finished, you can get an intermediate result from the completion block
- CANCEL - scanning process was canceled by the user
Java
Kotlin
1
private IDocumentReaderCompletion completion = new IDocumentReaderCompletion() {
2
@Override
3
public void onCompleted(int action, DocumentReaderResults results, Throwable error) {
4
// processing is finished, all results are ready
5
if (action == DocReaderAction.COMPLETE) {
6
// scanning process was finished
7
} else {
8
// something happened before all results were ready
9
if (action == DocReaderAction.CANCEL){
10
Toast.makeText(MainActivity.this, "Scanning was cancelled",Toast.LENGTH_LONG).show();
11
} else if(action == DocReaderAction.ERROR){
12
Toast.makeText(MainActivity.this, "Error:" + error, Toast.LENGTH_LONG).show();
13
}
14
}
15
}
16
};
Copied!
1
private val completion = IDocumentReaderCompletion { action, results, error ->
2
// processing is finished, all results are ready
3
if (action == DocReaderAction.COMPLETE) {
4
// scanning process was finished
5
} else {
6
// something happened before all results were ready
7
if (action == DocReaderAction.CANCEL) {
8
Toast.makeText(this@MainActivity, "Scanning was cancelled", Toast.LENGTH_LONG).show()
9
} else if (action == DocReaderAction.ERROR) {
10
Toast.makeText(this@MainActivity, "Error:$error", Toast.LENGTH_LONG).show()
11
}
12
}
13
}
Copied!
Close scanner
Allows to close scanner, i.e. camera activity:
Java
Kotlin
1
DocumentReader.Instance().stopScanner(MainActivity.this);
Copied!
1
DocumentReader.Instance().stopScanner(this@MainActivity)
Copied!
Last modified 1yr ago
Copy link