Nuxt is a higher-level framework that builds on top of Vue. Check out the following guide on how to implement Dynamsoft Barcode Reader JavaScript SDK (hereafter called "the library") into a Nuxt application. Note that in this sample TypeScript is used.
In this guide, we will be using dynamsoft-barcode-reader-bundle 11.2.4000.
Note:
If you're looking to integrate DBR-JS into a framework that we don't yet have a sample, don't worry! We have a comprehensive guide that provides detailed instruction and best practices for a seamless integration into any frameworks!
Additionally, we're here to help! Please don't hesitate to contact us for any support or questions you might have.
Make sure you have node installed. node 16.20.1 and nuxt 3.2.3 are used in this article.
npm install
npm run devThen open https://localhost:3000/ to view the sample app.
In this section, we will be creating a NuxtJS application utilizing the Dynamsoft Barcode Reader bundle sdk.
We'll be exploring how you could create a page that not only enables barcode scanning via a webcam or a built-in camera, but also decode barcodes from local images.
By the end of this guide, you'll have a good understanding of the SDK and be ready to discover more ways to use it!
npx nuxi@latest init my-appYou will be asked to configure quite a few things for the application during the creation. In our example, we chose the default one in every step.
cd my-app
npm install dynamsoft-barcode-reader-bundle@11.2.4000 -E/* /dynamsoft.config.ts */
import { CoreModule } from "dynamsoft-core";
import { LicenseManager } from "dynamsoft-license";
import "dynamsoft-barcode-reader";
// Configures the paths where the .wasm files and other necessary resources for modules are located.
CoreModule.engineResourcePaths.rootDirectory = "https://cdn.jsdelivr.net/npm/";
/** LICENSE ALERT - README
* To use the library, you need to first specify a license key using the API "initLicense()" as shown below.
*/
LicenseManager.initLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9", {
executeNow: true,
});
/**
* You can visit https://www.dynamsoft.com/customer/license/trialLicense?utm_source=samples&product=dbr&package=js to get your own trial license good for 30 days.
* Note that if you downloaded this sample from Dynamsoft while logged in, the above license key may already be your own 30-day trial license.
* For more information, see https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/user-guide/index.html?ver=11.2.4000&cVer=true#specify-the-license&utm_source=samples or contact [email protected].
* LICENSE ALERT - THE END
*/
// Optional. Preload .wasm file for reading barcodes. It will save time on the initial decoding by skipping the resource loading.
CoreModule.loadWasm();Note:
initLicense()specify a license key to use the library. You can visit https://www.dynamsoft.com/customer/license/trialLicense?utm_source=sample&product=dbr&package=js to get your own trial license good for 30 days.engineResourcePathstells the library where to get the necessary resources at runtime.
Create a directory "components" and create the following files inside it to represent two components
VideoCapture.client.vueImageCapture.client.vue
.client suffix means the component is rendered only client-side.
- In
VideoCapture.client.vue, add code for initializing and destroying some instances. TheVideoCapturecomponent helps decode barcodes via camera. For our stylesheet (CSS) specification, please refer to our source code.
<!-- /components/VideoCapture.client.vue -->
<script setup lang="ts">
import { onMounted, onBeforeUnmount, ref, type Ref } from "vue";
import "../dynamsoft.config";
import { CameraEnhancer, CameraView } from "dynamsoft-camera-enhancer";
import { CaptureVisionRouter } from "dynamsoft-capture-vision-router";
import { MultiFrameResultCrossFilter } from "dynamsoft-utility";
const componentDestroyedErrorMsg = "VideoCapture Component Destroyed";
const cameraViewContainer: Ref<HTMLElement | null> = ref(null);
const resultText = ref("");
let resolveInit: () => void;
const pInit: Promise<void> = new Promise(r => { resolveInit = r });
let isDestroyed = false;
let cvRouter: CaptureVisionRouter;
let cameraEnhancer: CameraEnhancer;
onMounted(async () => {
try {
// Create a `CameraEnhancer` instance for camera control and a `CameraView` instance for UI control.
const cameraView = await CameraView.createInstance();
if (isDestroyed) { throw Error(componentDestroyedErrorMsg); } // Check if component is destroyed after every async
cameraEnhancer = await CameraEnhancer.createInstance(cameraView);
if (isDestroyed) { throw Error(componentDestroyedErrorMsg); }
// Get default UI and append it to DOM.
cameraViewContainer.value!.append(cameraView.getUIElement());
// Create a `CaptureVisionRouter` instance and set `CameraEnhancer` instance as its image source.
cvRouter = await CaptureVisionRouter.createInstance();
if (isDestroyed) { throw Error(componentDestroyedErrorMsg); }
cvRouter.setInput(cameraEnhancer);
// Define a callback for results.
cvRouter.addResultReceiver({
onDecodedBarcodesReceived: (result) => {
if (!result.barcodeResultItems.length) return;
resultText.value = '';
console.log(result);
for (let item of result.barcodeResultItems) {
resultText.value += `${item.formatString}: ${item.text}\n\n`;
}
}
});
// Filter out unchecked and duplicate results.
const filter = new MultiFrameResultCrossFilter();
// Filter out unchecked barcodes.
filter.enableResultCrossVerification("barcode", true);
// Filter out duplicate barcodes within 3 seconds.
filter.enableResultDeduplication("barcode", true);
await cvRouter.addResultFilter(filter);
if (isDestroyed) { throw Error(componentDestroyedErrorMsg); }
// Open camera and start scanning single barcode.
await cameraEnhancer.open();
cameraView.setScanLaserVisible(true);
if (isDestroyed) { throw Error(componentDestroyedErrorMsg); }
await cvRouter.startCapturing("ReadSingleBarcode");
if (isDestroyed) { throw Error(componentDestroyedErrorMsg); }
} catch (ex: any) {
if ((ex as Error)?.message === componentDestroyedErrorMsg) {
console.log(componentDestroyedErrorMsg);
} else {
let errMsg = ex.message || ex;
console.error(ex);
alert(errMsg);
}
}
// Resolve pInit promise once initialization is complete.
resolveInit!();
});
// dispose cvRouter when it's no longer needed
onBeforeUnmount(async () => {
isDestroyed = true;
try {
await pInit;
cvRouter?.dispose();
cameraEnhancer?.dispose();
} catch (_) { }
});
</script>
<template>
<div>
<div ref="cameraViewContainer" style="width: 100%; height: 70vh; background: #eee;"></div>
<br />
Results:
<div class="results">{{ resultText }}</div>
</div>
</template>
<style scoped>
.results {
width: 100%;
height: 10vh;
overflow: auto;
white-space: pre-wrap;
}
</style>Note:
If you're looking to customize the UI, the UI customization feature are provided by the auxiliary SDK "Dynamsoft Camera Enhancer". For more details, refer to our User Guide
- In
ImageCapture.client.vue, add code for initializing and destroying theCaptureVisionRouterinstance. TheImageCapturehelps decode barcodes in an image. For our stylesheet (CSS) specification, please refer to our source code.
<!-- /components/ImageCapture.client.vue -->
<script setup lang="ts">
import { onBeforeUnmount, ref, type Ref } from "vue";
import "../dynamsoft.config";
import { EnumCapturedResultItemType } from "dynamsoft-core";
import type { BarcodeResultItem } from "dynamsoft-barcode-reader";
import { CaptureVisionRouter } from "dynamsoft-capture-vision-router";
const resultText = ref("");
let pCvRouter: Promise<CaptureVisionRouter>;
let isDestroyed = false;
const captureImage = async (e: Event) => {
let files = [...(e.target! as HTMLInputElement).files!];
(e.target! as HTMLInputElement).value = ''; // reset input
resultText.value = "";
try {
// ensure cvRouter is created only once
const cvRouter = await (pCvRouter = pCvRouter || CaptureVisionRouter.createInstance());
if (isDestroyed) return;
for (let file of files) {
// Decode selected image with 'ReadBarcodes_ReadRateFirst' template.
const result = await cvRouter.capture(file, "ReadBarcodes_ReadRateFirst");
console.log(result);
if (isDestroyed) return;
// Print file name if there's multiple files
if (files.length > 1) {
resultText.value += `\n${file.name}:\n`;
}
for (let _item of result.items) {
if (_item.type !== EnumCapturedResultItemType.CRIT_BARCODE) {
continue; // check if captured result item is a barcode
}
let item = _item as BarcodeResultItem;
resultText.value += item.text + "\n"; // output the decoded barcode text
}
// If no items are found, display that no barcode was detected
if (!result.items.length) resultText.value += 'No barcode found\n';
}
} catch (ex: any) {
let errMsg = ex.message || ex;
console.error(ex);
alert(errMsg);
}
}
onBeforeUnmount(async () => {
isDestroyed = true;
if (pCvRouter) {
try {
(await pCvRouter).dispose();
} catch (_) { }
}
});
</script>
<template>
<div class="image-capture-container">
<div class="input-container">
<input type="file" multiple @change="captureImage" accept=".jpg,.jpeg,.icon,.gif,.svg,.webp,.png,.bmp" />
</div>
<div class="results">{{resultText}}</div>
</div>
</template>
<style scoped>
.image-capture-container {
width: 100%;
height: 100%;
font-family: Consolas, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono, Bitstream Vera Sans Mono, Courier New, monospace;
}
.image-capture-container .input-container {
width: 80%;
height: 100%;
display: flex;
justify-content: center;
border: 1px solid black;
margin: 0 auto;
}
.image-capture-container .results {
margin-top: 20px;
height: 100%;
white-space: pre-wrap;
}
</style>-
On
/app.vue, we will edit the component so that it offers buttons to switch components betweenVideoCaptureandImageCapture. -
Add following code to
app.vue. For our stylesheet (CSS) specification, please refer to our source code.
<!-- /app.vue -->
<template>
<div class='hello-world-page'>
<div class='title'>
<h2 class='title-text'>Hello World for NuxtJS</h2>
<img class='title-logo' src="./assets/logo.svg" alt="logo" />
</div>
<div class='buttons-container'>
<button @click="mode = 'video'"
:style="{ backgroundColor: mode === 'video' ? 'rgb(255, 174, 55)' : '#FFFFFF' }">Video Capture</button>
<button @click="mode = 'image'"
:style="{ backgroundColor: mode === 'image' ? 'rgb(255, 174, 55)' : '#FFFFFF' }">Image Capture</button>
</div>
<client-only>
<VideoCapture v-if="mode === 'video'" />
<ImageCapture v-else />
</client-only>
</div>
</template>
<script setup lang="ts">
import "./assets/main.css";
import { ref, type Ref } from "vue";
import VideoCapture from "./components/VideoCapture.client.vue";
import ImageCapture from "./components/ImageCapture.client.vue";
const mode: Ref<string> = ref("video");
</script>Note:
Since
VideoCaptureandImageCapturecomponents are only rendered on the client side, we want to make sure that these components are not causing sie effects during the server rendering phase. We can solve this using theclient-onlycomponent.
- Try running the project.
npm run devIf you followed all the steps correctly, you will have a working page that turns one of the cameras hooked to or built in your computer or mobile device into a barcode scanner. Also, if you want to decode a local image, just click the Decode Image button and select the image you want to decode. Once barcodes are found, the results will show in a dialog.
npm installnpm run devnpm run buildIf you have any questions, feel free to contact Dynamsoft support.