cordova-plugin-mlkit-suite 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.2.1 - 2026-10-26
+
+- Added the optional `beepEnabled` Face Capture confirmation sound, enabled by default on Android and iOS.
+- Reused one synthesized native confirmation tone for Barcode Scanning and Face Capture.
+
 ## 0.2.0 - 2026-10-26
 
 - Added default-model Image Labeling on Android and iOS, including configurable Android model delivery.

package/README.md

@@ -429,6 +429,7 @@ All checks are enabled by default. Capture starts automatically only after they
 | `jpegQuality` | integer `50–100` | `95` | JPEG encoding quality. |
 | `showCloseButton` | `boolean` | `true` | Shows the native close button. |
 | `debugMode` | `boolean` | `false` | Shows face bounds and live quality values without weakening validation. |
+| `beepEnabled` | `boolean` | `true` | Plays a short synthesized confirmation beep after a successful capture. Device silent mode is respected. |
 | `instructionText` | `string \| null` | `"Place your face inside the oval"` | Text shown above the guide. An empty string hides it. |
 | `moduleLoadingMessage` | `string \| null` | localized | Android text shown only while downloading Face Detection. Empty string shows only the spinner. |
 | `locale` | `string` | `"auto"` | Plugin UI/error locale (`en`, `es`, or BCP-47). |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-mlkit-suite",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Extensible Google ML Kit suite for Cordova document, text, barcode, image labeling, selfie and subject segmentation, and guided face processing.",
   "license": "MIT",
   "author": "Andres Zs",

package/plugin.xml

@@ -3,7 +3,7 @@
         xmlns:android="http://schemas.android.com/apk/res/android"
         xmlns:tools="http://schemas.android.com/tools"
         id="cordova-plugin-mlkit-suite"
-        version="0.2.0">
+        version="0.2.1">
     <name>ML Kit Suite</name>
     <description>Extensible Google ML Kit suite for document, text, barcode, image labeling, selfie and subject segmentation, and guided face processing.</description>
     <license>MIT</license>
@@ -81,6 +81,7 @@
         <resource-file src="src/android/res/values/mlkit_suite_strings.xml" target="res/values/mlkit_suite_strings.xml" />
         <resource-file src="src/android/res/values-es/mlkit_suite_strings.xml" target="res/values-es/mlkit_suite_strings.xml" />
         <source-file src="src/android/java/MlKitLocalization.java" target-dir="app/src/main/java/com/andreszs/plugins/mlkitsuite" />
+        <source-file src="src/android/java/MlKitSuccessBeep.java" target-dir="app/src/main/java/com/andreszs/plugins/mlkitsuite" />
         <source-file src="src/android/java/MlKitSuitePlugin.java" target-dir="app/src/main/java/com/andreszs/plugins/mlkitsuite" />
         <source-file src="src/android/java/FaceCaptureActivity.java" target-dir="app/src/main/java/com/andreszs/plugins/mlkitsuite" />
         <source-file src="src/android/java/FaceCaptureConfig.java" target-dir="app/src/main/java/com/andreszs/plugins/mlkitsuite" />
@@ -115,6 +116,7 @@
         </config-file>
 
         <source-file src="src/ios/FaceCaptureTypes.swift" />
+        <source-file src="src/ios/MlKitSuccessBeep.swift" />
         <source-file src="src/ios/MlKitLocalization.swift" />
         <source-file src="src/ios/FaceOverlayView.swift" />
         <source-file src="src/ios/FaceStillProcessor.swift" />

package/src/android/java/BarcodeScanActivity.java

@@ -5,10 +5,6 @@ import android.content.Intent;
 import android.graphics.Bitmap;
 import android.graphics.Color;
 import android.graphics.Rect;
-import android.media.AudioAttributes;
-import android.media.AudioFormat;
-import android.media.AudioManager;
-import android.media.AudioTrack;
 import android.os.Bundle;
 import android.os.Handler;
 import android.os.Looper;
@@ -66,7 +62,7 @@ public final class BarcodeScanActivity extends Activity
     private ImageAnalysis imageAnalysis;
     private BarcodeFrameAnalyzer analyzer;
     private Camera camera;
-    private AudioTrack successBeep;
+    private MlKitSuccessBeep successBeep;
     private boolean torchEnabled;
     private boolean completed;
     private Runnable timeoutRunnable;
@@ -82,6 +78,7 @@ public final class BarcodeScanActivity extends Activity
         try {
             config = BarcodeScanConfig.fromJson(this, new JSONObject(
                 getIntent().getStringExtra(EXTRA_OPTIONS_JSON)));
+            successBeep = new MlKitSuccessBeep(this, mainHandler);
         } catch (Exception error) {
             finishWithError("INVALID_ARGUMENT", "Invalid barcode scan options.", false);
             return;
@@ -124,7 +121,7 @@ public final class BarcodeScanActivity extends Activity
         if (imageAnalysis != null) imageAnalysis.clearAnalyzer();
         if (analyzer != null) analyzer.close();
         if (cameraProvider != null) cameraProvider.unbindAll();
-        releaseSuccessBeep();
+        if (successBeep != null) successBeep.close();
         analysisExecutor.shutdownNow();
         lifecycleRegistry.handleLifecycleEvent(Lifecycle.Event.ON_DESTROY);
         super.onDestroy();
@@ -330,59 +327,7 @@ public final class BarcodeScanActivity extends Activity
     }
 
     private void playSuccessBeep() {
-        if (!config.beepEnabled) return;
-        AudioManager audioManager = (AudioManager) getSystemService(AUDIO_SERVICE);
-        if (audioManager != null && audioManager.getRingerMode() != AudioManager.RINGER_MODE_NORMAL) {
-            return;
-        }
-        final int sampleRate = 22050;
-        final int sampleCount = sampleRate / 10;
-        byte[] pcm = new byte[sampleCount * 2];
-        for (int index = 0; index < sampleCount; index++) {
-            double time = index / (double) sampleRate;
-            double remaining = (sampleCount - index) / (double) sampleRate;
-            double envelope = Math.min(1d, time / 0.005d) * Math.min(1d, remaining / 0.025d);
-            short sample = (short) Math.round(Math.sin(2d * Math.PI * 1800d * time)
-                * envelope * Short.MAX_VALUE * 0.55d);
-            pcm[index * 2] = (byte) (sample & 0xff);
-            pcm[index * 2 + 1] = (byte) ((sample >>> 8) & 0xff);
-        }
-        try {
-            AudioTrack track = new AudioTrack.Builder()
-                .setAudioAttributes(new AudioAttributes.Builder()
-                    .setUsage(AudioAttributes.USAGE_ASSISTANCE_SONIFICATION)
-                    .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
-                    .build())
-                .setAudioFormat(new AudioFormat.Builder()
-                    .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
-                    .setSampleRate(sampleRate)
-                    .setChannelMask(AudioFormat.CHANNEL_OUT_MONO)
-                    .build())
-                .setTransferMode(AudioTrack.MODE_STATIC)
-                .setBufferSizeInBytes(pcm.length)
-                .build();
-            if (track.write(pcm, 0, pcm.length) <= 0) {
-                track.release();
-                return;
-            }
-            releaseSuccessBeep();
-            successBeep = track;
-            track.play();
-            mainHandler.postDelayed(() -> {
-                if (successBeep == track) releaseSuccessBeep();
-            }, 250L);
-        } catch (Exception ignored) {
-            releaseSuccessBeep();
-        }
-    }
-
-    private void releaseSuccessBeep() {
-        if (successBeep == null) return;
-        try {
-            successBeep.stop();
-        } catch (Exception ignored) { }
-        successBeep.release();
-        successBeep = null;
+        if (config.beepEnabled && successBeep != null) successBeep.play();
     }
 
     private FrameLayout.LayoutParams matchParent() {

package/src/android/java/FaceCaptureActivity.java

@@ -41,6 +41,8 @@ import java.util.concurrent.Executors;
 public final class FaceCaptureActivity extends Activity
     implements LifecycleOwner, FaceFrameAnalyzer.Listener {
 
+    private static final long SUCCESS_BEEP_DELAY_MS = 250L;
+
     public static final String EXTRA_OPTIONS_JSON = "mlKitSuite.face.options";
     public static final String EXTRA_IMAGE_WEB_BASE_URL = "mlKitSuite.face.imageWebBaseUrl";
     public static final String EXTRA_RESULT_JSON = "mlKitSuite.face.result";
@@ -60,6 +62,7 @@ public final class FaceCaptureActivity extends Activity
     private ImageAnalysis imageAnalysis;
     private FaceFrameAnalyzer analyzer;
     private FaceStillProcessor stillProcessor;
+    private MlKitSuccessBeep successBeep;
     private String imageWebBaseUrl;
     private boolean capturing;
     private boolean completed;
@@ -78,6 +81,7 @@ public final class FaceCaptureActivity extends Activity
                 getIntent().getStringExtra(EXTRA_OPTIONS_JSON)));
             imageWebBaseUrl = getIntent().getStringExtra(EXTRA_IMAGE_WEB_BASE_URL);
             stillProcessor = new FaceStillProcessor(config);
+            successBeep = new MlKitSuccessBeep(this, mainHandler);
         } catch (Exception error) {
             finishWithError("INVALID_ARGUMENT", "Invalid face capture options.", false);
             return;
@@ -121,6 +125,7 @@ public final class FaceCaptureActivity extends Activity
         if (analyzer != null) analyzer.close();
         if (stillProcessor != null) stillProcessor.close();
         if (cameraProvider != null) cameraProvider.unbindAll();
+        if (successBeep != null) successBeep.close();
         analysisExecutor.shutdownNow();
         captureExecutor.shutdownNow();
         lifecycleRegistry.handleLifecycleEvent(Lifecycle.Event.ON_DESTROY);
@@ -291,8 +296,16 @@ public final class FaceCaptureActivity extends Activity
         } catch (Exception ignored) { }
         Intent intent = new Intent();
         intent.putExtra(EXTRA_RESULT_JSON, result.toString());
-        setResult(RESULT_OK, intent);
-        finish();
+        if (config.beepEnabled && successBeep != null) {
+            successBeep.play();
+            mainHandler.postDelayed(() -> {
+                setResult(RESULT_OK, intent);
+                finish();
+            }, SUCCESS_BEEP_DELAY_MS);
+        } else {
+            setResult(RESULT_OK, intent);
+            finish();
+        }
     }
 
     private void cancelByUser() {

package/src/android/java/FaceCaptureConfig.java

@@ -13,6 +13,7 @@ final class FaceCaptureConfig {
     final int jpegQuality;
     final boolean showCloseButton;
     final boolean debugMode;
+    final boolean beepEnabled;
     final String instructionText;
     final MlKitLocalization localization;
     final long timeoutMs;
@@ -24,6 +25,7 @@ final class FaceCaptureConfig {
         int jpegQuality,
         boolean showCloseButton,
         boolean debugMode,
+        boolean beepEnabled,
         String instructionText,
         MlKitLocalization localization,
         long timeoutMs,
@@ -34,6 +36,7 @@ final class FaceCaptureConfig {
         this.jpegQuality = jpegQuality;
         this.showCloseButton = showCloseButton;
         this.debugMode = debugMode;
+        this.beepEnabled = beepEnabled;
         this.instructionText = instructionText;
         this.localization = localization;
         this.timeoutMs = timeoutMs;
@@ -51,6 +54,7 @@ final class FaceCaptureConfig {
         int quality = strictInteger(options, "jpegQuality", 95, 50, 100);
         boolean close = strictBoolean(options, "showCloseButton", true);
         boolean debug = strictBoolean(options, "debugMode", false);
+        boolean beep = strictBoolean(options, "beepEnabled", true);
         String instruction = strictString(options, "instructionText",
             localization.text("face_instruction"));
         long timeout = strictLong(options, "timeoutMs", 0L, 0L, 600000L);
@@ -62,7 +66,7 @@ final class FaceCaptureConfig {
             }
             rawChecks = (JSONObject) value;
         }
-        return new FaceCaptureConfig(width, height, quality, close, debug, instruction,
+        return new FaceCaptureConfig(width, height, quality, close, debug, beep, instruction,
             localization, timeout, Checks.fromJson(rawChecks));
     }
 
@@ -72,7 +76,8 @@ final class FaceCaptureConfig {
             String key = keys.next();
             if (!("outputWidth".equals(key) || "outputHeight".equals(key)
                 || "jpegQuality".equals(key) || "showCloseButton".equals(key)
-                || "debugMode".equals(key) || "instructionText".equals(key)
+                || "debugMode".equals(key) || "beepEnabled".equals(key)
+                || "instructionText".equals(key)
                 || "timeoutMs".equals(key) || "checks".equals(key)
                 || "moduleLoadingMessage".equals(key) || "locale".equals(key))) {
                 throw new IllegalArgumentException("Unknown face capture option: " + key + ".");

package/src/android/java/MlKitSuccessBeep.java

@@ -0,0 +1,75 @@
+package com.andreszs.plugins.mlkitsuite;
+
+import android.content.Context;
+import android.media.AudioAttributes;
+import android.media.AudioFormat;
+import android.media.AudioManager;
+import android.media.AudioTrack;
+import android.os.Handler;
+
+final class MlKitSuccessBeep implements AutoCloseable {
+    private final Context context;
+    private final Handler mainHandler;
+    private AudioTrack track;
+
+    MlKitSuccessBeep(Context context, Handler mainHandler) {
+        this.context = context.getApplicationContext();
+        this.mainHandler = mainHandler;
+    }
+
+    void play() {
+        AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
+        if (audioManager != null && audioManager.getRingerMode() != AudioManager.RINGER_MODE_NORMAL) {
+            return;
+        }
+        final int sampleRate = 22050;
+        final int sampleCount = sampleRate / 10;
+        byte[] pcm = new byte[sampleCount * 2];
+        for (int index = 0; index < sampleCount; index++) {
+            double time = index / (double) sampleRate;
+            double remaining = (sampleCount - index) / (double) sampleRate;
+            double envelope = Math.min(1d, time / 0.005d) * Math.min(1d, remaining / 0.025d);
+            short sample = (short) Math.round(Math.sin(2d * Math.PI * 1800d * time)
+                * envelope * Short.MAX_VALUE * 0.55d);
+            pcm[index * 2] = (byte) (sample & 0xff);
+            pcm[index * 2 + 1] = (byte) ((sample >>> 8) & 0xff);
+        }
+        try {
+            AudioTrack nextTrack = new AudioTrack.Builder()
+                .setAudioAttributes(new AudioAttributes.Builder()
+                    .setUsage(AudioAttributes.USAGE_ASSISTANCE_SONIFICATION)
+                    .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
+                    .build())
+                .setAudioFormat(new AudioFormat.Builder()
+                    .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
+                    .setSampleRate(sampleRate)
+                    .setChannelMask(AudioFormat.CHANNEL_OUT_MONO)
+                    .build())
+                .setTransferMode(AudioTrack.MODE_STATIC)
+                .setBufferSizeInBytes(pcm.length)
+                .build();
+            if (nextTrack.write(pcm, 0, pcm.length) <= 0) {
+                nextTrack.release();
+                return;
+            }
+            close();
+            track = nextTrack;
+            nextTrack.play();
+            mainHandler.postDelayed(() -> {
+                if (track == nextTrack) close();
+            }, 200L);
+        } catch (Exception ignored) {
+            close();
+        }
+    }
+
+    @Override
+    public void close() {
+        if (track == null) return;
+        try {
+            track.stop();
+        } catch (Exception ignored) { }
+        track.release();
+        track = null;
+    }
+}

package/src/ios/BarcodeScanViewController.swift

@@ -24,7 +24,7 @@ final class BarcodeScanViewController: UIViewController {
     private var overlayView: BarcodeOverlayView!
     private var closeButton: UIButton?
     private var torchButton: UIButton?
-    private var successBeepPlayer: AVAudioPlayer?
+    private let successBeep = MlKitSuccessBeep()
     private var camera: AVCaptureDevice?
     private var processingFrame = false
     private var analysisFinished = false
@@ -372,7 +372,7 @@ final class BarcodeScanViewController: UIViewController {
             imageSize: imageSize,
             message: options.localization.text("barcode_success")
         )
-        playSuccessBeep()
+        if options.beepEnabled { successBeep.play() }
         sessionQueue.async { [session] in
             if session.isRunning { session.stopRunning() }
         }
@@ -391,73 +391,6 @@ final class BarcodeScanViewController: UIViewController {
         return UIImage(cgImage: cgImage, scale: 1, orientation: .right)
     }
 
-    private func playSuccessBeep() {
-        guard options.beepEnabled else { return }
-        do {
-            let session = AVAudioSession.sharedInstance()
-            try session.setCategory(.ambient, mode: .default, options: [.mixWithOthers])
-            try session.setActive(true)
-            let player = try AVAudioPlayer(data: Self.successBeepData)
-            player.volume = 1
-            player.prepareToPlay()
-            successBeepPlayer = player
-            player.play()
-            DispatchQueue.main.asyncAfter(deadline: .now() + 0.25) { [weak self] in
-                guard let self = self, self.successBeepPlayer === player else { return }
-                player.stop()
-                self.successBeepPlayer = nil
-                try? session.setActive(false, options: [.notifyOthersOnDeactivation])
-            }
-        } catch {
-            successBeepPlayer = nil
-        }
-    }
-
-    private static let successBeepData: Data = {
-        let sampleRate: UInt32 = 22_050
-        let sampleCount = Int(sampleRate / 10)
-        let dataSize = UInt32(sampleCount * 2)
-        var data = Data()
-
-        func appendASCII(_ value: String) {
-            data.append(contentsOf: value.utf8)
-        }
-        func appendUInt16(_ value: UInt16) {
-            var littleEndian = value.littleEndian
-            Swift.withUnsafeBytes(of: &littleEndian) { data.append(contentsOf: $0) }
-        }
-        func appendUInt32(_ value: UInt32) {
-            var littleEndian = value.littleEndian
-            Swift.withUnsafeBytes(of: &littleEndian) { data.append(contentsOf: $0) }
-        }
-        func appendInt16(_ value: Int16) {
-            appendUInt16(UInt16(bitPattern: value))
-        }
-
-        appendASCII("RIFF")
-        appendUInt32(36 + dataSize)
-        appendASCII("WAVE")
-        appendASCII("fmt ")
-        appendUInt32(16)
-        appendUInt16(1)
-        appendUInt16(1)
-        appendUInt32(sampleRate)
-        appendUInt32(sampleRate * 2)
-        appendUInt16(2)
-        appendUInt16(16)
-        appendASCII("data")
-        appendUInt32(dataSize)
-
-        for index in 0..<sampleCount {
-            let time = Double(index) / Double(sampleRate)
-            let remaining = Double(sampleCount - index) / Double(sampleRate)
-            let envelope = min(1, time / 0.005) * min(1, remaining / 0.025)
-            let value = sin(2 * Double.pi * 1_800 * time)
-                * envelope * Double(Int16.max) * 0.55
-            appendInt16(Int16(value.rounded()))
-        }
-        return data
-    }()
 
     private func fail(_ error: MlKitSuiteError) {
         guard !completed else { return }

package/src/ios/FaceCaptureTypes.swift

@@ -88,6 +88,7 @@ struct FaceCaptureOptions {
     let jpegQuality: Int
     let showCloseButton: Bool
     let debugMode: Bool
+    let beepEnabled: Bool
     let instructionText: String
     let localization: MlKitLocalization
     let timeoutMs: Int
@@ -97,7 +98,7 @@ struct FaceCaptureOptions {
         localization = try MlKitLocalization(dictionary: dictionary)
         let known = Set([
             "outputWidth", "outputHeight", "jpegQuality", "showCloseButton",
-            "debugMode", "instructionText", "timeoutMs", "checks",
+            "debugMode", "beepEnabled", "instructionText", "timeoutMs", "checks",
             "moduleLoadingMessage", "locale"
         ])
         for key in dictionary.keys where !known.contains(key) {
@@ -133,6 +134,7 @@ struct FaceCaptureOptions {
         jpegQuality = try integer("jpegQuality", fallback: 95, minimum: 50, maximum: 100)
         showCloseButton = try boolean("showCloseButton", fallback: true)
         debugMode = try boolean("debugMode", fallback: false)
+        beepEnabled = try boolean("beepEnabled", fallback: true)
         timeoutMs = try integer("timeoutMs", fallback: 0, minimum: 0, maximum: 600_000)
         if let raw = dictionary["instructionText"], !(raw is NSNull) {
             guard let string = raw as? String else {

package/src/ios/FaceCaptureViewController.swift

@@ -19,6 +19,7 @@ final class FaceCaptureViewController: UIViewController {
     private let processingQueue = DispatchQueue(label: "com.andreszs.mlkitsuite.processing", qos: .userInitiated)
     private let liveDetector: FaceDetector
     private let stillProcessor: FaceStillProcessor
+    private let successBeep = MlKitSuccessBeep()
     private var previewLayer: AVCaptureVideoPreviewLayer!
     private var overlayView: FaceOverlayView!
     private var videoOutput: AVCaptureVideoDataOutput?
@@ -351,7 +352,15 @@ final class FaceCaptureViewController: UIViewController {
         guard !completed else { return }
         completed = true
         timeoutItem?.cancel()
-        delegate?.faceCapture(self, didFinish: result)
+        if options.beepEnabled {
+            successBeep.play()
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.25) { [weak self] in
+                guard let self = self else { return }
+                self.delegate?.faceCapture(self, didFinish: result)
+            }
+        } else {
+            delegate?.faceCapture(self, didFinish: result)
+        }
     }
 
     private func fail(_ error: MlKitSuiteError) {

package/src/ios/MlKitSuccessBeep.swift

@@ -0,0 +1,82 @@
+import AVFoundation
+
+final class MlKitSuccessBeep {
+    private var player: AVAudioPlayer?
+
+    func play() {
+        do {
+            let session = AVAudioSession.sharedInstance()
+            try session.setCategory(.ambient, mode: .default, options: [.mixWithOthers])
+            try session.setActive(true)
+            let nextPlayer = try AVAudioPlayer(data: Self.data)
+            nextPlayer.volume = 1
+            nextPlayer.prepareToPlay()
+            player = nextPlayer
+            nextPlayer.play()
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.2) { [weak self] in
+                guard let self = self, self.player === nextPlayer else { return }
+                self.stop()
+            }
+        } catch {
+            player = nil
+        }
+    }
+
+    func stop() {
+        player?.stop()
+        player = nil
+        try? AVAudioSession.sharedInstance().setActive(
+            false, options: [.notifyOthersOnDeactivation]
+        )
+    }
+
+    deinit {
+        stop()
+    }
+
+    private static let data: Data = {
+        let sampleRate: UInt32 = 22_050
+        let sampleCount = Int(sampleRate / 10)
+        let dataSize = UInt32(sampleCount * 2)
+        var data = Data()
+
+        func appendASCII(_ value: String) {
+            data.append(contentsOf: value.utf8)
+        }
+        func appendUInt16(_ value: UInt16) {
+            var littleEndian = value.littleEndian
+            Swift.withUnsafeBytes(of: &littleEndian) { data.append(contentsOf: $0) }
+        }
+        func appendUInt32(_ value: UInt32) {
+            var littleEndian = value.littleEndian
+            Swift.withUnsafeBytes(of: &littleEndian) { data.append(contentsOf: $0) }
+        }
+        func appendInt16(_ value: Int16) {
+            appendUInt16(UInt16(bitPattern: value))
+        }
+
+        appendASCII("RIFF")
+        appendUInt32(36 + dataSize)
+        appendASCII("WAVE")
+        appendASCII("fmt ")
+        appendUInt32(16)
+        appendUInt16(1)
+        appendUInt16(1)
+        appendUInt32(sampleRate)
+        appendUInt32(sampleRate * 2)
+        appendUInt16(2)
+        appendUInt16(16)
+        appendASCII("data")
+        appendUInt32(dataSize)
+
+        for index in 0..<sampleCount {
+            let time = Double(index) / Double(sampleRate)
+            let remaining = Double(sampleCount - index) / Double(sampleRate)
+            let envelope = min(1, time / 0.005) * min(1, remaining / 0.025)
+            let value = sin(2 * Double.pi * 1_800 * time)
+                * envelope * Double(Int16.max) * 0.55
+            appendInt16(Int16(value.rounded()))
+        }
+        return data
+    }()
+}

package/tests/ios-face-capture.test.js

@@ -6,6 +6,7 @@ var path = require('path');
 
 var root = path.resolve(__dirname, '..');
 var controller = fs.readFileSync(path.join(root, 'src/ios/FaceCaptureViewController.swift'), 'utf8');
+var types = fs.readFileSync(path.join(root, 'src/ios/FaceCaptureTypes.swift'), 'utf8');
 var overlay = fs.readFileSync(path.join(root, 'src/ios/FaceOverlayView.swift'), 'utf8');
 
 assert(controller.includes('checks: options.checks'));
@@ -13,6 +14,9 @@ assert(controller.includes('bufferHeight >= bufferWidth ? .up : .leftMirrored'))
 assert(controller.includes('previewLayer.connection, mirrored: true'));
 assert(controller.includes('beginCapture(analysis, pixelBuffer: pixelBuffer)'));
 assert(controller.includes('pixelBuffer: pixelBuffer'));
+assert(types.includes('beepEnabled = try boolean("beepEnabled", fallback: true)'));
+assert(controller.includes('if options.beepEnabled'));
+assert(controller.includes('successBeep.play()'));
 assert(!controller.includes('AVCapturePhotoOutput'));
 assert(!controller.includes('AVCapturePhotoCaptureDelegate'));
 assert(!controller.includes('fileDataRepresentation'));

package/tests/ios-live-barcode.test.js

@@ -10,6 +10,7 @@ var plugin = fs.readFileSync(path.join(root, 'src/ios/MlKitSuitePlugin.swift'),
 var controller = fs.readFileSync(path.join(root, 'src/ios/BarcodeScanViewController.swift'), 'utf8');
 var faceController = fs.readFileSync(path.join(root, 'src/ios/FaceCaptureViewController.swift'), 'utf8');
 var types = fs.readFileSync(path.join(root, 'src/ios/BarcodeScanTypes.swift'), 'utf8');
+var successBeep = fs.readFileSync(path.join(root, 'src/ios/MlKitSuccessBeep.swift'), 'utf8');
 var spanish = fs.readFileSync(path.join(
     root, 'src/ios/MlKitSuiteResources.bundle/es.lproj/Localizable.strings'
 ), 'utf8');
@@ -18,6 +19,7 @@ var spanish = fs.readFileSync(path.join(
     'src/ios/BarcodeScanTypes.swift',
     'src/ios/BarcodeOverlayView.swift',
     'src/ios/BarcodeScanViewController.swift',
+    'src/ios/MlKitSuccessBeep.swift',
     'src/ios/MlKitLocalization.swift'
 ].forEach(function (source) {
     assert(pluginXml.includes('<source-file src="' + source + '" />'), source + ' must be packaged.');
@@ -47,7 +49,9 @@ assert(controller.includes('options.localization.text("barcode_center")'));
 assert(controller.includes('overlayView.contains('));
 assert(types.includes('guideColor must be a color in #RRGGBB format.'));
 assert(types.includes('beepEnabled = try boolean("beepEnabled", fallback: true)'));
-assert(controller.includes('AVAudioPlayer(data: Self.successBeepData)'));
+assert(controller.includes('private let successBeep = MlKitSuccessBeep()'));
+assert(controller.includes('if options.beepEnabled { successBeep.play() }'));
+assert(successBeep.includes('AVAudioPlayer(data: Self.data)'));
 assert(controller.includes('setTorchModeOn'));
 assert(controller.includes('UIImage(systemName: systemName'));
 assert(controller.includes('accessibilityLabel'));

package/www/MlKit.js

@@ -270,7 +270,7 @@ exports.face = {
      * Opens the native front-camera guide and automatically captures a JPEG.
      *
      * @param {{outputWidth?: number, outputHeight?: number, jpegQuality?: number,
-     *          showCloseButton?: boolean, debugMode?: boolean,
+     *          showCloseButton?: boolean, debugMode?: boolean, beepEnabled?: boolean,
      *          instructionText?: string|null, timeoutMs?: number,
      *          moduleLoadingMessage?: string|null, locale?: string,
      *          checks?: {singleFace?: boolean, faceSize?: boolean,