@microblink/camera-manager 7.2.3 → 7.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microblink/camera-manager",
-  "version": "7.2.3",
+  "version": "7.2.5",
   "author": "Microblink",
   "type": "module",
   "main": "./dist/camera-manager.js",

package/types/core/CameraManager.d.ts

@@ -52,10 +52,19 @@ export type StartCameraStreamOptions = {
  * Options for the CameraManager.
  *
  * @param mirrorFrontCameras - If true, front-facing cameras will be mirrored horizontally when started.
+ * @param preferredResolution - The desired video resolution for camera streams. This is used as the ideal resolution when starting camera streams. If a camera doesn't support the specified resolution, the camera will automatically fall back to the next lower supported resolution in this order: 4k → 1080p → 720p.
  */
 export type CameraManagerOptions = {
     /** If true, the camera stream will be mirrored horizontally when started. */
     mirrorFrontCameras: boolean;
+    /**
+     * The desired video resolution for camera streams. This is used as the ideal resolution
+     * when starting camera streams. If a camera doesn't support the specified resolution,
+     * the camera will automatically fall back to the next lower supported resolution in this order:
+     * 4k → 1080p → 720p. The actual resolution used may differ from this setting based on
+     * camera capabilities and system constraints.
+     */
+    preferredResolution: VideoResolutionName;
 };
 /**
  * Default options for the CameraManager.
@@ -88,13 +97,20 @@ export declare class CameraManager {
      */
     constructor(options?: Partial<CameraManagerOptions>, videoFrameProcessorOptions?: VideoFrameProcessorInitOptions);
     /**
-     * Sets the resolution of the camera stream.
+     * Sets the desired video resolution for camera streams. This is used as the ideal resolution
+     * when starting camera streams. If a camera doesn't support the specified resolution,
+     * the camera will automatically fall back to the next lower supported resolution in this order:
+     * 4k → 1080p → 720p. If there's an active stream, it will be restarted with the new resolution.
      *
-     * @param resolution - The resolution to set.
+     * @param resolution - The ideal resolution to set for camera streams.
      */
     setResolution: (resolution: VideoResolutionName) => Promise<void>;
     /**
-     * The resolution of the camera stream.
+     * The desired video resolution for camera streams. This is used as the ideal resolution
+     * when starting camera streams. If a camera doesn't support the specified resolution,
+     * the camera will automatically fall back to the next lower supported resolution in this order:
+     * 4k → 1080p → 720p. The actual resolution used may differ from this setting based on
+     * camera capabilities and system constraints.
      */
     get resolution(): "720p" | "1080p" | "4k";
     /**

package/types/core/CameraManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CameraManager.d.ts","sourceRoot":"","sources":["../../src/core/CameraManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAQnE,OAAO,EAGL,kBAAkB,IAAI,KAAK,EAC5B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EACL,cAAc,EAGd,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,KAAK,EAAE,SAAS,KACb,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAExC;;;;;GAKG;AACH,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAEE,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,GACD;IAEE,eAAe,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1C,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,GACD;IAEE,eAAe,EAAE,UAAU,CAAC;IAC5B,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,GACD;IAEE,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B,CAAC;AAEN;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,gBAAgB,CAAC;AAErB;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,6EAA6E;IAC7E,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,oBAEhC,CAAC;AAEX;;;;GAIG;AACH,qBAAa,aAAa;;IAmBxB;;;OAGG;IACH,IAAI,kBAAkB,IAIQ,OAAO,CAFpC;IAED,IAAI,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAEpC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,cAAc,EAAE,cAAc;IAUhD;;;;;OAKG;gBAED,OAAO,GAAE,OAAO,CAAC,oBAAoB,CAAM,EAC3C,0BAA0B,CAAC,EAAE,8BAA8B;IAa7D;;;;OAIG;IACH,aAAa,GAAU,YAAY,mBAAmB,mBAUpD;IAEF;;OAEG;IACH,IAAI,UAAU,4BAEb;IAED;;;;OAIG;IACH,IAAI,QAAQ,YAGX;IAED;;;;OAIG;IACH,eAAe,CAAC,YAAY,EAAE,UAAU,EAAE;IAM1C;;;;;OAKG;IACG,gBAAgB;IAwHtB;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,gBAAgB;IAY/C;;;;;;OAMG;IACH,uBAAuB,CAAC,oBAAoB,EAAE,oBAAoB;IAKlE;;OAEG;IACH,mBAAmB;IASnB;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM;IA0DjC;;;;OAIG;IACG,oBAAoB;IAuE1B;;;;OAIG;IACG,aAAa;IAuFnB;;;;OAIG;IACH,iBAAiB,sBAUf;IAkHF;;;;;;OAMG;IACG,iBAAiB,CAAC,MAAM,GAAE,wBAA6B;IA0B7D;;OAEG;IACH,gBAAgB;IAMhB;;OAEG;IACH,UAAU;IAYV;;OAEG;IACH,aAAa;IAmIb;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO;IAyBjC;;;;;;OAMG;IACH,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,CAAmB;IAEpD;;;;OAIG;IACH,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,CAAkB;IAEjD;;OAEG;IACH,KAAK;CAMN"}
+{"version":3,"file":"CameraManager.d.ts","sourceRoot":"","sources":["../../src/core/CameraManager.ts"],"names":[],"mappings":"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"}

package/types/core/CameraManager.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Copyright (c) 2025 Microblink Ltd. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=CameraManager.test.d.ts.map

package/types/core/CameraManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraManager.test.d.ts","sourceRoot":"","sources":["../../src/core/CameraManager.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/types/index.rollup.d.ts

@@ -139,13 +139,20 @@ export declare class CameraManager {
      */
     constructor(options?: Partial<CameraManagerOptions>, videoFrameProcessorOptions?: VideoFrameProcessorInitOptions);
     /**
-     * Sets the resolution of the camera stream.
+     * Sets the desired video resolution for camera streams. This is used as the ideal resolution
+     * when starting camera streams. If a camera doesn't support the specified resolution,
+     * the camera will automatically fall back to the next lower supported resolution in this order:
+     * 4k → 1080p → 720p. If there's an active stream, it will be restarted with the new resolution.
      *
-     * @param resolution - The resolution to set.
+     * @param resolution - The ideal resolution to set for camera streams.
      */
     setResolution: (resolution: VideoResolutionName) => Promise<void>;
     /**
-     * The resolution of the camera stream.
+     * The desired video resolution for camera streams. This is used as the ideal resolution
+     * when starting camera streams. If a camera doesn't support the specified resolution,
+     * the camera will automatically fall back to the next lower supported resolution in this order:
+     * 4k → 1080p → 720p. The actual resolution used may differ from this setting based on
+     * camera capabilities and system constraints.
      */
     get resolution(): "720p" | "1080p" | "4k";
     /**
@@ -290,10 +297,19 @@ export declare type CameraManagerComponent = {
  * Options for the CameraManager.
  *
  * @param mirrorFrontCameras - If true, front-facing cameras will be mirrored horizontally when started.
+ * @param preferredResolution - The desired video resolution for camera streams. This is used as the ideal resolution when starting camera streams. If a camera doesn't support the specified resolution, the camera will automatically fall back to the next lower supported resolution in this order: 4k → 1080p → 720p.
  */
 export declare type CameraManagerOptions = {
     /** If true, the camera stream will be mirrored horizontally when started. */
     mirrorFrontCameras: boolean;
+    /**
+     * The desired video resolution for camera streams. This is used as the ideal resolution
+     * when starting camera streams. If a camera doesn't support the specified resolution,
+     * the camera will automatically fall back to the next lower supported resolution in this order:
+     * 4k → 1080p → 720p. The actual resolution used may differ from this setting based on
+     * camera capabilities and system constraints.
+     */
+    preferredResolution: VideoResolutionName;
 };
 
 /**

package/types/ui/CaptureScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CaptureScreen.d.ts","sourceRoot":"","sources":["../../src/ui/CaptureScreen.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,SAAS,EAOV,MAAM,UAAU,CAAC;AAwBlB;;GAEG;AACH,eAAO,MAAM,kCAAkC,wBAAwB,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,SAsK3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA4DpC,CAAC"}
+{"version":3,"file":"CaptureScreen.d.ts","sourceRoot":"","sources":["../../src/ui/CaptureScreen.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,SAAS,EAOV,MAAM,UAAU,CAAC;AAwBlB;;GAEG;AACH,eAAO,MAAM,kCAAkC,wBAAwB,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,SAkL3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA4DpC,CAAC"}