From fa8dafcfd36798f891709e9a4e01f98f627e792a Mon Sep 17 00:00:00 2001 From: Jenny-Jiani <70129215+Jenny-Jiani@users.noreply.github.com> Date: Wed, 30 Sep 2026 10:45:35 +0800 Subject: [PATCH 1/9] update camera-preview-renders-incorrectly-ios.md --- ...mera-preview-renders-incorrectly-ios-27.md | 102 +++++++++++++++++ .../camera-preview-renders-incorrectly-ios.md | 107 +----------------- .../camera-preview-renders-incorrectly-ios.md | 10 +- 3 files changed, 114 insertions(+), 105 deletions(-) create mode 100644 _includes/shared/camera-preview-renders-incorrectly-ios-27.md diff --git a/_includes/shared/camera-preview-renders-incorrectly-ios-27.md b/_includes/shared/camera-preview-renders-incorrectly-ios-27.md new file mode 100644 index 0000000..b56655f --- /dev/null +++ b/_includes/shared/camera-preview-renders-incorrectly-ios-27.md @@ -0,0 +1,102 @@ +# Why does the camera preview render incorrectly on iOS 27? + +## Applicable Products + +This article applies to: + +- Dynamsoft Barcode Reader (DBR) JavaScript SDK (`dynamsoft-barcode-reader-bundle`) 11.6.3000 and earlier +- Dynamsoft Capture Vision (DCV) JavaScript SDK (`dynamsoft-capture-vision-bundle`) 3.6.3000 and earlier + +## Summary + +On iOS 27, switching cameras or changing resolution can make the live camera preview render incorrectly. The exact behavior depends on the SDK version: + +| Version | Behavior | +|---|---| +| DBR 11.4 - 11.6.3000 (DCV 3.4 - 3.6.3000) | The preview renders distorted - squeezed or stretched instead of filling its container. Intermittent: the same switch can render correctly on one attempt and distorted on the next. | +| DBR 11.2 and earlier (DCV 3.2 and earlier) | The preview isn't distorted, but it no longer fits its container - shown at the wrong zoom or size and not extending to the borders. | + +It's reproducible on Safari, Chrome, Edge, and Firefox - all iOS browsers share WebKit's camera implementation, so we suspect the issue originates there rather than in any Dynamsoft SDK. It does not occur on iOS 26. + +> [!NOTE] +> Reported to Apple, but not confirmed as an Apple bug and still open as of iOS 27 RC. Details here may change if Apple ships a fix. + +
+
+ Camera video rendering correctly on iOS +
Expected
+
+
+ Camera video rendering distorted after switching cameras on iOS 27 +
Distorted after switching cameras
+
+
+ +## Resolution + +### Recommended: upgrade + +Upgrade to `dynamsoft-barcode-reader-bundle` **11.6.3200+** or `dynamsoft-capture-vision-bundle` **3.6.3200+**, which include a built-in workaround. + +### If you can't upgrade yet + +Both workarounds below are temporary and version-specific - neither replaces upgrading. + +**DBR 11.4 - 11.6.3000 (DCV 3.4 - 3.6.3000)** + +The distortion requires `object-fit: fill` on the video element plus an ancestor using `display: flex` with `flex: 0 0 auto`, so overriding `object-fit` with `cover` on the `