Update user-guide.md

Author: Dynamsoft-Henry

programming/android/user-guide.md

@@ -404,10 +404,119 @@ Now that the code has been written and the project complete, it's time to run th
 
 Now that your `BarcodeScanner` project is up and running you should be able to see a clean and simplified UI that contains all the necessary UI elements that are needed to make the barcode scanning process as easy and intuitive for the user as it can be.
 
-## Next Steps
+## Key APIs
+
+### BarcodeScannerConfig
+
+Configurations for `BarcodeScanner` component.
+
+| Method | Description |
+| ------ | ----------- |
+| `setLicense` | Sets the license key for the Barcode Reader. |
+| `getLicense` | Returns the license key string. |
+| `setScanningMode` | Sets the scanning mode. |
+| `getScanningMode` | Returns the scanning mode. |
+| `setTemplateFile` | Sets the template with a file path or a JSON string. |
+| `getTemplateFile` | Returns the template with a file path or a JSON string. |
+| `setBarcodeFormats` | Sets the barcode format(s) to read. |
+| `getBarcodeFormats` | Returns the barcode format(s) that the library will accept. |
+| `setScanRegion` | Sets a scan region where only the barcodes located in the scan region can be decoded. |
+| `getScanRegion` | Returns the scan region. |
+| `setTorchButtonVisible` | Sets whether to display the torch button when scanning or not. |
+| `isTorchButtonVisible` | Returns whether the button is visible. |
+| `setBeepEnabled` | Sets whether to trigger a beep sound when a barcode is detected. |
+| `isBeepEnabled` | Returns whether the beep sound is enabled. |
+| `setVibrateEnabled` | Sets whether to trigger a vibration when a barcode is detected. |
+| `isVibrateEnabled` | Returns whether the vibration is enabled. |
+| `setScanLaserVisible` | Sets whether to display a scan laser when scanning. |
+| `isScanLaserVisible` | Returns whether the scan laser is visible. |
+| `setAutoZoomEnabled` | Sets whether to enable the auto-zoom feature when scanning. |
+| `isAutoZoomEnabled` | Returns whether the auto-zoom feature is enabled. |
+| `setCloseButtonVisible` | Sets whether to display a button that can close the scanner page. |
+| `isCloseButtonVisible` | Returns whether the close button is visible. |
+| `setMaxConsecutiveStableFramesToExit` | Sets how long the library will keep scanning when there is no more barcodes to decode. |
+| `getMaxConsecutiveStableFramesToExit` | Returns the maximum number of consecutive stable frames to exit. |
+| `setExpectedBarcodesCount` | Sets the expected number of barcodes. The multiple barcodes scanning will be stopped when the `expectedBarcodesCount` is reached. |
+| `getExpectedBarcodesCount` | Returns the expected number of barcodes. |
+| `setCameraToggleButtonVisible` | Sets whether to display the camera toggle button. |
+| `isCameraToggleButtonVisible` | Returns whether the camera toggle button is visible. |
+| `setZoomFactor` | Sets the zoom factor. |
+| `getZoomFactor` | Returns the zoom factor. |
+| `setResolution` | Sets the resolution. |
+| `getResolution` | Returns the resolution. |
 
-For more configurations of the BarcodeScanner, please refer to the [Configure Barcode Scanner](user-guide/configure-barcode-scanner.md) section.
+```java
+public void setLicense(String license) {}
+public String getLicense() {}
+@EnumScanningMode
+public void setScanningMode(@EnumScanningMode int scanningMode){}
+public int getScanningMode(){}
+public void setTemplateFile(String templateFile){}
+public String getTemplateFile(){}
+public void setBarcodeFormats(long format) {}
+@EnumBarcodeFormat
+public long getBarcodeFormats() {}
+public void setScanRegion(DSRect scanRegion){}
+public DSRect getScanRegion(){}
+public void setTorchButtonVisible(boolean flashButtonVisible) {}
+public boolean isTorchButtonVisible() {}
+public void setBeepEnabled(boolean beepEnabled) {}
+public boolean isBeepEnabled() {}
+public void setVibrateEnabled(boolean vibrationEnabled) {}
+public boolean isVibrateEnabled() {}
+public void setScanLaserVisible(boolean scanLaserVisible) {}
+public boolean isScanLaserVisible() {}
+public void setAutoZoomEnabled(boolean autoZoomEnabled) {}
+public boolean isAutoZoomEnabled() {}
+public void setCloseButtonVisible(boolean closeButtonVisible) {}
+public boolean isCloseButtonVisible() {}
+public void setMaxConsecutiveStableFramesToExit(int maxConsecutiveStableFramesToExit){}
+public int getMaxConsecutiveStableFramesToExit(){}
+public void setExpectedBarcodesCount(int expectedBarcodesCount) {}
+public int getExpectedBarcodesCount() {}
+public void setCameraToggleButtonVisible(boolean cameraToggleButtonVisible) {}
+public boolean isCameraToggleButtonVisible() {}
+public void setZoomFactor(float zoomFactor) {}
+public float getZoomFactor() {}
+public void setResolution(@EnumResolution int resolution) {}
+@EnumResolution
+public int getResolution() {}
+```
+
+### BarcodeScanResult
+
+Result object produced by the `BarcodeScanner` component.
+
+| Method | Description |
+| ------ | ----------- |
+| `getBarcodes` | Returns an array of [`BarcodeResultItem`]({{ site.dbr_android_api }}barcode-result-item.html), which represents a single barocde result. |
+| `getResultStatus` | Returns the status of the `BarcodeScanResult`, of type [`EnumResultStatus`](#enumresultstatus). |
+| `getErrorCode` | Returns the error code should something go wrong during the barcode recognition process. |
+| `getErrorString` | Returns the error message associated with the error code should something go wrong during the barcode recognition process. |
+
+```java
+public BarcodeResultItem[] getBarcodes() {}
+@EnumResultStatus
+public int getResultStatus() {}
+public int getErrorCode() {}
+public String getErrorString() {}
+```
+
+### EnumScanningMode
+
+Enumeration for specifying the scanning mode.
+
+| Member | Description |
+| ------ | ----------- |
+| `SM_SINGLE` | The scan mode for scanning single barcode. |
+| `SM_MULTIPLE` | The scan mode for scanning multiple barcodes. |
+
+### EnumResultStatus
 
-If you would like to work with the original framework and create your own customized UI, please refer to the [Build Your APP with Foundational APIs](foundational-guide.md).
+Enumeration that represents the result status of the `BarcodeScanResult`.
 
-If you have any questions in regards to the usage of the new specialized SDK, do not hesitate to get in touch with the [Dynamsoft Support Team](https://www.dynamsoft.com/contact/).
+| Member | Description |
+| ------ | ----------- |
+| `RS_FINISHED` | The barcode scanning is finished. You can get at least one result from the `BarcodeScanResult`. |
+| `RS_CANCELED` | The barcode scanning activity is closed before the process is finished. No results are available. |
+| `RS_EXCEPTION` | Failed to start barcode scanning or an error occurs when scanning the barcodes. No results are available. |