capacitor-camera-view 2.1.0 → 2.2.0

package/README.md

@@ -670,12 +670,13 @@ Response for the camera permission status.
 
 Data for a detected barcode.
 
-| Prop               | Type                                                  | Description                                                      |
-| ------------------ | ----------------------------------------------------- | ---------------------------------------------------------------- |
-| **`value`**        | <code>string</code>                                   | The decoded string value of the barcode                          |
-| **`displayValue`** | <code>string</code>                                   | The display value of the barcode (may differ from the raw value) |
-| **`type`**         | <code>string</code>                                   | The type/format of the barcode (e.g., 'qr', 'code128', etc.)     |
-| **`boundingRect`** | <code><a href="#boundingrect">BoundingRect</a></code> | The bounding rectangle of the barcode in the camera frame.       |
+| Prop               | Type                                                  | Description                                                                                                                                                                                                                                                                                          | Since |
+| ------------------ | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`value`**        | <code>string</code>                                   | The decoded string value of the barcode                                                                                                                                                                                                                                                              |       |
+| **`rawBytes`**     | <code>number[]</code>                                 | Raw bytes as they were encoded in the barcode. On Android, this is forwarded from ML Kit. On iOS, this is available for descriptor-backed formats such as QR, Aztec, PDF417, and Data Matrix. On web, this is not available because the Barcode Detection API only exposes the decoded string value. | 2.2.0 |
+| **`displayValue`** | <code>string</code>                                   | The display value of the barcode on Android. This is forwarded from ML Kit and may contain a formatted, human-readable representation that differs from the raw decoded value. iOS and web do not expose a separate display value, so this property is only emitted on Android.                      |       |
+| **`type`**         | <code>string</code>                                   | The type/format of the barcode (e.g., 'qr', 'code128', etc.)                                                                                                                                                                                                                                         |       |
+| **`boundingRect`** | <code><a href="#boundingrect">BoundingRect</a></code> | The bounding rectangle of the barcode in the camera frame.                                                                                                                                                                                                                                           |       |
 
 
 #### BoundingRect

package/android/src/main/java/com/michaelwolz/capacitorcameraview/CameraView.kt

@@ -723,6 +723,7 @@ class CameraView(plugin: Plugin) {
         val barcodeResult =
             BarcodeDetectionResult(
                 value = barcode.rawValue ?: "",
+                rawBytes = barcode.rawBytes ?: ByteArray(0),
                 displayValue = barcode.displayValue ?: "",
                 type = getBarcodeFormatString(barcode.format),
                 boundingRect = webBoundingRect

package/android/src/main/java/com/michaelwolz/capacitorcameraview/CameraViewPlugin.kt

@@ -289,8 +289,14 @@ class CameraViewPlugin : Plugin() {
      * Called by the CameraView when a barcode is detected.
      */
     fun notifyBarcodeDetected(result: BarcodeDetectionResult) {
+        val rawBytesArray = JSArray().apply {
+            result.rawBytes.forEach { put(it.toInt() and 0xFF) }
+        }
+
         val jsObject = JSObject().apply {
             put("value", result.value)
+            put("displayValue", result.displayValue)
+            put("rawBytes", rawBytesArray)
             put("type", result.type)
             put("boundingRect", JSObject().apply {
                 put("x", result.boundingRect.x)

package/android/src/main/java/com/michaelwolz/capacitorcameraview/model/BarcodeDetectionResult.kt

@@ -5,6 +5,7 @@ package com.michaelwolz.capacitorcameraview.model
  */
 data class BarcodeDetectionResult(
     val value: String,
+    val rawBytes: ByteArray,
     val displayValue: String,
     val type: String,
     val boundingRect: WebBoundingRect

package/dist/docs.json

@@ -980,10 +980,22 @@
           "complexTypes": [],
           "type": "string"
         },
+        {
+          "name": "rawBytes",
+          "tags": [
+            {
+              "text": "2.2.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Raw bytes as they were encoded in the barcode.\n\nOn Android, this is forwarded from ML Kit.\nOn iOS, this is available for descriptor-backed formats such as QR, Aztec, PDF417, and Data Matrix.\nOn web, this is not available because the Barcode Detection API only exposes the decoded string value.",
+          "complexTypes": [],
+          "type": "number[] | undefined"
+        },
         {
           "name": "displayValue",
           "tags": [],
-          "docs": "The display value of the barcode (may differ from the raw value)",
+          "docs": "The display value of the barcode on Android.\n\nThis is forwarded from ML Kit and may contain a formatted, human-readable\nrepresentation that differs from the raw decoded value. iOS and web do not\nexpose a separate display value, so this property is only emitted on Android.",
           "complexTypes": [],
           "type": "string | undefined"
         },

package/dist/esm/definitions.d.ts

@@ -473,7 +473,23 @@ export interface GetTorchModeResponse {
 export interface BarcodeDetectionData {
     /** The decoded string value of the barcode */
     value: string;
-    /** The display value of the barcode (may differ from the raw value) */
+    /**
+     * Raw bytes as they were encoded in the barcode.
+     *
+     * On Android, this is forwarded from ML Kit.
+     * On iOS, this is available for descriptor-backed formats such as QR, Aztec, PDF417, and Data Matrix.
+     * On web, this is not available because the Barcode Detection API only exposes the decoded string value.
+     *
+     * @since 2.2.0
+     */
+    rawBytes?: number[];
+    /**
+     * The display value of the barcode on Android.
+     *
+     * This is forwarded from ML Kit and may contain a formatted, human-readable
+     * representation that differs from the raw decoded value. iOS and web do not
+     * expose a separate display value, so this property is only emitted on Android.
+     */
     displayValue?: string;
     /** The type/format of the barcode (e.g., 'qr', 'code128', etc.) */
     type: string;

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Main plugin interface for Capacitor Camera View functionality.\n *\n * @since 1.0.0\n */\nexport interface CameraViewPlugin {\n  /**\n   * Start the camera view with optional configuration.\n   *\n   * @param options - Configuration options for the camera session\n   * @returns A promise that resolves when the camera has started\n   *\n   * @since 1.0.0\n   */\n  start(options?: CameraSessionConfiguration): Promise<void>;\n\n  /**\n   * Stop the camera view and release resources.\n   *\n   * @returns A promise that resolves when the camera has stopped\n   *\n   * @since 1.0.0\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Check if the camera view is currently running.\n   *\n   * @returns A promise that resolves with an object containing the running state of the camera\n   *\n   * @since 1.0.0\n   */\n  isRunning(): Promise<IsRunningResponse>;\n\n  /**\n   * Capture a photo using the current camera configuration.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured photo\n   *\n   * @since 1.0.0\n   */\n  capture<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Captures a frame from the current camera preview without using the full camera capture pipeline.\n   *\n   * Unlike `capture()` which may trigger hardware-level photo capture on native platforms,\n   * this method quickly samples the current video stream. This is suitable computer vision or\n   * simple snapshots where high fidelity is not required.\n   *\n   * On web this method does exactly the same as `capture()` as it only captures a frame from the video stream\n   * because unfortunately [ImageCapture API](https://developer.mozilla.org/en-US/docs/Web/API/ImageCapture) is\n   * not yet well supported on the web.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured sample\n   *\n   * @since 1.0.0\n   */\n  captureSample<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Switch between front and back camera.\n   *\n   * @returns A promise that resolves when the camera has been flipped\n   *\n   * @since 1.0.0\n   */\n  flipCamera(): Promise<void>;\n\n  /**\n   * Get available camera devices for capturing photos.\n   *\n   * @returns A promise that resolves with an object containing an array of available capture devices\n   *\n   * @since 1.0.0\n   */\n  getAvailableDevices(): Promise<GetAvailableDevicesResponse>;\n\n  /**\n   * Get current zoom level information and available range.\n   *\n   * @remarks\n   * Make sure the camera is properly initialized before calling this method. Otherwise, this might\n   * lead to returning default values on android.\n   *\n   * @returns A promise that resolves with an object containing min, max and current zoom levels\n   *\n   * @since 1.0.0\n   */\n  getZoom(): Promise<GetZoomResponse>;\n\n  /**\n   * Set the camera zoom level.\n   *\n   * @param options - Zoom configuration options\n   * @param options.level - The zoom level to set\n   * @param options.ramp - Whether to animate the zoom level change, defaults to false (iOS only)\n   * @returns A promise that resolves when the zoom level has been set\n   *\n   * @remarks\n   * On web platforms, zoom functionality may be limited by browser support.\n   * When native zoom is not available, a CSS-based zoom simulation is applied.\n   *\n   * @since 1.0.0\n   */\n  setZoom(options: { level: number; ramp?: boolean }): Promise<void>;\n\n  /**\n   * Get current flash mode setting.\n   *\n   * @returns A promise that resolves with an object containing the current flash mode\n   *\n   * @since 1.0.0\n   */\n  getFlashMode(): Promise<GetFlashModeResponse>;\n\n  /**\n   * Get supported flash modes for the current camera.\n   *\n   * @returns A promise that resolves with an object containing an array of supported flash modes\n   *\n   * @since 1.0.0\n   */\n  getSupportedFlashModes(): Promise<GetSupportedFlashModesResponse>;\n\n  /**\n   * Set the camera flash mode.\n   *\n   * @param options - Flash mode configuration options\n   * @param options.mode - The flash mode to set\n   * @returns A promise that resolves when the flash mode has been set\n   *\n   * @since 1.0.0\n   */\n  setFlashMode(options: { mode: FlashMode }): Promise<void>;\n\n  /**\n   * Check if the device supports torch (flashlight) functionality.\n   *\n   * @remarks\n   * **Important**: You must call this method and verify torch availability before using\n   * `setTorchMode()` or `getTorchMode()`. Calling torch methods on devices without\n   * torch support will throw an exception.\n   *\n   * @returns A promise that resolves with an object containing torch availability status\n   *\n   * @since 1.2.0\n   */\n  isTorchAvailable(): Promise<IsTorchAvailableResponse>;\n\n  /**\n   * Get the current torch (flashlight) state.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * @returns A promise that resolves with an object containing the current torch state\n   *\n   * @since 1.2.0\n   */\n  getTorchMode(): Promise<GetTorchModeResponse>;\n\n  /**\n   * Set the torch (flashlight) mode and intensity.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * The torch provides continuous illumination, unlike flash which only activates during photo capture.\n   * On iOS, you can control the torch intensity level. On Android, the torch is either on or off.\n   *\n   * @param options - Torch configuration options\n   * @param options.enabled - Whether to enable or disable the torch\n   * @param options.level - The torch intensity level (0.0 to 1.0, iOS only). Defaults to 1.0 when enabled\n   * @returns A promise that resolves when the torch mode has been set\n   *\n   * @since 1.2.0\n   */\n  setTorchMode(options: { enabled: boolean; level?: number }): Promise<void>;\n\n  /**\n   * Check camera permission status without requesting permissions.\n   *\n   * @returns A promise that resolves with an object containing the camera permission status\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request camera permission from the user.\n   *\n   * @returns A promise that resolves with an object containing the camera permission status\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Listen for barcode detection events.\n   * This event is emitted when a barcode is detected in the camera preview.\n   *\n   * @param eventName - The name of the event to listen for ('barcodeDetected')\n   * @param listenerFunc - The callback function to execute when a barcode is detected\n   * @returns A promise that resolves with an event subscription\n   *\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'barcodeDetected',\n    listenerFunc: (data: BarcodeDetectionData) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @param eventName - Optional event name to remove listeners for\n   * @returns A promise that resolves when the listeners are removed\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(eventName?: string): Promise<void>;\n}\n\n// ------------------------------------------------------------------------------\n// Camera Configuration Types\n// ------------------------------------------------------------------------------\n\n/**\n * Position options for the camera.\n * - 'front': Front-facing camera\n * - 'back': Rear-facing camera\n *\n * @since 1.0.0\n */\nexport type CameraPosition = 'front' | 'back';\n\n/**\n * Flash mode options for the camera.\n * - 'off': Flash disabled\n * - 'on': Flash always on\n * - 'auto': Flash automatically enabled in low-light conditions\n *\n * @since 1.0.0\n */\nexport type FlashMode = 'off' | 'on' | 'auto';\n\n/**\n * Represents a physical camera device on the device.\n *\n * @since 1.0.0\n */\nexport interface CameraDevice {\n  /** The unique identifier of the camera device */\n  id: string;\n\n  /** The human-readable name of the camera device */\n  name: string;\n\n  /** The position of the camera device (front or back) */\n  position: CameraPosition;\n\n  /** The type of the camera device (e.g., wide, ultra-wide, telephoto) - iOS only */\n  deviceType?: CameraDeviceType;\n}\n\n/**\n * Available camera device types for iOS.\n * Maps to AVCaptureDevice DeviceTypes in iOS.\n *\n * @see https://developer.apple.com/documentation/avfoundation/avcapturedevice/devicetype-swift.struct\n *\n * @since 1.0.0\n */\nexport type CameraDeviceType =\n  /** builtInWideAngleCamera - standard camera */\n  | 'wideAngle'\n  /** builtInUltraWideCamera - 0.5x zoom level */\n  | 'ultraWide'\n  /** builtInTelephotoCamera - 2x/3x zoom level */\n  | 'telephoto'\n  /** builtInDualCamera - wide + telephoto combination */\n  | 'dual'\n  /** builtInDualWideCamera - wide + ultraWide combination */\n  | 'dualWide'\n  /** builtInTripleCamera - wide + ultraWide + telephoto */\n  | 'triple'\n  /** builtInTrueDepthCamera - front-facing camera with depth sensing */\n  | 'trueDepth';\n\n/**\n * Supported barcode types for detection.\n * Specifying only the barcode types you need can improve performance\n * and reduce battery consumption.\n *\n * @since 2.1.0\n */\nexport type BarcodeType =\n  /** QR Code */\n  | 'qr'\n  /** Code 128 barcode */\n  | 'code128'\n  /** Code 39 barcode */\n  | 'code39'\n  /** Code 39 Mod 43 barcode */\n  | 'code39Mod43'\n  /** Code 93 barcode */\n  | 'code93'\n  /** EAN-8 barcode */\n  | 'ean8'\n  /** EAN-13 barcode */\n  | 'ean13'\n  /** Interleaved 2 of 5 barcode */\n  | 'interleaved2of5'\n  /** ITF-14 barcode */\n  | 'itf14'\n  /** PDF417 barcode */\n  | 'pdf417'\n  /** Aztec code */\n  | 'aztec'\n  /** Data Matrix code */\n  | 'dataMatrix'\n  /** UPC-E barcode */\n  | 'upce';\n\n/**\n * Configuration options for starting a camera session.\n *\n * @since 1.0.0\n */\nexport interface CameraSessionConfiguration {\n  /**\n   * Enables the barcode detection functionality\n   * @default false\n   */\n  enableBarcodeDetection?: boolean;\n\n  /**\n   * Specific barcode types to detect. If not provided, all supported types are detected.\n   * Specifying only the types you need can significantly improve performance and reduce\n   * battery consumption, especially on mobile devices.\n   *\n   * @example ['qr', 'code128'] // Only detect QR codes and Code 128 barcodes\n   * @default undefined - all supported types are detected\n   * @since 2.1.0\n   */\n  barcodeTypes?: BarcodeType[];\n\n  /**\n   * Position of the camera to use\n   * @default 'back'\n   */\n  position?: CameraPosition;\n\n  /**\n   * Specific device ID of the camera to use\n   * If provided, takes precedence over position\n   */\n  deviceId?: string;\n\n  /**\n   * Whether to use the triple camera if available (iPhone Pro models only)\n   * @default false\n   */\n  useTripleCameraIfAvailable?: boolean;\n\n  /**\n   * Ordered list of preferred camera device types to use (iOS only).\n   * The system will attempt to use the first available camera type in the list.\n   * If position is also provided, the system will use the first available camera type\n   * that matches the position and is in the list.\n   *\n   * This will fallback to the default camera type if none of the preferred types are available.\n   *\n   * @example [CameraDeviceType.WideAngle, CameraDeviceType.UltraWide, CameraDeviceType.Telephoto]\n   * @default undefined - system will decide based on position/deviceId\n   */\n  preferredCameraDeviceTypes?: CameraDeviceType[];\n\n  /**\n   * The initial zoom factor to use\n   * @default 1.0\n   */\n  zoomFactor?: number;\n\n  /**\n   * Optional HTML ID of the container element where the camera view should be rendered.\n   * If not provided, the camera view will be appended to the document body. Web only.\n   * @example 'cameraContainer'\n   */\n  containerElementId?: string;\n}\n\n/**\n * Configuration options for capturing photos and samples.\n *\n * @since 1.1.0\n */\nexport interface CaptureOptions {\n  /**\n   * The JPEG quality of the captured photo/sample on a scale of 0-100\n   * @since 1.1.0\n   */\n  quality: number;\n\n  /**\n   * If true, saves to a temporary file and returns the web path instead of base64.\n   * The web path can be used to set the src attribute of an image for efficient loading and rendering.\n   * This reduces the data that needs to be transferred over the bridge, which can improve performance\n   * especially for high-resolution images.\n   * @default false\n   * @since 1.1.0\n   */\n  saveToFile?: boolean;\n}\n\n// ------------------------------------------------------------------------------\n// Response Interfaces\n// ------------------------------------------------------------------------------\n\n/**\n * Response for checking if the camera view is running.\n *\n * @since 1.0.0\n */\nexport interface IsRunningResponse {\n  /** Indicates if the camera view is currently active and running */\n  isRunning: boolean;\n}\n\n/**\n * Response for capturing a photo\n * This will contain either a base64 encoded string or a web path to the captured photo,\n * depending on the `saveToFile` option in the CaptureOptions.\n * @since 1.0.0\n */\nexport type CaptureResponse<T extends CaptureOptions = CaptureOptions> = T['saveToFile'] extends true\n  ? {\n      /** The web path to the captured photo that can be used to set the src attribute of an image for efficient loading and rendering (when saveToFile is true) */\n      webPath: string;\n    }\n  : {\n      /** The base64 encoded string of the captured photo (when saveToFile is false or undefined) */\n      photo: string;\n    };\n\n/**\n * Response for getting available camera devices.\n *\n * @since 1.0.0\n */\nexport interface GetAvailableDevicesResponse {\n  /** An array of available camera devices */\n  devices: CameraDevice[];\n}\n\n/**\n * Response for getting zoom level information.\n *\n * @since 1.0.0\n */\nexport interface GetZoomResponse {\n  /** The minimum zoom level supported */\n  min: number;\n\n  /** The maximum zoom level supported */\n  max: number;\n\n  /** The current zoom level */\n  current: number;\n}\n\n/**\n * Response for getting the current flash mode.\n *\n * @since 1.0.0\n */\nexport interface GetFlashModeResponse {\n  /** The current flash mode setting */\n  flashMode: FlashMode;\n}\n\n/**\n * Response for getting supported flash modes.\n *\n * @since 1.0.0\n */\nexport interface GetSupportedFlashModesResponse {\n  /** An array of flash modes supported by the current camera */\n  flashModes: FlashMode[];\n}\n\n/**\n * Response for checking torch availability.\n *\n * @since 1.2.0\n */\nexport interface IsTorchAvailableResponse {\n  /** Indicates if the device supports torch (flashlight) functionality */\n  available: boolean;\n}\n\n/**\n * Response for getting the current torch mode.\n *\n * @since 1.2.0\n */\nexport interface GetTorchModeResponse {\n  /** Indicates if the torch is currently enabled */\n  enabled: boolean;\n  /** The current torch intensity level (0.0 to 1.0, iOS only). Always 1.0 on Android when enabled */\n  level: number;\n}\n\n/**\n * Data for a detected barcode.\n *\n * @since 1.0.0\n */\nexport interface BarcodeDetectionData {\n  /** The decoded string value of the barcode */\n  value: string;\n\n  /** The display value of the barcode (may differ from the raw value) */\n  displayValue?: string;\n\n  /** The type/format of the barcode (e.g., 'qr', 'code128', etc.) */\n  type: string;\n\n  /** The bounding rectangle of the barcode in the camera frame. */\n  boundingRect: BoundingRect;\n}\n\n/**\n * Rectangle defining the boundary of the barcode in the camera frame.\n * Coordinates are normalized between 0 and 1 relative to the camera frame.\n *\n * @since 1.0.0\n */\nexport interface BoundingRect {\n  /** X-coordinate of the top-left corner */\n  x: number;\n  /** Y-coordinate of the top-left corner */\n  y: number;\n  /** Width of the bounding rectangle (should match the actual width of the barcode) */\n  width: number;\n  /** Height of the bounding rectangle (should match the actual height of the barcode) */\n  height: number;\n}\n\n/**\n * Response for the camera permission status.\n *\n * @since 1.0.0\n */\nexport interface PermissionStatus {\n  /** The state of the camera permission */\n  camera: PermissionState;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Main plugin interface for Capacitor Camera View functionality.\n *\n * @since 1.0.0\n */\nexport interface CameraViewPlugin {\n  /**\n   * Start the camera view with optional configuration.\n   *\n   * @param options - Configuration options for the camera session\n   * @returns A promise that resolves when the camera has started\n   *\n   * @since 1.0.0\n   */\n  start(options?: CameraSessionConfiguration): Promise<void>;\n\n  /**\n   * Stop the camera view and release resources.\n   *\n   * @returns A promise that resolves when the camera has stopped\n   *\n   * @since 1.0.0\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Check if the camera view is currently running.\n   *\n   * @returns A promise that resolves with an object containing the running state of the camera\n   *\n   * @since 1.0.0\n   */\n  isRunning(): Promise<IsRunningResponse>;\n\n  /**\n   * Capture a photo using the current camera configuration.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured photo\n   *\n   * @since 1.0.0\n   */\n  capture<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Captures a frame from the current camera preview without using the full camera capture pipeline.\n   *\n   * Unlike `capture()` which may trigger hardware-level photo capture on native platforms,\n   * this method quickly samples the current video stream. This is suitable computer vision or\n   * simple snapshots where high fidelity is not required.\n   *\n   * On web this method does exactly the same as `capture()` as it only captures a frame from the video stream\n   * because unfortunately [ImageCapture API](https://developer.mozilla.org/en-US/docs/Web/API/ImageCapture) is\n   * not yet well supported on the web.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured sample\n   *\n   * @since 1.0.0\n   */\n  captureSample<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Switch between front and back camera.\n   *\n   * @returns A promise that resolves when the camera has been flipped\n   *\n   * @since 1.0.0\n   */\n  flipCamera(): Promise<void>;\n\n  /**\n   * Get available camera devices for capturing photos.\n   *\n   * @returns A promise that resolves with an object containing an array of available capture devices\n   *\n   * @since 1.0.0\n   */\n  getAvailableDevices(): Promise<GetAvailableDevicesResponse>;\n\n  /**\n   * Get current zoom level information and available range.\n   *\n   * @remarks\n   * Make sure the camera is properly initialized before calling this method. Otherwise, this might\n   * lead to returning default values on android.\n   *\n   * @returns A promise that resolves with an object containing min, max and current zoom levels\n   *\n   * @since 1.0.0\n   */\n  getZoom(): Promise<GetZoomResponse>;\n\n  /**\n   * Set the camera zoom level.\n   *\n   * @param options - Zoom configuration options\n   * @param options.level - The zoom level to set\n   * @param options.ramp - Whether to animate the zoom level change, defaults to false (iOS only)\n   * @returns A promise that resolves when the zoom level has been set\n   *\n   * @remarks\n   * On web platforms, zoom functionality may be limited by browser support.\n   * When native zoom is not available, a CSS-based zoom simulation is applied.\n   *\n   * @since 1.0.0\n   */\n  setZoom(options: { level: number; ramp?: boolean }): Promise<void>;\n\n  /**\n   * Get current flash mode setting.\n   *\n   * @returns A promise that resolves with an object containing the current flash mode\n   *\n   * @since 1.0.0\n   */\n  getFlashMode(): Promise<GetFlashModeResponse>;\n\n  /**\n   * Get supported flash modes for the current camera.\n   *\n   * @returns A promise that resolves with an object containing an array of supported flash modes\n   *\n   * @since 1.0.0\n   */\n  getSupportedFlashModes(): Promise<GetSupportedFlashModesResponse>;\n\n  /**\n   * Set the camera flash mode.\n   *\n   * @param options - Flash mode configuration options\n   * @param options.mode - The flash mode to set\n   * @returns A promise that resolves when the flash mode has been set\n   *\n   * @since 1.0.0\n   */\n  setFlashMode(options: { mode: FlashMode }): Promise<void>;\n\n  /**\n   * Check if the device supports torch (flashlight) functionality.\n   *\n   * @remarks\n   * **Important**: You must call this method and verify torch availability before using\n   * `setTorchMode()` or `getTorchMode()`. Calling torch methods on devices without\n   * torch support will throw an exception.\n   *\n   * @returns A promise that resolves with an object containing torch availability status\n   *\n   * @since 1.2.0\n   */\n  isTorchAvailable(): Promise<IsTorchAvailableResponse>;\n\n  /**\n   * Get the current torch (flashlight) state.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * @returns A promise that resolves with an object containing the current torch state\n   *\n   * @since 1.2.0\n   */\n  getTorchMode(): Promise<GetTorchModeResponse>;\n\n  /**\n   * Set the torch (flashlight) mode and intensity.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * The torch provides continuous illumination, unlike flash which only activates during photo capture.\n   * On iOS, you can control the torch intensity level. On Android, the torch is either on or off.\n   *\n   * @param options - Torch configuration options\n   * @param options.enabled - Whether to enable or disable the torch\n   * @param options.level - The torch intensity level (0.0 to 1.0, iOS only). Defaults to 1.0 when enabled\n   * @returns A promise that resolves when the torch mode has been set\n   *\n   * @since 1.2.0\n   */\n  setTorchMode(options: { enabled: boolean; level?: number }): Promise<void>;\n\n  /**\n   * Check camera permission status without requesting permissions.\n   *\n   * @returns A promise that resolves with an object containing the camera permission status\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request camera permission from the user.\n   *\n   * @returns A promise that resolves with an object containing the camera permission status\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Listen for barcode detection events.\n   * This event is emitted when a barcode is detected in the camera preview.\n   *\n   * @param eventName - The name of the event to listen for ('barcodeDetected')\n   * @param listenerFunc - The callback function to execute when a barcode is detected\n   * @returns A promise that resolves with an event subscription\n   *\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'barcodeDetected',\n    listenerFunc: (data: BarcodeDetectionData) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @param eventName - Optional event name to remove listeners for\n   * @returns A promise that resolves when the listeners are removed\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(eventName?: string): Promise<void>;\n}\n\n// ------------------------------------------------------------------------------\n// Camera Configuration Types\n// ------------------------------------------------------------------------------\n\n/**\n * Position options for the camera.\n * - 'front': Front-facing camera\n * - 'back': Rear-facing camera\n *\n * @since 1.0.0\n */\nexport type CameraPosition = 'front' | 'back';\n\n/**\n * Flash mode options for the camera.\n * - 'off': Flash disabled\n * - 'on': Flash always on\n * - 'auto': Flash automatically enabled in low-light conditions\n *\n * @since 1.0.0\n */\nexport type FlashMode = 'off' | 'on' | 'auto';\n\n/**\n * Represents a physical camera device on the device.\n *\n * @since 1.0.0\n */\nexport interface CameraDevice {\n  /** The unique identifier of the camera device */\n  id: string;\n\n  /** The human-readable name of the camera device */\n  name: string;\n\n  /** The position of the camera device (front or back) */\n  position: CameraPosition;\n\n  /** The type of the camera device (e.g., wide, ultra-wide, telephoto) - iOS only */\n  deviceType?: CameraDeviceType;\n}\n\n/**\n * Available camera device types for iOS.\n * Maps to AVCaptureDevice DeviceTypes in iOS.\n *\n * @see https://developer.apple.com/documentation/avfoundation/avcapturedevice/devicetype-swift.struct\n *\n * @since 1.0.0\n */\nexport type CameraDeviceType =\n  /** builtInWideAngleCamera - standard camera */\n  | 'wideAngle'\n  /** builtInUltraWideCamera - 0.5x zoom level */\n  | 'ultraWide'\n  /** builtInTelephotoCamera - 2x/3x zoom level */\n  | 'telephoto'\n  /** builtInDualCamera - wide + telephoto combination */\n  | 'dual'\n  /** builtInDualWideCamera - wide + ultraWide combination */\n  | 'dualWide'\n  /** builtInTripleCamera - wide + ultraWide + telephoto */\n  | 'triple'\n  /** builtInTrueDepthCamera - front-facing camera with depth sensing */\n  | 'trueDepth';\n\n/**\n * Supported barcode types for detection.\n * Specifying only the barcode types you need can improve performance\n * and reduce battery consumption.\n *\n * @since 2.1.0\n */\nexport type BarcodeType =\n  /** QR Code */\n  | 'qr'\n  /** Code 128 barcode */\n  | 'code128'\n  /** Code 39 barcode */\n  | 'code39'\n  /** Code 39 Mod 43 barcode */\n  | 'code39Mod43'\n  /** Code 93 barcode */\n  | 'code93'\n  /** EAN-8 barcode */\n  | 'ean8'\n  /** EAN-13 barcode */\n  | 'ean13'\n  /** Interleaved 2 of 5 barcode */\n  | 'interleaved2of5'\n  /** ITF-14 barcode */\n  | 'itf14'\n  /** PDF417 barcode */\n  | 'pdf417'\n  /** Aztec code */\n  | 'aztec'\n  /** Data Matrix code */\n  | 'dataMatrix'\n  /** UPC-E barcode */\n  | 'upce';\n\n/**\n * Configuration options for starting a camera session.\n *\n * @since 1.0.0\n */\nexport interface CameraSessionConfiguration {\n  /**\n   * Enables the barcode detection functionality\n   * @default false\n   */\n  enableBarcodeDetection?: boolean;\n\n  /**\n   * Specific barcode types to detect. If not provided, all supported types are detected.\n   * Specifying only the types you need can significantly improve performance and reduce\n   * battery consumption, especially on mobile devices.\n   *\n   * @example ['qr', 'code128'] // Only detect QR codes and Code 128 barcodes\n   * @default undefined - all supported types are detected\n   * @since 2.1.0\n   */\n  barcodeTypes?: BarcodeType[];\n\n  /**\n   * Position of the camera to use\n   * @default 'back'\n   */\n  position?: CameraPosition;\n\n  /**\n   * Specific device ID of the camera to use\n   * If provided, takes precedence over position\n   */\n  deviceId?: string;\n\n  /**\n   * Whether to use the triple camera if available (iPhone Pro models only)\n   * @default false\n   */\n  useTripleCameraIfAvailable?: boolean;\n\n  /**\n   * Ordered list of preferred camera device types to use (iOS only).\n   * The system will attempt to use the first available camera type in the list.\n   * If position is also provided, the system will use the first available camera type\n   * that matches the position and is in the list.\n   *\n   * This will fallback to the default camera type if none of the preferred types are available.\n   *\n   * @example [CameraDeviceType.WideAngle, CameraDeviceType.UltraWide, CameraDeviceType.Telephoto]\n   * @default undefined - system will decide based on position/deviceId\n   */\n  preferredCameraDeviceTypes?: CameraDeviceType[];\n\n  /**\n   * The initial zoom factor to use\n   * @default 1.0\n   */\n  zoomFactor?: number;\n\n  /**\n   * Optional HTML ID of the container element where the camera view should be rendered.\n   * If not provided, the camera view will be appended to the document body. Web only.\n   * @example 'cameraContainer'\n   */\n  containerElementId?: string;\n}\n\n/**\n * Configuration options for capturing photos and samples.\n *\n * @since 1.1.0\n */\nexport interface CaptureOptions {\n  /**\n   * The JPEG quality of the captured photo/sample on a scale of 0-100\n   * @since 1.1.0\n   */\n  quality: number;\n\n  /**\n   * If true, saves to a temporary file and returns the web path instead of base64.\n   * The web path can be used to set the src attribute of an image for efficient loading and rendering.\n   * This reduces the data that needs to be transferred over the bridge, which can improve performance\n   * especially for high-resolution images.\n   * @default false\n   * @since 1.1.0\n   */\n  saveToFile?: boolean;\n}\n\n// ------------------------------------------------------------------------------\n// Response Interfaces\n// ------------------------------------------------------------------------------\n\n/**\n * Response for checking if the camera view is running.\n *\n * @since 1.0.0\n */\nexport interface IsRunningResponse {\n  /** Indicates if the camera view is currently active and running */\n  isRunning: boolean;\n}\n\n/**\n * Response for capturing a photo\n * This will contain either a base64 encoded string or a web path to the captured photo,\n * depending on the `saveToFile` option in the CaptureOptions.\n * @since 1.0.0\n */\nexport type CaptureResponse<T extends CaptureOptions = CaptureOptions> = T['saveToFile'] extends true\n  ? {\n      /** The web path to the captured photo that can be used to set the src attribute of an image for efficient loading and rendering (when saveToFile is true) */\n      webPath: string;\n    }\n  : {\n      /** The base64 encoded string of the captured photo (when saveToFile is false or undefined) */\n      photo: string;\n    };\n\n/**\n * Response for getting available camera devices.\n *\n * @since 1.0.0\n */\nexport interface GetAvailableDevicesResponse {\n  /** An array of available camera devices */\n  devices: CameraDevice[];\n}\n\n/**\n * Response for getting zoom level information.\n *\n * @since 1.0.0\n */\nexport interface GetZoomResponse {\n  /** The minimum zoom level supported */\n  min: number;\n\n  /** The maximum zoom level supported */\n  max: number;\n\n  /** The current zoom level */\n  current: number;\n}\n\n/**\n * Response for getting the current flash mode.\n *\n * @since 1.0.0\n */\nexport interface GetFlashModeResponse {\n  /** The current flash mode setting */\n  flashMode: FlashMode;\n}\n\n/**\n * Response for getting supported flash modes.\n *\n * @since 1.0.0\n */\nexport interface GetSupportedFlashModesResponse {\n  /** An array of flash modes supported by the current camera */\n  flashModes: FlashMode[];\n}\n\n/**\n * Response for checking torch availability.\n *\n * @since 1.2.0\n */\nexport interface IsTorchAvailableResponse {\n  /** Indicates if the device supports torch (flashlight) functionality */\n  available: boolean;\n}\n\n/**\n * Response for getting the current torch mode.\n *\n * @since 1.2.0\n */\nexport interface GetTorchModeResponse {\n  /** Indicates if the torch is currently enabled */\n  enabled: boolean;\n  /** The current torch intensity level (0.0 to 1.0, iOS only). Always 1.0 on Android when enabled */\n  level: number;\n}\n\n/**\n * Data for a detected barcode.\n *\n * @since 1.0.0\n */\nexport interface BarcodeDetectionData {\n  /** The decoded string value of the barcode */\n  value: string;\n\n  /**\n   * Raw bytes as they were encoded in the barcode.\n   *\n   * On Android, this is forwarded from ML Kit.\n   * On iOS, this is available for descriptor-backed formats such as QR, Aztec, PDF417, and Data Matrix.\n   * On web, this is not available because the Barcode Detection API only exposes the decoded string value.\n   *\n   * @since 2.2.0\n   */\n  rawBytes?: number[];\n\n  /**\n   * The display value of the barcode on Android.\n   *\n   * This is forwarded from ML Kit and may contain a formatted, human-readable\n   * representation that differs from the raw decoded value. iOS and web do not\n   * expose a separate display value, so this property is only emitted on Android.\n   */\n  displayValue?: string;\n\n  /** The type/format of the barcode (e.g., 'qr', 'code128', etc.) */\n  type: string;\n\n  /** The bounding rectangle of the barcode in the camera frame. */\n  boundingRect: BoundingRect;\n}\n\n/**\n * Rectangle defining the boundary of the barcode in the camera frame.\n * Coordinates are normalized between 0 and 1 relative to the camera frame.\n *\n * @since 1.0.0\n */\nexport interface BoundingRect {\n  /** X-coordinate of the top-left corner */\n  x: number;\n  /** Y-coordinate of the top-left corner */\n  y: number;\n  /** Width of the bounding rectangle (should match the actual width of the barcode) */\n  width: number;\n  /** Height of the bounding rectangle (should match the actual height of the barcode) */\n  height: number;\n}\n\n/**\n * Response for the camera permission status.\n *\n * @since 1.0.0\n */\nexport interface PermissionStatus {\n  /** The state of the camera permission */\n  camera: PermissionState;\n}\n"]}

package/ios/Sources/CameraViewPlugin/CameraEvents.swift

@@ -8,27 +8,33 @@ import Foundation
 public struct BarcodeDetectedEvent: Sendable {
     /// The decoded string value of the barcode.
     public let value: String
-    
+
+    /// The barcode value in a human readable format.
+    public let displayValue: String?
+
+    /// Raw bytes as they were encoded in the barcode when the platform exposes them.
+    public let rawBytes: [UInt8]?
+
     /// The type of barcode detected (e.g., "org.iso.QRCode").
     public let type: String
-    
+
     /// The bounding rectangle of the barcode in screen coordinates.
     public let boundingRect: BoundingRect
-    
+
     /// Bounding rectangle coordinates.
     public struct BoundingRect: Sendable {
         public let x: Double
         public let y: Double
         public let width: Double
         public let height: Double
-        
+
         public init(x: Double, y: Double, width: Double, height: Double) {
             self.x = x
             self.y = y
             self.width = width
             self.height = height
         }
-        
+
         /// Converts to dictionary for Capacitor event emission.
         public func toDictionary() -> [String: Double] {
             return [
@@ -39,20 +45,38 @@ public struct BarcodeDetectedEvent: Sendable {
             ]
         }
     }
-    
-    public init(value: String, type: String, boundingRect: BoundingRect) {
+
+    public init(
+        value: String,
+        displayValue: String? = nil,
+        rawBytes: [UInt8]? = nil,
+        type: String,
+        boundingRect: BoundingRect
+    ) {
         self.value = value
+        self.displayValue = displayValue
+        self.rawBytes = rawBytes
         self.type = type
         self.boundingRect = boundingRect
     }
-    
+
     /// Converts to dictionary for Capacitor event emission.
     public func toDictionary() -> [String: Any] {
-        return [
+        var dictionary: [String: Any] = [
             "value": value,
             "type": type,
             "boundingRect": boundingRect.toDictionary()
         ]
+
+        if let displayValue {
+            dictionary["displayValue"] = displayValue
+        }
+
+        if let rawBytes {
+            dictionary["rawBytes"] = rawBytes.map(Int.init)
+        }
+
+        return dictionary
     }
 }
 
@@ -81,7 +105,7 @@ public protocol CameraEventDelegate: AnyObject {
 /// These maintain backwards compatibility with the NotificationCenter-based event system.
 public extension Notification.Name {
     /// Posted when a barcode is detected.
-    /// UserInfo contains: "value", "type", "boundingRect"
+    /// UserInfo contains: "value", "displayValue", "rawBytes", "type", "boundingRect"
     static let cameraViewBarcodeDetected = Notification.Name("barcodeDetected")
 }
 
@@ -92,13 +116,13 @@ public extension Notification.Name {
 internal final class CameraEventEmitter {
     /// Weak reference to the delegate to avoid retain cycles.
     weak var delegate: CameraEventDelegate?
-    
+
     /// Emits a barcode detected event through both channels.
     /// - Parameter event: The barcode detection event to emit.
     func emitBarcodeDetected(_ event: BarcodeDetectedEvent) {
         // Call typed delegate first (preferred path)
         delegate?.cameraDidDetectBarcode(event)
-        
+
         // Also post to NotificationCenter for backwards compatibility
         NotificationCenter.default.post(
             name: .cameraViewBarcodeDetected,

package/ios/Sources/CameraViewPlugin/CameraViewManager+BarcodeScan.swift

@@ -1,4 +1,5 @@
 import AVFoundation
+import CoreImage
 import Foundation
 
 extension CameraViewManager: AVCaptureMetadataOutputObjectsDelegate {
@@ -36,7 +37,7 @@ extension CameraViewManager: AVCaptureMetadataOutputObjectsDelegate {
     }
 
     /// Remove the metadata output if in case it is already configured, e.g. because
-    /// the camera is restarted with a diffrent setting where barcode detection was disabled
+    /// the camera is restarted with a different setting where barcode detection was disabled
     /// again
     internal func removeMetadataOutput() {
         if let metadataOutput = captureSession.outputs.first(where: { $0 is AVCaptureMetadataOutput }) {
@@ -62,7 +63,13 @@ extension CameraViewManager: AVCaptureMetadataOutputObjectsDelegate {
         else {
             return
         }
-        guard let barcodeValue = metadataObject.stringValue else { return }
+
+        let barcodeValue = metadataObject.stringValue ?? ""
+        let rawBytes = getRawBytes(from: metadataObject)
+
+        if barcodeValue.isEmpty && rawBytes == nil {
+            return
+        }
 
         let barcodeType = metadataObject.type.rawValue
 
@@ -83,7 +90,31 @@ extension CameraViewManager: AVCaptureMetadataOutputObjectsDelegate {
         )
 
         eventEmitter.emitBarcodeDetected(
-            BarcodeDetectedEvent(value: barcodeValue, type: barcodeType, boundingRect: boundingRect)
+            BarcodeDetectedEvent(
+                value: barcodeValue,
+                rawBytes: rawBytes,
+                type: barcodeType,
+                boundingRect: boundingRect
+            )
         )
     }
+
+    private func getRawBytes(from metadataObject: AVMetadataMachineReadableCodeObject) -> [UInt8]? {
+        guard let descriptor = metadataObject.descriptor else {
+            return nil
+        }
+
+        switch descriptor {
+        case let descriptor as CIQRCodeDescriptor:
+            return [UInt8](descriptor.errorCorrectedPayload)
+        case let descriptor as CIAztecCodeDescriptor:
+            return [UInt8](descriptor.errorCorrectedPayload)
+        case let descriptor as CIPDF417CodeDescriptor:
+            return [UInt8](descriptor.errorCorrectedPayload)
+        case let descriptor as CIDataMatrixCodeDescriptor:
+            return [UInt8](descriptor.errorCorrectedPayload)
+        default:
+            return nil
+        }
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-camera-view",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "A Capacitor plugin for embedding a live camera feed directly into your app.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -48,32 +48,32 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@capacitor/android": "^8.1.0",
-    "@capacitor/core": "^8.1.0",
+    "@capacitor/android": "^8.3.1",
+    "@capacitor/core": "^8.3.1",
     "@capacitor/docgen": "^0.3.1",
-    "@capacitor/ios": "^8.1.0",
-    "@commitlint/config-conventional": "^20.4.2",
+    "@capacitor/ios": "^8.3.1",
+    "@commitlint/config-conventional": "^20.5.0",
     "@ionic/prettier-config": "^4.0.0",
     "@ionic/swiftlint-config": "^2.0.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^12.0.6",
-    "@semantic-release/npm": "^13.1.4",
+    "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@typescript-eslint/eslint-plugin": "^8.56.0",
-    "@typescript-eslint/parser": "^8.56.0",
-    "commitlint": "^20.4.2",
+    "@typescript-eslint/eslint-plugin": "^8.59.1",
+    "@typescript-eslint/parser": "^8.59.1",
+    "commitlint": "^20.5.2",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "husky": "^9.1.7",
-    "prettier": "^3.8.1",
+    "prettier": "^3.8.3",
     "prettier-plugin-java": "^2.8.1",
     "prettier-plugin-organize-imports": "^4.3.0",
-    "prettier-plugin-packagejson": "^3.0.0",
+    "prettier-plugin-packagejson": "^3.0.2",
     "rimraf": "^6.1.3",
-    "rollup": "^4.58.0",
+    "rollup": "^4.60.2",
     "semantic-release": "^25.0.3",
     "swiftlint": "^2.0.0",
     "typescript": "^5.9.3"