Accurate Barcode Scanning SDK
for Real-World Conditions

// 1. Init license
Dynamsoft.License.LicenseManager.initLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9");
 
// 2. Create a camera view and attach it to the page
const cameraView = await Dynamsoft.DCE.CameraView.createInstance();
document.querySelector("#camera-view-container").append(cameraView.getUIElement());
const camera = await Dynamsoft.DCE.CameraEnhancer.createInstance(cameraView);
 
// 3. Wire the camera to the Capture Vision Router
const router = await Dynamsoft.CVR.CaptureVisionRouter.createInstance();
router.setInput(camera);
router.addResultReceiver({
    onDecodedBarcodesReceived: (result) => {
        for (const item of result.barcodeResultItems) {
            console.log(item.formatString, item.text);
        }
    }
});
 
// 4. Start scanning
await camera.open();
await router.startCapturing("ReadSingleBarcode");
    

from dynamsoft_barcode_reader_bundle import *
 
# 1. Init license
errorCode, errorMsg = LicenseManager.init_license("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9")
if errorCode != EnumErrorCode.EC_OK and errorCode != EnumErrorCode.EC_LICENSE_CACHE_USED:
    print("License init failed:", errorMsg)
else:
    # 2. Capture barcodes from an image file
    cvr = CaptureVisionRouter()
    result = cvr.capture("path/to/image.png", EnumPresetTemplate.PT_READ_BARCODES.value)
 
    # 3. Print decoded items
    barcodes = result.get_decoded_barcodes_result()
    if barcodes is None or len(barcodes.get_items()) == 0:
        print("No barcode detected.")
    else:
        for item in barcodes.get_items():
            print(item.get_format_string() + ": " + item.get_text())

import com.dynamsoft.cvr.*;
import com.dynamsoft.dbr.*;
import com.dynamsoft.license.*;
import com.dynamsoft.core.EnumErrorCode;
 
public class ReadAnImage {
    public static void main(String[] args) throws Exception {
        // 1. Init license
        LicenseError lic = LicenseManager.initLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9");
        if (lic.getErrorCode() != EnumErrorCode.EC_OK) {
            System.out.println("License init failed: " + lic.getErrorString());
            return;
        }
 
        // 2. Capture barcodes from an image file
        CaptureVisionRouter cvr = new CaptureVisionRouter();
        CapturedResult[] results = cvr.captureMultiPages(
            "path/to/image.png", EnumPresetTemplate.PT_READ_BARCODES);
 
        // 3. Print decoded items
        for (CapturedResult r : results) {
            DecodedBarcodesResult barcodes = r.getDecodedBarcodesResult();
            if (barcodes == null) continue;
            for (BarcodeResultItem item : barcodes.getItems()) {
                System.out.println(item.getFormatString() + ": " + item.getText());
            }
        }
    }
}

using Dynamsoft.DBR;
using Dynamsoft.Core;
using Dynamsoft.CVR;
using Dynamsoft.License;
 
// 1. Init license
int errorCode = LicenseManager.InitLicense(
    "DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK
    && errorCode != (int)EnumErrorCode.EC_LICENSE_CACHE_USED) {
    Console.WriteLine("License init failed: " + errorMsg);
    return;
}
 
// 2. Capture barcodes from an image file
using var cvr = new CaptureVisionRouter();
CapturedResult? result = cvr.Capture("path/to/image.png", PresetTemplate.PT_READ_BARCODES);
 
// 3. Print decoded items
DecodedBarcodesResult? barcodes = result?.GetDecodedBarcodesResult();
if (barcodes == null || barcodes.GetItems().Length == 0) {
    Console.WriteLine("No barcode detected.");
} else {
    foreach (var item in barcodes.GetItems())
        Console.WriteLine(item.GetFormatString() + ": " + item.GetText());
}

#include "DynamsoftCaptureVisionRouter.h"
using namespace dynamsoft::license;
using namespace dynamsoft::cvr;
using namespace dynamsoft::dbr;
 
int main() {
    // 1. Init license
    char errorMsg[512];
    int errorCode = CLicenseManager::InitLicense(
        "DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9", errorMsg, 512);
    if (errorCode != EC_OK && errorCode != EC_LICENSE_CACHE_USED) {
        std::cout << "License init failed: " << errorMsg << std::endl;
        return 1;
    }
 
    // 2. Capture barcodes from an image file
    CCaptureVisionRouter* cvr = new CCaptureVisionRouter;
    CCapturedResult* result = cvr->Capture(
        "path/to/image.png", CPresetTemplate::PT_READ_BARCODES);
 
    // 3. Print decoded items
    CDecodedBarcodesResult* barcodes = result->GetDecodedBarcodesResult();
    if (barcodes == nullptr || barcodes->GetItemsCount() == 0) {
        std::cout << "No barcode detected." << std::endl;
    } else {
        for (int i = 0; i < barcodes->GetItemsCount(); ++i) {
            const CBarcodeResultItem* item = barcodes->GetItem(i);
            std::cout << item->GetFormatString() << ": " << item->GetText() << std::endl;
        }
    }
 
    if (barcodes) barcodes->Release();
    result->Release();
    delete cvr;
    return 0;
}

import 'package:flutter/material.dart';
import 'package:dynamsoft_capture_vision_flutter/dynamsoft_capture_vision_flutter.dart';
 
class ScannerPage extends StatefulWidget {
    @override
    State createState() => _ScannerPageState();
}
 
class _ScannerPageState extends State {
    final _cvr = CaptureVisionRouter.instance;
    final _camera = CameraEnhancer.instance;
    String _display = "";
 
    @override
    void initState() {
        super.initState();
        _setup();
    }
 
    Future _setup() async {
        // 1. Init license
        await LicenseManager.initLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9");
 
        // 2. Wire camera to router, register result receiver
        await _cvr.setInput(_camera);
        _cvr.addResultReceiver(CapturedResultReceiver(
            onDecodedBarcodesReceived: (result) {
                final items = result.items ?? [];
                if (items.isEmpty) return;
                setState(() => _display = items
                    .map((b) => "${b.formatString}: ${b.text}")
                    .join("\n"));
            },
        ));
 
        // 3. Start camera and capture
        await _camera.open();
        await _cvr.startCapturing(EnumPresetTemplate.readBarcodes);
    }
 
    @override
    Widget build(BuildContext context) => Scaffold(
        body: Stack(children: [
            CameraView(cameraEnhancer: _camera),
            Positioned(bottom: 24, left: 16, right: 16, child: Text(_display)),
        ]),
    );
}

import React, { useEffect, useRef, useState } from 'react';
import { Text, View } from 'react-native';
import {
    CameraEnhancer, CameraView, CaptureVisionRouter,
    LicenseManager, EnumPresetTemplate,
} from 'dynamsoft-capture-vision-react-native';
 
export default function App(): React.JSX.Element {
    const cameraRef = useRef(null);
    const routerRef = useRef(null);
    const [display, setDisplay] = useState('');
 
    useEffect(() => {
        (async () => {
            // 1. Init license
            await LicenseManager.initLicense('DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9');
 
            // 2. Wire camera to router, register result receiver
            const camera = await CameraEnhancer.createInstance();
            const router = await CaptureVisionRouter.createInstance();
            await router.setInput(camera);
            router.addResultReceiver({
                onDecodedBarcodesReceived: (result) => {
                    const items = result.items ?? [];
                    if (items.length === 0) return;
                    setDisplay(items.map(b => `${b.formatString}: ${b.text}`).join('\n'));
                },
            });
 
            // 3. Start camera and capture
            await camera.open();
            await router.startCapturing(EnumPresetTemplate.PT_READ_BARCODES);
 
            cameraRef.current = camera;
            routerRef.current = router;
        })();
 
        return () => {
            routerRef.current?.stopCapturing();
            cameraRef.current?.close();
        };
    }, []);
 
    return (
        <View style={{ flex: 1 }}>
            <CameraView style={{ flex: 1 }} cameraEnhancer={cameraRef.current} />
            <Text style={{ padding: 16 }}>{display}</Text>
        </View>
    );
}

using Dynamsoft.CaptureVisionRouter.Maui;
using Dynamsoft.CameraEnhancer.Maui;
using Dynamsoft.License.Maui;
 
namespace ScanBarcodes;
 
public partial class ScannerPage : ContentPage, ICapturedResultReceiver
{
    private CameraEnhancer _camera;
    private CaptureVisionRouter _cvr;
 
    public ScannerPage()
    {
        InitializeComponent();
 
        // 1. Init license
        LicenseManager.InitLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9");
 
        // 2. Wire camera to router, register result receiver
        _camera = new CameraEnhancer();
        _camera.SetCameraView(cameraView);
        _cvr = new CaptureVisionRouter();
        _cvr.SetInput(_camera);
        _cvr.AddResultReceiver(this);
    }
 
    public void OnDecodedBarcodesReceived(DecodedBarcodesResult result)
    {
        if (result.Items == null || result.Items.Length == 0) return;
        MainThread.BeginInvokeOnMainThread(() =>
        {
            label.Text = string.Join("\n",
                result.Items.Select(b => b.FormatString + ": " + b.Text));
        });
    }
 
    // 3. Start/stop camera and capture with the page lifecycle
    protected override async void OnAppearing()
    {
        base.OnAppearing();
        await Permissions.RequestAsync();
        _camera.Open();
        _cvr.StartCapturing(EnumPresetTemplate.PT_READ_BARCODES);
    }
 
    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        _cvr.StopCapturing();
        _camera.Close();
    }
}

import com.dynamsoft.cvr.*;
import com.dynamsoft.dbr.*;
import com.dynamsoft.dce.CameraEnhancer;
import com.dynamsoft.dce.CameraView;
import com.dynamsoft.dce.utils.PermissionUtil;
import com.dynamsoft.license.LicenseManager;
 
public class MainActivity extends AppCompatActivity {
    private CameraEnhancer mCamera;
    private CaptureVisionRouter mRouter;
    private TextView mResult;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mResult = findViewById(R.id.tv_result);
 
        // 1. Init license
        LicenseManager.initLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9",
            this, (isSuccess, error) -> {
                if (!isSuccess && error != null) Log.e("DBR", error.getMessage());
            });
 
        // 2. Wire camera to router, register result receiver
        PermissionUtil.requestCameraPermission(this);
        CameraView cameraView = findViewById(R.id.camera_view);
        mCamera = new CameraEnhancer(cameraView, this);
 
        mRouter = new CaptureVisionRouter(this);
        
        mRouter.setInput(mCamera);
        mRouter.addResultReceiver(new CapturedResultReceiver() {
            @Override
            public void onDecodedBarcodesReceived(DecodedBarcodesResult result) {
                BarcodeResultItem[] items = result.getItems();
                if (items == null || items.length == 0) return;
                StringBuilder sb = new StringBuilder();
                for (BarcodeResultItem item : items)
                    sb.append(item.getFormatString()).append(": ").append(item.getText()).append("\n");
                runOnUiThread(() -> mResult.setText(sb.toString()));
            }
        });
    }
 
    // 3. Start/stop camera and capture with the activity lifecycle
    @Override protected void onResume() {
        super.onResume();
        try { mCamera.open(); } catch (Exception e) { e.printStackTrace(); }
        mRouter.startCapturing(EnumPresetTemplate.PT_READ_BARCODES, (isSuccess, error) -> {});
    }
 
    @Override protected void onPause() {
        super.onPause();
        mRouter.stopCapturing();
        try { mCamera.close(); } catch (Exception e) { e.printStackTrace(); }
    }
}

import UIKit
import DynamsoftCaptureVisionBundle
 
class ViewController: UIViewController, LicenseVerificationListener, CapturedResultReceiver {
    var cameraView: CameraView!
    let camera = CameraEnhancer()
    let cvr = CaptureVisionRouter()
    let label = UILabel()
 
    override func viewDidLoad() {
        super.viewDidLoad()
 
        // 1. Init license
        LicenseManager.initLicense(
            "DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9",
            verificationDelegate: self)
 
        // 2. Wire camera to router, register result receiver
        cameraView = CameraView(frame: view.bounds)
        cameraView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        view.insertSubview(cameraView, at: 0)
        camera.cameraView = cameraView
 
        try! cvr.setInput(camera)
        cvr.addResultReceiver(self)
    }
 
    // 3. Start/stop camera and capture with the view lifecycle
    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        camera.open()
        cvr.startCapturing(PresetTemplate.readBarcodes.rawValue) { _, _ in }
    }
 
    override func viewWillDisappear(_ animated: Bool) {
        super.viewWillDisappear(animated)
        cvr.stopCapturing()
        camera.close()
    }
 
    func onDecodedBarcodesReceived(_ result: DecodedBarcodesResult) {
        guard let items = result.items, !items.isEmpty else { return }
        let text = items.map { "\($0.formatString): \($0.text)" }.joined(separator: "\n")
        DispatchQueue.main.async { self.label.text = text }
    }
 
    func onLicenseVerified(_ isSuccess: Bool, error: Error?) {
        if !isSuccess, let error = error { print(error.localizedDescription) }
    }
}