@independo/capacitor-voice-recorder 8.0.2-dev.1 → 8.1.0-dev.1

package/README.md

@@ -72,6 +72,9 @@ Below is an index of all available methods. Run `npm run docgen` after updating
 * [`pauseRecording()`](#pauserecording)
 * [`resumeRecording()`](#resumerecording)
 * [`getCurrentStatus()`](#getcurrentstatus)
+* [`addListener('voiceRecordingInterrupted', ...)`](#addlistenervoicerecordinginterrupted-)
+* [`addListener('voiceRecordingInterruptionEnded', ...)`](#addlistenervoicerecordinginterruptionended-)
+* [`removeAllListeners()`](#removealllisteners)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 * [Enums](#enums)
@@ -162,6 +165,7 @@ Will stop the recording that has been previously started.
 If the function `startRecording` has not been called beforehand, the promise will reject with `RECORDING_HAS_NOT_STARTED`.
 If the recording has been stopped immediately after it has been started, the promise will reject with `EMPTY_RECORDING`.
 In a case of unknown error, the promise will reject with `FAILED_TO_FETCH_RECORDING`.
+On iOS, if a recording interrupted by the system cannot be merged, the promise will reject with `FAILED_TO_MERGE_RECORDING`.
 In case of success, the promise resolves to <a href="#recordingdata">RecordingData</a> containing the recording in base-64, the duration of the recording in milliseconds, and the MIME type.
 
 **Returns:** <code>Promise&lt;<a href="#recordingdata">RecordingData</a>&gt;</code>
@@ -191,7 +195,7 @@ On certain mobile OS versions, this function is not supported and will reject wi
 resumeRecording() => Promise<GenericResponse>
 ```
 
-Resumes a paused audio recording.
+Resumes a paused or interrupted audio recording.
 If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.
 On success, the promise will resolve to { value: true } if the resume was successful or { value: false } if the recording is already running.
 On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.
@@ -212,12 +216,62 @@ Will resolve with one of the following values:
 `{ status: "NONE" }` if the plugin is idle and waiting to start a new recording.
 `{ status: "RECORDING" }` if the plugin is in the middle of recording.
 `{ status: "PAUSED" }` if the recording is paused.
+`{ status: "INTERRUPTED" }` if the recording was paused due to a system interruption.
 
 **Returns:** <code>Promise&lt;<a href="#currentrecordingstatus">CurrentRecordingStatus</a>&gt;</code>
 
 --------------------
 
 
+### addListener('voiceRecordingInterrupted', ...)
+
+```typescript
+addListener(eventName: 'voiceRecordingInterrupted', listenerFunc: (event: VoiceRecordingInterruptedEvent) => void) => Promise<PluginListenerHandle>
+```
+
+Listen for audio recording interruptions (e.g., phone calls, other apps using microphone).
+Available on iOS and Android only.
+
+| Param              | Type                                                                                                          | Description                                            |
+| ------------------ | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| **`eventName`**    | <code>'voiceRecordingInterrupted'</code>                                                                      | The name of the event to listen for.                   |
+| **`listenerFunc`** | <code>(event: <a href="#voicerecordinginterruptedevent">VoiceRecordingInterruptedEvent</a>) =&gt; void</code> | The callback function to invoke when the event occurs. |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener('voiceRecordingInterruptionEnded', ...)
+
+```typescript
+addListener(eventName: 'voiceRecordingInterruptionEnded', listenerFunc: (event: VoiceRecordingInterruptionEndedEvent) => void) => Promise<PluginListenerHandle>
+```
+
+Listen for audio recording interruption end events.
+Available on iOS and Android only.
+
+| Param              | Type                                                                                                                      | Description                                            |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| **`eventName`**    | <code>'voiceRecordingInterruptionEnded'</code>                                                                            | The name of the event to listen for.                   |
+| **`listenerFunc`** | <code>(event: <a href="#voicerecordinginterruptionendedevent">VoiceRecordingInterruptionEndedEvent</a>) =&gt; void</code> | The callback function to invoke when the event occurs. |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### removeAllListeners()
+
+```typescript
+removeAllListeners() => Promise<void>
+```
+
+Remove all listeners for this plugin.
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -253,9 +307,16 @@ Interface representing the data of a recording.
 
 Interface representing the current status of the voice recorder.
 
-| Prop         | Type                                           | Description                                                                                                  |
-| ------------ | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
-| **`status`** | <code>'NONE' \| 'RECORDING' \| 'PAUSED'</code> | The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'NONE'. |
+| Prop         | Type                                                            | Description                                                                                                                 |
+| ------------ | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| **`status`** | <code>'NONE' \| 'RECORDING' \| 'PAUSED' \| 'INTERRUPTED'</code> | The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'INTERRUPTED', 'NONE'. |
+
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
 
 
 ### Type Aliases
@@ -268,6 +329,27 @@ Represents a Base64 encoded string.
 <code>string</code>
 
 
+#### VoiceRecordingInterruptedEvent
+
+Event payload for voiceRecordingInterrupted event (empty - no data).
+
+<code><a href="#record">Record</a>&lt;string, never&gt;</code>
+
+
+#### Record
+
+Construct a type with a set of properties K of type T
+
+<code>{
 [P in K]: T;
 }</code>
+
+
+#### VoiceRecordingInterruptionEndedEvent
+
+Event payload for voiceRecordingInterruptionEnded event (empty - no data).
+
+<code><a href="#record">Record</a>&lt;string, never&gt;</code>
+
+
 ### Enums
 
 
@@ -287,6 +369,12 @@ Represents a Base64 encoded string.
 
 </docgen-api>
 
+## Audio interruption handling
+
+On iOS and Android, the plugin listens for system audio interruptions (phone calls, other apps taking audio focus). When an interruption begins, the recording is paused, the status becomes `INTERRUPTED`, and the `voiceRecordingInterrupted` event fires. When the interruption ends, the `voiceRecordingInterruptionEnded` event fires, and the status stays `INTERRUPTED` until you call `resumeRecording()` or `stopRecording()`. Web does not provide interruption handling.
+
+If interruptions occur on iOS, recordings are segmented and merged when you stop. The merged file is M4A with MIME type `audio/mp4`. Recordings without interruptions remain AAC with MIME type `audio/aac`.
+
 
 ## Format and Mime type
 

package/android/src/main/java/com/tchvu3/capacitorvoicerecorder/CurrentRecordingStatus.java

@@ -3,5 +3,6 @@ package com.tchvu3.capacitorvoicerecorder;
 public enum CurrentRecordingStatus {
     RECORDING,
     PAUSED,
+    INTERRUPTED,
     NONE
 }

package/android/src/main/java/com/tchvu3/capacitorvoicerecorder/CustomMediaRecorder.java

@@ -1,6 +1,9 @@
 package com.tchvu3.capacitorvoicerecorder;
 
 import android.content.Context;
+import android.media.AudioAttributes;
+import android.media.AudioFocusRequest;
+import android.media.AudioManager;
 import android.media.MediaRecorder;
 import android.os.Build;
 import android.os.Environment;
@@ -9,20 +12,33 @@ import java.io.IOException;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
-public class CustomMediaRecorder {
+public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListener {
 
     private final Context context;
     private final RecordOptions options;
     private MediaRecorder mediaRecorder;
     private File outputFile;
     private CurrentRecordingStatus currentRecordingStatus = CurrentRecordingStatus.NONE;
+    private AudioManager audioManager;
+    private AudioFocusRequest audioFocusRequest;
+    private Runnable onInterruptionBegan;
+    private Runnable onInterruptionEnded;
 
     public CustomMediaRecorder(Context context, RecordOptions options) throws IOException {
         this.context = context;
         this.options = options;
+        this.audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
         generateMediaRecorder();
     }
 
+    public void setOnInterruptionBegan(Runnable callback) {
+        this.onInterruptionBegan = callback;
+    }
+
+    public void setOnInterruptionEnded(Runnable callback) {
+        this.onInterruptionEnded = callback;
+    }
+
     private void generateMediaRecorder() throws IOException {
         mediaRecorder = new MediaRecorder();
         mediaRecorder.setAudioSource(MediaRecorder.AudioSource.MIC);
@@ -75,14 +91,31 @@ public class CustomMediaRecorder {
     }
 
     public void startRecording() {
+        requestAudioFocus();
         mediaRecorder.start();
         currentRecordingStatus = CurrentRecordingStatus.RECORDING;
     }
 
     public void stopRecording() {
-        mediaRecorder.stop();
-        mediaRecorder.release();
-        currentRecordingStatus = CurrentRecordingStatus.NONE;
+        if (mediaRecorder == null) {
+            abandonAudioFocus();
+            currentRecordingStatus = CurrentRecordingStatus.NONE;
+            return;
+        }
+
+        try {
+            if (currentRecordingStatus == CurrentRecordingStatus.RECORDING
+                || currentRecordingStatus == CurrentRecordingStatus.PAUSED
+                || currentRecordingStatus == CurrentRecordingStatus.INTERRUPTED) {
+                mediaRecorder.stop();
+            }
+        } catch (IllegalStateException ignore) {
+        } finally {
+            mediaRecorder.release();
+            mediaRecorder = null;
+            abandonAudioFocus();
+            currentRecordingStatus = CurrentRecordingStatus.NONE;
+        }
     }
 
     public File getOutputFile() {
@@ -112,7 +145,8 @@ public class CustomMediaRecorder {
             throw new NotSupportedOsVersion();
         }
 
-        if (currentRecordingStatus == CurrentRecordingStatus.PAUSED) {
+        if (currentRecordingStatus == CurrentRecordingStatus.PAUSED || currentRecordingStatus == CurrentRecordingStatus.INTERRUPTED) {
+            requestAudioFocus();
             mediaRecorder.resume();
             currentRecordingStatus = CurrentRecordingStatus.RECORDING;
             return true;
@@ -146,4 +180,71 @@ public class CustomMediaRecorder {
             if (tempMediaRecorder != null) tempMediaRecorder.deleteOutputFile();
         }
     }
+
+    private void requestAudioFocus() {
+        if (audioManager == null) {
+            return;
+        }
+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            AudioAttributes audioAttributes = new AudioAttributes.Builder()
+                .setUsage(AudioAttributes.USAGE_MEDIA)
+                .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
+                .build();
+
+            audioFocusRequest = new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN)
+                .setAudioAttributes(audioAttributes)
+                .setOnAudioFocusChangeListener(this)
+                .build();
+
+            audioManager.requestAudioFocus(audioFocusRequest);
+        } else {
+            audioManager.requestAudioFocus(this, AudioManager.STREAM_MUSIC, AudioManager.AUDIOFOCUS_GAIN);
+        }
+    }
+
+    private void abandonAudioFocus() {
+        if (audioManager == null) {
+            return;
+        }
+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && audioFocusRequest != null) {
+            audioManager.abandonAudioFocusRequest(audioFocusRequest);
+            audioFocusRequest = null;
+        } else {
+            audioManager.abandonAudioFocus(this);
+        }
+    }
+
+    @Override
+    public void onAudioFocusChange(int focusChange) {
+        switch (focusChange) {
+            case AudioManager.AUDIOFOCUS_LOSS:
+            case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
+            case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
+                // For voice recording, ducking still degrades captured audio, so treat all loss types as interruptions.
+                if (currentRecordingStatus == CurrentRecordingStatus.RECORDING) {
+                    try {
+                        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+                            mediaRecorder.pause();
+                            currentRecordingStatus = CurrentRecordingStatus.INTERRUPTED;
+                            if (onInterruptionBegan != null) {
+                                onInterruptionBegan.run();
+                            }
+                        }
+                    } catch (Exception ignore) {
+                    }
+                }
+                break;
+            case AudioManager.AUDIOFOCUS_GAIN:
+                if (currentRecordingStatus == CurrentRecordingStatus.INTERRUPTED) {
+                    if (onInterruptionEnded != null) {
+                        onInterruptionEnded.run();
+                    }
+                }
+                break;
+            default:
+                break;
+        }
+    }
 }

package/android/src/main/java/com/tchvu3/capacitorvoicerecorder/VoiceRecorder.java

@@ -82,6 +82,8 @@ public class VoiceRecorder extends Plugin {
             String subDirectory = call.getString("subDirectory");
             RecordOptions options = new RecordOptions(directory, subDirectory);
             mediaRecorder = new CustomMediaRecorder(getContext(), options);
+            mediaRecorder.setOnInterruptionBegan(() -> notifyListeners("voiceRecordingInterrupted", null));
+            mediaRecorder.setOnInterruptionEnded(() -> notifyListeners("voiceRecordingInterruptionEnded", null));
             mediaRecorder.startRecording();
             call.resolve(ResponseGenerator.successResponse());
         } catch (Exception exp) {

package/dist/docs.json

@@ -115,7 +115,7 @@
             "text": "Error with one of the specified error codes if the recording cannot be stopped."
           }
         ],
-        "docs": "Stops audio recording.\nWill stop the recording that has been previously started.\nIf the function `startRecording` has not been called beforehand, the promise will reject with `RECORDING_HAS_NOT_STARTED`.\nIf the recording has been stopped immediately after it has been started, the promise will reject with `EMPTY_RECORDING`.\nIn a case of unknown error, the promise will reject with `FAILED_TO_FETCH_RECORDING`.\nIn case of success, the promise resolves to RecordingData containing the recording in base-64, the duration of the recording in milliseconds, and the MIME type.",
+        "docs": "Stops audio recording.\nWill stop the recording that has been previously started.\nIf the function `startRecording` has not been called beforehand, the promise will reject with `RECORDING_HAS_NOT_STARTED`.\nIf the recording has been stopped immediately after it has been started, the promise will reject with `EMPTY_RECORDING`.\nIn a case of unknown error, the promise will reject with `FAILED_TO_FETCH_RECORDING`.\nOn iOS, if a recording interrupted by the system cannot be merged, the promise will reject with `FAILED_TO_MERGE_RECORDING`.\nIn case of success, the promise resolves to RecordingData containing the recording in base-64, the duration of the recording in milliseconds, and the MIME type.",
         "complexTypes": [
           "RecordingData"
         ],
@@ -157,7 +157,7 @@
             "text": "Error with one of the specified error codes if the recording cannot be resumed."
           }
         ],
-        "docs": "Resumes a paused audio recording.\nIf the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\nOn success, the promise will resolve to { value: true } if the resume was successful or { value: false } if the recording is already running.\nOn certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.",
+        "docs": "Resumes a paused or interrupted audio recording.\nIf the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\nOn success, the promise will resolve to { value: true } if the resume was successful or { value: false } if the recording is already running.\nOn certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.",
         "complexTypes": [
           "GenericResponse"
         ],
@@ -178,11 +178,95 @@
             "text": "Error if the status cannot be fetched."
           }
         ],
-        "docs": "Gets the current status of the voice recorder.\nWill resolve with one of the following values:\n`{ status: \"NONE\" }` if the plugin is idle and waiting to start a new recording.\n`{ status: \"RECORDING\" }` if the plugin is in the middle of recording.\n`{ status: \"PAUSED\" }` if the recording is paused.",
+        "docs": "Gets the current status of the voice recorder.\nWill resolve with one of the following values:\n`{ status: \"NONE\" }` if the plugin is idle and waiting to start a new recording.\n`{ status: \"RECORDING\" }` if the plugin is in the middle of recording.\n`{ status: \"PAUSED\" }` if the recording is paused.\n`{ status: \"INTERRUPTED\" }` if the recording was paused due to a system interruption.",
         "complexTypes": [
           "CurrentRecordingStatus"
         ],
         "slug": "getcurrentstatus"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'voiceRecordingInterrupted', listenerFunc: (event: VoiceRecordingInterruptedEvent) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "The name of the event to listen for.",
+            "type": "'voiceRecordingInterrupted'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "The callback function to invoke when the event occurs.",
+            "type": "(event: VoiceRecordingInterruptedEvent) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "eventName The name of the event to listen for."
+          },
+          {
+            "name": "param",
+            "text": "listenerFunc The callback function to invoke when the event occurs."
+          },
+          {
+            "name": "returns",
+            "text": "A promise that resolves to a PluginListenerHandle."
+          }
+        ],
+        "docs": "Listen for audio recording interruptions (e.g., phone calls, other apps using microphone).\nAvailable on iOS and Android only.",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "VoiceRecordingInterruptedEvent"
+        ],
+        "slug": "addlistenervoicerecordinginterrupted-"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'voiceRecordingInterruptionEnded', listenerFunc: (event: VoiceRecordingInterruptionEndedEvent) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "The name of the event to listen for.",
+            "type": "'voiceRecordingInterruptionEnded'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "The callback function to invoke when the event occurs.",
+            "type": "(event: VoiceRecordingInterruptionEndedEvent) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "eventName The name of the event to listen for."
+          },
+          {
+            "name": "param",
+            "text": "listenerFunc The callback function to invoke when the event occurs."
+          },
+          {
+            "name": "returns",
+            "text": "A promise that resolves to a PluginListenerHandle."
+          }
+        ],
+        "docs": "Listen for audio recording interruption end events.\nAvailable on iOS and Android only.",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "VoiceRecordingInterruptionEndedEvent"
+        ],
+        "slug": "addlistenervoicerecordinginterruptionended-"
+      },
+      {
+        "name": "removeAllListeners",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "Remove all listeners for this plugin.",
+        "complexTypes": [],
+        "slug": "removealllisteners"
       }
     ],
     "properties": []
@@ -262,9 +346,25 @@
         {
           "name": "status",
           "tags": [],
-          "docs": "The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'NONE'.",
+          "docs": "The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'INTERRUPTED', 'NONE'.",
           "complexTypes": [],
-          "type": "'NONE' | 'RECORDING' | 'PAUSED'"
+          "type": "'NONE' | 'RECORDING' | 'PAUSED' | 'INTERRUPTED'"
+        }
+      ]
+    },
+    {
+      "name": "PluginListenerHandle",
+      "slug": "pluginlistenerhandle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "remove",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "() => Promise<void>"
         }
       ]
     }
@@ -387,6 +487,46 @@
           "complexTypes": []
         }
       ]
+    },
+    {
+      "name": "VoiceRecordingInterruptedEvent",
+      "slug": "voicerecordinginterruptedevent",
+      "docs": "Event payload for voiceRecordingInterrupted event (empty - no data).",
+      "types": [
+        {
+          "text": "Record<string, never>",
+          "complexTypes": [
+            "Record"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Record",
+      "slug": "record",
+      "docs": "Construct a type with a set of properties K of type T",
+      "types": [
+        {
+          "text": "{\r\n    [P in K]: T;\r\n}",
+          "complexTypes": [
+            "K",
+            "T"
+          ]
+        }
+      ]
+    },
+    {
+      "name": "VoiceRecordingInterruptionEndedEvent",
+      "slug": "voicerecordinginterruptionendedevent",
+      "docs": "Event payload for voiceRecordingInterruptionEnded event (empty - no data).",
+      "types": [
+        {
+          "text": "Record<string, never>",
+          "complexTypes": [
+            "Record"
+          ]
+        }
+      ]
     }
   ],
   "pluginConfigs": []

package/dist/esm/definitions.d.ts

@@ -1,3 +1,4 @@
+import type { PluginListenerHandle } from "@capacitor/core";
 import type { Directory } from "@capacitor/filesystem";
 /**
  * Represents a Base64 encoded string.
@@ -59,10 +60,18 @@ export interface GenericResponse {
  */
 export interface CurrentRecordingStatus {
     /**
-     * The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'NONE'.
+     * The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'INTERRUPTED', 'NONE'.
      */
-    status: 'RECORDING' | 'PAUSED' | 'NONE';
+    status: 'RECORDING' | 'PAUSED' | 'INTERRUPTED' | 'NONE';
 }
+/**
+ * Event payload for voiceRecordingInterrupted event (empty - no data).
+ */
+export type VoiceRecordingInterruptedEvent = Record<string, never>;
+/**
+ * Event payload for voiceRecordingInterruptionEnded event (empty - no data).
+ */
+export type VoiceRecordingInterruptionEndedEvent = Record<string, never>;
 /**
  * Interface for the VoiceRecorderPlugin which provides methods to record audio.
  */
@@ -110,6 +119,7 @@ export interface VoiceRecorderPlugin {
      * If the function `startRecording` has not been called beforehand, the promise will reject with `RECORDING_HAS_NOT_STARTED`.
      * If the recording has been stopped immediately after it has been started, the promise will reject with `EMPTY_RECORDING`.
      * In a case of unknown error, the promise will reject with `FAILED_TO_FETCH_RECORDING`.
+     * On iOS, if a recording interrupted by the system cannot be merged, the promise will reject with `FAILED_TO_MERGE_RECORDING`.
      * In case of success, the promise resolves to RecordingData containing the recording in base-64, the duration of the recording in milliseconds, and the MIME type.
      * @returns A promise that resolves to RecordingData.
      * @throws Error with one of the specified error codes if the recording cannot be stopped.
@@ -125,7 +135,7 @@ export interface VoiceRecorderPlugin {
      */
     pauseRecording(): Promise<GenericResponse>;
     /**
-     * Resumes a paused audio recording.
+     * Resumes a paused or interrupted audio recording.
      * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.
      * On success, the promise will resolve to { value: true } if the resume was successful or { value: false } if the recording is already running.
      * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.
@@ -139,8 +149,31 @@ export interface VoiceRecorderPlugin {
      * `{ status: "NONE" }` if the plugin is idle and waiting to start a new recording.
      * `{ status: "RECORDING" }` if the plugin is in the middle of recording.
      * `{ status: "PAUSED" }` if the recording is paused.
+     * `{ status: "INTERRUPTED" }` if the recording was paused due to a system interruption.
      * @returns A promise that resolves to a CurrentRecordingStatus.
      * @throws Error if the status cannot be fetched.
      */
     getCurrentStatus(): Promise<CurrentRecordingStatus>;
+    /**
+     * Listen for audio recording interruptions (e.g., phone calls, other apps using microphone).
+     * Available on iOS and Android only.
+     *
+     * @param eventName The name of the event to listen for.
+     * @param listenerFunc The callback function to invoke when the event occurs.
+     * @returns A promise that resolves to a PluginListenerHandle.
+     */
+    addListener(eventName: 'voiceRecordingInterrupted', listenerFunc: (event: VoiceRecordingInterruptedEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listen for audio recording interruption end events.
+     * Available on iOS and Android only.
+     *
+     * @param eventName The name of the event to listen for.
+     * @param listenerFunc The callback function to invoke when the event occurs.
+     * @returns A promise that resolves to a PluginListenerHandle.
+     */
+    addListener(eventName: 'voiceRecordingInterruptionEnded', listenerFunc: (event: VoiceRecordingInterruptionEndedEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners for this plugin.
+     */
+    removeAllListeners(): Promise<void>;
 }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type {Directory} from \"@capacitor/filesystem\";\n\n/**\n * Represents a Base64 encoded string.\n */\nexport type Base64String = string;\n\n/**\n * Can be used to specify options for the recording.\n */\nexport interface RecordingOptions {\n    /**\n     * The capacitor filesystem directory where the recording should be saved.\n     *\n     * If not specified, the recording will be stored in a base64 string and returned in the `RecordingData` object.\n     * @see RecordingData\n     */\n    directory?: Directory;\n\n    /**\n     * An optional subdirectory in the specified directory where the recording should be saved.\n     */\n    subDirectory?: string;\n}\n\n/**\n * Interface representing the data of a recording.\n */\nexport interface RecordingData {\n    /**\n     * The value containing the recording details.\n     */\n    value: {\n        /**\n         * The recorded data as a Base64 encoded string.\n         */\n        recordDataBase64: Base64String;\n        /**\n         * The duration of the recording in milliseconds.\n         */\n        msDuration: number;\n        /**\n         * The MIME type of the recorded file.\n         */\n        mimeType: string;\n\n        /**\n         * The URI of the recording file.\n         */\n        uri?: string;\n    };\n}\n\n/**\n * Interface representing a generic response with a boolean value.\n */\nexport interface GenericResponse {\n    /**\n     * The result of the operation as a boolean value.\n     */\n    value: boolean;\n}\n\n/**\n * Interface representing the current status of the voice recorder.\n */\nexport interface CurrentRecordingStatus {\n    /**\n     * The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'NONE'.\n     */\n    status: 'RECORDING' | 'PAUSED' | 'NONE';\n}\n\n/**\n * Interface for the VoiceRecorderPlugin which provides methods to record audio.\n */\nexport interface VoiceRecorderPlugin {\n    /**\n     * Checks if the current device can record audio.\n     * On mobile, this function will always resolve to `{ value: true }`.\n     * In a browser, it will resolve to `{ value: true }` or `{ value: false }` based on the browser's ability to record.\n     * This method does not take into account the permission status, only if the browser itself is capable of recording at all.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with code \"COULD_NOT_QUERY_PERMISSION_STATUS\" if the device cannot query the permission status.\n     */\n    canDeviceVoiceRecord(): Promise<GenericResponse>;\n\n    /**\n     * Requests audio recording permission from the user.\n     * If the permission has already been provided, the promise will resolve with `{ value: true }`.\n     * Otherwise, the promise will resolve to `{ value: true }` or `{ value: false }` based on the user's response.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error if the permission request fails.\n     */\n    requestAudioRecordingPermission(): Promise<GenericResponse>;\n\n    /**\n     * Checks if audio recording permission has been granted.\n     * Will resolve to `{ value: true }` or `{ value: false }` based on the status of the permission.\n     * The web implementation of this plugin uses the Permissions API, which is not widespread.\n     * If the status of the permission cannot be checked, the promise will reject with `COULD_NOT_QUERY_PERMISSION_STATUS`.\n     * In that case, use `requestAudioRecordingPermission` or `startRecording` and capture any exception that is thrown.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with code \"COULD_NOT_QUERY_PERMISSION_STATUS\" if the device cannot query the permission status.\n     */\n    hasAudioRecordingPermission(): Promise<GenericResponse>;\n\n    /**\n     * Starts audio recording.\n     * On success, the promise will resolve to { value: true }.\n     * On error, the promise will reject with one of the following error codes:\n     * \"MISSING_PERMISSION\", \"ALREADY_RECORDING\", \"MICROPHONE_BEING_USED\", \"DEVICE_CANNOT_VOICE_RECORD\", or \"FAILED_TO_RECORD\".\n     * @param options The options for the recording.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be started.\n     */\n    startRecording(options?: RecordingOptions): Promise<GenericResponse>;\n\n    /**\n     * Stops audio recording.\n     * Will stop the recording that has been previously started.\n     * If the function `startRecording` has not been called beforehand, the promise will reject with `RECORDING_HAS_NOT_STARTED`.\n     * If the recording has been stopped immediately after it has been started, the promise will reject with `EMPTY_RECORDING`.\n     * In a case of unknown error, the promise will reject with `FAILED_TO_FETCH_RECORDING`.\n     * In case of success, the promise resolves to RecordingData containing the recording in base-64, the duration of the recording in milliseconds, and the MIME type.\n     * @returns A promise that resolves to RecordingData.\n     * @throws Error with one of the specified error codes if the recording cannot be stopped.\n     */\n    stopRecording(): Promise<RecordingData>;\n\n    /**\n     * Pauses the ongoing audio recording.\n     * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\n     * On success, the promise will resolve to { value: true } if the pause was successful or { value: false } if the recording is already paused.\n     * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be paused.\n     */\n    pauseRecording(): Promise<GenericResponse>;\n\n    /**\n     * Resumes a paused audio recording.\n     * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\n     * On success, the promise will resolve to { value: true } if the resume was successful or { value: false } if the recording is already running.\n     * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be resumed.\n     */\n    resumeRecording(): Promise<GenericResponse>;\n\n    /**\n     * Gets the current status of the voice recorder.\n     * Will resolve with one of the following values:\n     * `{ status: \"NONE\" }` if the plugin is idle and waiting to start a new recording.\n     * `{ status: \"RECORDING\" }` if the plugin is in the middle of recording.\n     * `{ status: \"PAUSED\" }` if the recording is paused.\n     * @returns A promise that resolves to a CurrentRecordingStatus.\n     * @throws Error if the status cannot be fetched.\n     */\n    getCurrentStatus(): Promise<CurrentRecordingStatus>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type {PluginListenerHandle} from \"@capacitor/core\";\nimport type {Directory} from \"@capacitor/filesystem\";\n\n/**\n * Represents a Base64 encoded string.\n */\nexport type Base64String = string;\n\n/**\n * Can be used to specify options for the recording.\n */\nexport interface RecordingOptions {\n    /**\n     * The capacitor filesystem directory where the recording should be saved.\n     *\n     * If not specified, the recording will be stored in a base64 string and returned in the `RecordingData` object.\n     * @see RecordingData\n     */\n    directory?: Directory;\n\n    /**\n     * An optional subdirectory in the specified directory where the recording should be saved.\n     */\n    subDirectory?: string;\n}\n\n/**\n * Interface representing the data of a recording.\n */\nexport interface RecordingData {\n    /**\n     * The value containing the recording details.\n     */\n    value: {\n        /**\n         * The recorded data as a Base64 encoded string.\n         */\n        recordDataBase64: Base64String;\n        /**\n         * The duration of the recording in milliseconds.\n         */\n        msDuration: number;\n        /**\n         * The MIME type of the recorded file.\n         */\n        mimeType: string;\n\n        /**\n         * The URI of the recording file.\n         */\n        uri?: string;\n    };\n}\n\n/**\n * Interface representing a generic response with a boolean value.\n */\nexport interface GenericResponse {\n    /**\n     * The result of the operation as a boolean value.\n     */\n    value: boolean;\n}\n\n/**\n * Interface representing the current status of the voice recorder.\n */\nexport interface CurrentRecordingStatus {\n    /**\n     * The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'INTERRUPTED', 'NONE'.\n     */\n    status: 'RECORDING' | 'PAUSED' | 'INTERRUPTED' | 'NONE';\n}\n\n/**\n * Event payload for voiceRecordingInterrupted event (empty - no data).\n */\nexport type VoiceRecordingInterruptedEvent = Record<string, never>;\n\n/**\n * Event payload for voiceRecordingInterruptionEnded event (empty - no data).\n */\nexport type VoiceRecordingInterruptionEndedEvent = Record<string, never>;\n\n/**\n * Interface for the VoiceRecorderPlugin which provides methods to record audio.\n */\nexport interface VoiceRecorderPlugin {\n    /**\n     * Checks if the current device can record audio.\n     * On mobile, this function will always resolve to `{ value: true }`.\n     * In a browser, it will resolve to `{ value: true }` or `{ value: false }` based on the browser's ability to record.\n     * This method does not take into account the permission status, only if the browser itself is capable of recording at all.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with code \"COULD_NOT_QUERY_PERMISSION_STATUS\" if the device cannot query the permission status.\n     */\n    canDeviceVoiceRecord(): Promise<GenericResponse>;\n\n    /**\n     * Requests audio recording permission from the user.\n     * If the permission has already been provided, the promise will resolve with `{ value: true }`.\n     * Otherwise, the promise will resolve to `{ value: true }` or `{ value: false }` based on the user's response.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error if the permission request fails.\n     */\n    requestAudioRecordingPermission(): Promise<GenericResponse>;\n\n    /**\n     * Checks if audio recording permission has been granted.\n     * Will resolve to `{ value: true }` or `{ value: false }` based on the status of the permission.\n     * The web implementation of this plugin uses the Permissions API, which is not widespread.\n     * If the status of the permission cannot be checked, the promise will reject with `COULD_NOT_QUERY_PERMISSION_STATUS`.\n     * In that case, use `requestAudioRecordingPermission` or `startRecording` and capture any exception that is thrown.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with code \"COULD_NOT_QUERY_PERMISSION_STATUS\" if the device cannot query the permission status.\n     */\n    hasAudioRecordingPermission(): Promise<GenericResponse>;\n\n    /**\n     * Starts audio recording.\n     * On success, the promise will resolve to { value: true }.\n     * On error, the promise will reject with one of the following error codes:\n     * \"MISSING_PERMISSION\", \"ALREADY_RECORDING\", \"MICROPHONE_BEING_USED\", \"DEVICE_CANNOT_VOICE_RECORD\", or \"FAILED_TO_RECORD\".\n     * @param options The options for the recording.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be started.\n     */\n    startRecording(options?: RecordingOptions): Promise<GenericResponse>;\n\n    /**\n     * Stops audio recording.\n     * Will stop the recording that has been previously started.\n     * If the function `startRecording` has not been called beforehand, the promise will reject with `RECORDING_HAS_NOT_STARTED`.\n     * If the recording has been stopped immediately after it has been started, the promise will reject with `EMPTY_RECORDING`.\n     * In a case of unknown error, the promise will reject with `FAILED_TO_FETCH_RECORDING`.\n     * On iOS, if a recording interrupted by the system cannot be merged, the promise will reject with `FAILED_TO_MERGE_RECORDING`.\n     * In case of success, the promise resolves to RecordingData containing the recording in base-64, the duration of the recording in milliseconds, and the MIME type.\n     * @returns A promise that resolves to RecordingData.\n     * @throws Error with one of the specified error codes if the recording cannot be stopped.\n     */\n    stopRecording(): Promise<RecordingData>;\n\n    /**\n     * Pauses the ongoing audio recording.\n     * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\n     * On success, the promise will resolve to { value: true } if the pause was successful or { value: false } if the recording is already paused.\n     * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be paused.\n     */\n    pauseRecording(): Promise<GenericResponse>;\n\n    /**\n     * Resumes a paused or interrupted audio recording.\n     * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\n     * On success, the promise will resolve to { value: true } if the resume was successful or { value: false } if the recording is already running.\n     * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be resumed.\n     */\n    resumeRecording(): Promise<GenericResponse>;\n\n    /**\n     * Gets the current status of the voice recorder.\n     * Will resolve with one of the following values:\n     * `{ status: \"NONE\" }` if the plugin is idle and waiting to start a new recording.\n     * `{ status: \"RECORDING\" }` if the plugin is in the middle of recording.\n     * `{ status: \"PAUSED\" }` if the recording is paused.\n     * `{ status: \"INTERRUPTED\" }` if the recording was paused due to a system interruption.\n     * @returns A promise that resolves to a CurrentRecordingStatus.\n     * @throws Error if the status cannot be fetched.\n     */\n    getCurrentStatus(): Promise<CurrentRecordingStatus>;\n\n    /**\n     * Listen for audio recording interruptions (e.g., phone calls, other apps using microphone).\n     * Available on iOS and Android only.\n     *\n     * @param eventName The name of the event to listen for.\n     * @param listenerFunc The callback function to invoke when the event occurs.\n     * @returns A promise that resolves to a PluginListenerHandle.\n     */\n    addListener(\n        eventName: 'voiceRecordingInterrupted',\n        listenerFunc: (event: VoiceRecordingInterruptedEvent) => void,\n    ): Promise<PluginListenerHandle>;\n\n    /**\n     * Listen for audio recording interruption end events.\n     * Available on iOS and Android only.\n     *\n     * @param eventName The name of the event to listen for.\n     * @param listenerFunc The callback function to invoke when the event occurs.\n     * @returns A promise that resolves to a PluginListenerHandle.\n     */\n    addListener(\n        eventName: 'voiceRecordingInterruptionEnded',\n        listenerFunc: (event: VoiceRecordingInterruptionEndedEvent) => void,\n    ): Promise<PluginListenerHandle>;\n\n    /**\n     * Remove all listeners for this plugin.\n     */\n    removeAllListeners(): Promise<void>;\n}\n"]}

package/ios/Sources/VoiceRecorder/CurrentRecordingStatus.swift

@@ -4,6 +4,7 @@ enum CurrentRecordingStatus: String {
 
     case RECORDING
     case PAUSED
+    case INTERRUPTED
     case NONE
 
 }

package/ios/Sources/VoiceRecorder/CustomMediaRecorder.swift

@@ -6,9 +6,13 @@ class CustomMediaRecorder {
     public var options: RecordOptions?
     private var recordingSession: AVAudioSession!
     private var audioRecorder: AVAudioRecorder!
-    private var audioFilePath: URL!
+    private var baseAudioFilePath: URL!
+    private var audioFileSegments: [URL] = []
     private var originalRecordingSessionCategory: AVAudioSession.Category!
     private var status = CurrentRecordingStatus.NONE
+    private var interruptionObserver: NSObjectProtocol?
+    var onInterruptionBegan: (() -> Void)?
+    var onInterruptionEnded: (() -> Void)?
 
     private let settings = [
         AVFormatIDKey: Int(kAudioFormatMPEG4AAC),
@@ -46,8 +50,10 @@ class CustomMediaRecorder {
             originalRecordingSessionCategory = recordingSession.category
             try recordingSession.setCategory(AVAudioSession.Category.playAndRecord)
             try recordingSession.setActive(true)
-            audioFilePath = getDirectoryToSaveAudioFile().appendingPathComponent("recording-\(Int(Date().timeIntervalSince1970 * 1000)).aac")
-            audioRecorder = try AVAudioRecorder(url: audioFilePath, settings: settings)
+            baseAudioFilePath = getDirectoryToSaveAudioFile().appendingPathComponent("recording-\(Int(Date().timeIntervalSince1970 * 1000)).aac")
+            audioFileSegments = [baseAudioFilePath]
+            audioRecorder = try AVAudioRecorder(url: baseAudioFilePath, settings: settings)
+            setupInterruptionHandling()
             audioRecorder.record()
             status = CurrentRecordingStatus.RECORDING
             return true
@@ -56,20 +62,46 @@ class CustomMediaRecorder {
         }
     }
 
-    public func stopRecording() {
-        do {
-            audioRecorder.stop()
-            try recordingSession.setActive(false)
-            try recordingSession.setCategory(originalRecordingSessionCategory)
-            originalRecordingSessionCategory = nil
-            audioRecorder = nil
-            recordingSession = nil
-            status = CurrentRecordingStatus.NONE
-        } catch {}
+    public func stopRecording(completion: @escaping (Bool) -> Void) {
+        removeInterruptionHandling()
+        audioRecorder.stop()
+
+        let finalizeStop: (Bool) -> Void = { [weak self] success in
+            guard let self = self else {
+                completion(false)
+                return
+            }
+
+            do {
+                try self.recordingSession.setActive(false)
+                try self.recordingSession.setCategory(self.originalRecordingSessionCategory)
+            } catch {
+            }
+
+            self.originalRecordingSessionCategory = nil
+            self.audioRecorder = nil
+            self.recordingSession = nil
+            self.status = CurrentRecordingStatus.NONE
+            completion(success)
+        }
+
+        if audioFileSegments.count > 1 {
+            DispatchQueue.global(qos: .userInitiated).async { [weak self] in
+                guard let self = self else {
+                    completion(false)
+                    return
+                }
+                self.mergeAudioSegments { success in
+                    finalizeStop(success)
+                }
+            }
+        } else {
+            finalizeStop(true)
+        }
     }
 
     public func getOutputFile() -> URL {
-        return audioFilePath
+        return baseAudioFilePath
     }
 
     public func getDirectory(directory: String?) -> FileManager.SearchPathDirectory? {
@@ -97,17 +129,207 @@ class CustomMediaRecorder {
     }
 
     public func resumeRecording() -> Bool {
-        if(status == CurrentRecordingStatus.PAUSED) {
-            audioRecorder.record()
-            status = CurrentRecordingStatus.RECORDING
-            return true
-        } else {
-            return false
+        if(status == CurrentRecordingStatus.PAUSED || status == CurrentRecordingStatus.INTERRUPTED) {
+            let wasInterrupted = status == CurrentRecordingStatus.INTERRUPTED
+            do {
+                try recordingSession.setActive(true)
+                if status == CurrentRecordingStatus.INTERRUPTED {
+                    let directory = getDirectoryToSaveAudioFile()
+                    let timestamp = Int(Date().timeIntervalSince1970 * 1000)
+                    let segmentNumber = audioFileSegments.count
+                    let segmentPath = directory.appendingPathComponent("recording-\(timestamp)-segment-\(segmentNumber).aac")
+                    audioRecorder = try AVAudioRecorder(url: segmentPath, settings: settings)
+                    audioFileSegments.append(segmentPath)
+                }
+                audioRecorder.record()
+                status = CurrentRecordingStatus.RECORDING
+                return true
+            } catch {
+                if wasInterrupted {
+                    try? recordingSession.setActive(false)
+                }
+                return false
+            }
         }
+
+        return false
     }
 
     public func getCurrentStatus() -> CurrentRecordingStatus {
         return status
     }
 
+    private func setupInterruptionHandling() {
+        interruptionObserver = NotificationCenter.default.addObserver(
+            forName: AVAudioSession.interruptionNotification,
+            object: AVAudioSession.sharedInstance(),
+            queue: .main
+        ) { [weak self] notification in
+            self?.handleInterruption(notification: notification)
+        }
+    }
+
+    private func removeInterruptionHandling() {
+        if let observer = interruptionObserver {
+            NotificationCenter.default.removeObserver(observer)
+            interruptionObserver = nil
+        }
+    }
+
+    private func handleInterruption(notification: Notification) {
+        guard let userInfo = notification.userInfo,
+              let interruptionTypeValue = userInfo[AVAudioSessionInterruptionTypeKey] as? UInt,
+              let interruptionType = AVAudioSession.InterruptionType(rawValue: interruptionTypeValue) else {
+            return
+        }
+
+        switch interruptionType {
+        case .began:
+            if status == CurrentRecordingStatus.RECORDING {
+                audioRecorder.stop()
+                status = CurrentRecordingStatus.INTERRUPTED
+                onInterruptionBegan?()
+            }
+
+        case .ended:
+            if status == CurrentRecordingStatus.INTERRUPTED {
+                onInterruptionEnded?()
+            }
+
+        @unknown default:
+            break
+        }
+    }
+
+    private func mergeAudioSegments(completion: @escaping (Bool) -> Void) {
+        if audioFileSegments.count <= 1 {
+            completion(true)
+            return
+        }
+
+        let basePathWithoutExtension = baseAudioFilePath.deletingPathExtension()
+        let mergedFilePath = basePathWithoutExtension.appendingPathExtension("m4a")
+        let segmentURLs = audioFileSegments
+        let keys = ["tracks", "duration"]
+        let dispatchGroup = DispatchGroup()
+        let syncQueue = DispatchQueue(label: "CustomMediaRecorder.assetSyncQueue")
+        var loadedAssets = Array<AVURLAsset?>(repeating: nil, count: segmentURLs.count)
+        var loadFailed = false
+
+        for (index, segmentURL) in segmentURLs.enumerated() {
+            let asset = AVURLAsset(url: segmentURL)
+            dispatchGroup.enter()
+            asset.loadValuesAsynchronously(forKeys: keys) {
+                var assetIsValid = true
+                for key in keys {
+                    var error: NSError?
+                    if asset.statusOfValue(forKey: key, error: &error) != .loaded {
+                        assetIsValid = false
+                        break
+                    }
+                }
+                syncQueue.async {
+                    if assetIsValid {
+                        loadedAssets[index] = asset
+                    } else {
+                        loadFailed = true
+                    }
+                    dispatchGroup.leave()
+                }
+            }
+        }
+
+        dispatchGroup.notify(queue: DispatchQueue.global(qos: .userInitiated)) { [weak self] in
+            guard let self = self else {
+                completion(false)
+                return
+            }
+
+            var assets: [AVURLAsset] = []
+            var didFail = false
+            syncQueue.sync {
+                if loadFailed || loadedAssets.contains(where: { $0 == nil }) {
+                    didFail = true
+                } else {
+                    assets = loadedAssets.compactMap { $0 }
+                }
+            }
+
+            if didFail || assets.count != segmentURLs.count {
+                completion(false)
+                return
+            }
+
+            let composition = AVMutableComposition()
+            guard let compositionAudioTrack = composition.addMutableTrack(
+                withMediaType: .audio,
+                preferredTrackID: kCMPersistentTrackID_Invalid
+            ) else {
+                completion(false)
+                return
+            }
+
+            var insertTime = CMTime.zero
+
+            for asset in assets {
+                guard let assetTrack = asset.tracks(withMediaType: .audio).first else {
+                    completion(false)
+                    return
+                }
+
+                do {
+                    let timeRange = CMTimeRange(start: .zero, duration: asset.duration)
+                    try compositionAudioTrack.insertTimeRange(timeRange, of: assetTrack, at: insertTime)
+                    insertTime = CMTimeAdd(insertTime, asset.duration)
+                } catch {
+                    completion(false)
+                    return
+                }
+            }
+
+            guard let exportSession = AVAssetExportSession(asset: composition, presetName: AVAssetExportPresetAppleM4A) else {
+                completion(false)
+                return
+            }
+
+            let tempDirectory = self.getDirectoryToSaveAudioFile()
+            let tempPath = tempDirectory.appendingPathComponent("temp-merged-\(Int(Date().timeIntervalSince1970 * 1000)).m4a")
+
+            exportSession.outputURL = tempPath
+            exportSession.outputFileType = .m4a
+
+            exportSession.exportAsynchronously {
+                guard exportSession.status == .completed else {
+                    completion(false)
+                    return
+                }
+
+                if !FileManager.default.fileExists(atPath: tempPath.path) {
+                    completion(false)
+                    return
+                }
+
+                do {
+                    if FileManager.default.fileExists(atPath: mergedFilePath.path) {
+                        try FileManager.default.removeItem(at: mergedFilePath)
+                    }
+                    try FileManager.default.moveItem(at: tempPath, to: mergedFilePath)
+
+                    for segmentURL in self.audioFileSegments {
+                        if segmentURL != mergedFilePath && FileManager.default.fileExists(atPath: segmentURL.path) {
+                            try? FileManager.default.removeItem(at: segmentURL)
+                        }
+                    }
+                    self.baseAudioFilePath = mergedFilePath
+                    completion(true)
+                } catch {
+                    if FileManager.default.fileExists(atPath: tempPath.path) {
+                        try? FileManager.default.removeItem(at: tempPath)
+                    }
+                    completion(false)
+                }
+            }
+        }
+    }
+
 }

package/ios/Sources/VoiceRecorder/Messages.swift

@@ -7,6 +7,7 @@ struct Messages {
     static let FAILED_TO_RECORD = "FAILED_TO_RECORD"
     static let RECORDING_HAS_NOT_STARTED = "RECORDING_HAS_NOT_STARTED"
     static let FAILED_TO_FETCH_RECORDING = "FAILED_TO_FETCH_RECORDING"
+    static let FAILED_TO_MERGE_RECORDING = "FAILED_TO_MERGE_RECORDING"
     static let EMPTY_RECORDING = "EMPTY_RECORDING"
     static let ALREADY_RECORDING = "ALREADY_RECORDING"
     static let MICROPHONE_BEING_USED = "MICROPHONE_BEING_USED"

package/ios/Sources/VoiceRecorder/VoiceRecorder.swift

@@ -54,6 +54,14 @@ public class VoiceRecorder: CAPPlugin, CAPBridgedPlugin {
             return
         }
 
+        customMediaRecorder?.onInterruptionBegan = { [weak self] in
+            self?.notifyListeners("voiceRecordingInterrupted", data: [:])
+        }
+
+        customMediaRecorder?.onInterruptionEnded = { [weak self] in
+            self?.notifyListeners("voiceRecordingInterruptionEnded", data: [:])
+        }
+
         let directory: String? = call.getString("directory")
         let subDirectory: String? = call.getString("subDirectory")
         let recordOptions = RecordOptions(directory: directory, subDirectory: subDirectory)
@@ -71,27 +79,42 @@ public class VoiceRecorder: CAPPlugin, CAPBridgedPlugin {
             return
         }
 
-        customMediaRecorder?.stopRecording()
-
-        let audioFileUrl = customMediaRecorder?.getOutputFile()
-        if(audioFileUrl == nil) {
-            customMediaRecorder = nil
-            call.reject(Messages.FAILED_TO_FETCH_RECORDING)
-            return
-        }
-
-        let sendDataAsBase64 = customMediaRecorder?.options?.directory == nil
-        let recordData = RecordData(
-            recordDataBase64: sendDataAsBase64 ? readFileAsBase64(audioFileUrl) : nil,
-            mimeType: "audio/aac",
-            msDuration: getMsDurationOfAudioFile(audioFileUrl),
-            uri: sendDataAsBase64 ? nil : audioFileUrl!.path
-        )
-        customMediaRecorder = nil
-        if (sendDataAsBase64 && recordData.recordDataBase64 == nil) || recordData.msDuration < 0 {
-            call.reject(Messages.EMPTY_RECORDING)
-        } else {
-            call.resolve(ResponseGenerator.dataResponse(recordData.toDictionary()))
+        customMediaRecorder?.stopRecording { [weak self] stopSuccess in
+            DispatchQueue.main.async {
+                guard let self = self else {
+                    call.reject(Messages.FAILED_TO_FETCH_RECORDING)
+                    return
+                }
+
+                if !stopSuccess {
+                    self.customMediaRecorder = nil
+                    call.reject(Messages.FAILED_TO_MERGE_RECORDING)
+                    return
+                }
+
+                let audioFileUrl = self.customMediaRecorder?.getOutputFile()
+                if(audioFileUrl == nil) {
+                    self.customMediaRecorder = nil
+                    call.reject(Messages.FAILED_TO_FETCH_RECORDING)
+                    return
+                }
+
+                let fileExtension = audioFileUrl!.pathExtension.lowercased()
+                let mimeType = fileExtension == "m4a" ? "audio/mp4" : "audio/aac"
+                let sendDataAsBase64 = self.customMediaRecorder?.options?.directory == nil
+                let recordData = RecordData(
+                    recordDataBase64: sendDataAsBase64 ? self.readFileAsBase64(audioFileUrl) : nil,
+                    mimeType: mimeType,
+                    msDuration: self.getMsDurationOfAudioFile(audioFileUrl),
+                    uri: sendDataAsBase64 ? nil : audioFileUrl!.path
+                )
+                self.customMediaRecorder = nil
+                if (sendDataAsBase64 && recordData.recordDataBase64 == nil) || recordData.msDuration < 0 {
+                    call.reject(Messages.EMPTY_RECORDING)
+                } else {
+                    call.resolve(ResponseGenerator.dataResponse(recordData.toDictionary()))
+                }
+            }
         }
     }
 

package/package.json

@@ -13,7 +13,7 @@
     "url": "https://github.com/independo-gmbh/capacitor-voice-recorder.git"
   },
   "description": "Capacitor plugin for voice recording",
-  "version": "8.0.2-dev.1",
+  "version": "8.1.0-dev.1",
   "devDependencies": {
     "@capacitor/android": "^8.0.0",
     "conventional-changelog-conventionalcommits": "^9.1.0",