react-native-davoice-tts 1.0.360 → 1.0.362

package/ios/TTSRNBridge/DavoiceTTS.xcframework/ios-arm64_x86_64-simulator/DavoiceTTS.framework/_CodeSignature/CodeResources

@@ -6,7 +6,7 @@
 	<dict>
 		<key>Headers/DavoiceTTS-Swift.h</key>
 		<data>
-		0y4wnEptFaUKvETRTCKi7FfPd8s=
+		6FhZ7bcv5mSNZxa0RquARZ5WEKA=
 		</data>
 		<key>Info.plist</key>
 		<data>
@@ -14,7 +14,7 @@
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		MY66E6WyBVXIl9BnfupeiL1jepk=
+		FrPVq+Vnd+C1TCs8p2QBSh7kcZ0=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
@@ -22,7 +22,7 @@
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		yG3MjSM6H1RKr50XigfG1LjX3LI=
+		qK/Bas4V4+n3sU5V1pwkQ7yjp+g=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
@@ -30,11 +30,11 @@
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		I0ZZs1/VTcCYET0HUBB4e1m9NIQ=
+		235PinAV5W/iFFGdXZbvDhdtHmk=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		MY66E6WyBVXIl9BnfupeiL1jepk=
+		FrPVq+Vnd+C1TCs8p2QBSh7kcZ0=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
@@ -42,7 +42,7 @@
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		ET2PbztHDBA5E1oZoGnvMeMf7Hw=
+		hKUkvVh5OObgqNhNkolw08nNpqE=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
@@ -50,7 +50,7 @@
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		JxTbIAPQqoY+QChG6blPBPcQe3I=
+		bgP7BCBNSATwzYvX00Nl2ba8N30=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -63,22 +63,22 @@
 		<dict>
 			<key>hash</key>
 			<data>
-			0y4wnEptFaUKvETRTCKi7FfPd8s=
+			6FhZ7bcv5mSNZxa0RquARZ5WEKA=
 			</data>
 			<key>hash2</key>
 			<data>
-			rr1pVbVt9W7SKsyOrFpwex8/aZNUyBGGs16Q2Qadoac=
+			RJHuR7+/aZIzEqHR6R8QQ0DeYjKM8cKtcSNaXQ4sbg4=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash</key>
 			<data>
-			MY66E6WyBVXIl9BnfupeiL1jepk=
+			FrPVq+Vnd+C1TCs8p2QBSh7kcZ0=
 			</data>
 			<key>hash2</key>
 			<data>
-			MLoKKgw4AYadSd11qBjHKKQzvkcpIvtr7OA/UIRwG24=
+			ErEFHyUsbVBMPtQRVFVuyBXYNe1gDmPOL1fuGtU0zKo=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
@@ -96,11 +96,11 @@
 		<dict>
 			<key>hash</key>
 			<data>
-			yG3MjSM6H1RKr50XigfG1LjX3LI=
+			qK/Bas4V4+n3sU5V1pwkQ7yjp+g=
 			</data>
 			<key>hash2</key>
 			<data>
-			fzy/aKiRSse5L9MDay6voxPyUjm17gfda323ob48Ohs=
+			9IH1S1pn4YKVr1UO7kbc60iOvf5Zrj6nbNat0lSHTes=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
@@ -118,22 +118,22 @@
 		<dict>
 			<key>hash</key>
 			<data>
-			I0ZZs1/VTcCYET0HUBB4e1m9NIQ=
+			235PinAV5W/iFFGdXZbvDhdtHmk=
 			</data>
 			<key>hash2</key>
 			<data>
-			IQXV0Ijhyd+kB+sGiji73vddv9kY1Z+H+GeEHgpPS1w=
+			rW0+wa483eUxa3t5TV/3VEdO5PAKc7Tddd8e7SsETmk=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash</key>
 			<data>
-			MY66E6WyBVXIl9BnfupeiL1jepk=
+			FrPVq+Vnd+C1TCs8p2QBSh7kcZ0=
 			</data>
 			<key>hash2</key>
 			<data>
-			MLoKKgw4AYadSd11qBjHKKQzvkcpIvtr7OA/UIRwG24=
+			ErEFHyUsbVBMPtQRVFVuyBXYNe1gDmPOL1fuGtU0zKo=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
@@ -151,11 +151,11 @@
 		<dict>
 			<key>hash</key>
 			<data>
-			ET2PbztHDBA5E1oZoGnvMeMf7Hw=
+			hKUkvVh5OObgqNhNkolw08nNpqE=
 			</data>
 			<key>hash2</key>
 			<data>
-			w8ot8k5qpRMwzbfgbSskl1Fvf/6+z+fkBQ/yn5B3UII=
+			d/179D6qtHuBsr8yiDl2SexIwWi8ArqdhzYvojT00kM=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
@@ -173,11 +173,11 @@
 		<dict>
 			<key>hash</key>
 			<data>
-			JxTbIAPQqoY+QChG6blPBPcQe3I=
+			bgP7BCBNSATwzYvX00Nl2ba8N30=
 			</data>
 			<key>hash2</key>
 			<data>
-			hXvsfFN1DMvUhFZqXnZMoygdgMgDm2SSpNCKkijh+EU=
+			hXeL5TIFZ7a13fhKUjuvQA7jSZ+9eilnBz5Pshp0lXQ=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-davoice-tts",
-    "version": "1.0.360",
+    "version": "1.0.362",
     "description": "tts library for React Native",
     "main": "tts/index.js",
     "types": "tts/index.d.ts",

package/speech/audioRoutingConfig.md

@@ -74,6 +74,70 @@ In this fallback position, `none` forces the ordinary HFP-capable category
 policy and then clears the preferred input. HFP may reduce Bluetooth output
 quality.
 
-`bluetoothHighQualityRecording` requires iOS 26 and `mode: "default"`. Apply the
-same input policy to `WhenPlayingAudio.onPlay` if TTS/WAV playback should retain
-the selected microphone route.
+`bluetoothHighQualityRecording` requires iOS 26 and `mode: "default"`.
+`WhenPlayingAudio.onPlay` and `STTDuckingConfig.onUnpause` are temporary
+ducking markers/deltas: native code retains the selected regular hardware and
+input route and adds `duckOthers`.
+
+## Debounced Unducking Between Playback Calls
+
+`WhenPlayingAudio.msBeforeUnduck` controls how long the native package keeps
+the temporary playback session after the physical queue becomes empty:
+
+```ts
+const audioRoutingConfig: AudioRoutingConfig = {
+  default: regularRoute,
+  WhenPlayingAudio: {
+    onPlay: duckedPlaybackRoute,
+    onFinishPlaying: {
+      ...regularRoute,
+      notifyOthers: true,
+    },
+    msBeforeUnduck: 3000,
+  },
+};
+```
+
+The default is `3000` milliseconds whenever `WhenPlayingAudio.onPlay` or
+`WhenPlayingAudio.onFinishPlaying` exists. A new `speak()`, `playWav()`, or
+other queued playback request during that quiet period cancels and later
+restarts the deadline, so consecutive sounds share one ducking lifecycle.
+Logical playback completion events still fire when audio finishes; they do not
+wait for the unduck deadline. When the deadline finally expires, native code
+performs `notifyOthersOnDeactivation` when configured, restores regular
+routing, and reactivates STT/wakeword under that regular session. Set the value
+to `0` to restore immediately.
+
+## Duck While STT Is Unpaused
+
+`STTDuckingConfig` uses the same native lease scheduler as playback:
+
+```ts
+const audioRoutingConfig: AudioRoutingConfig = {
+  default: regularRoute,
+  WhenPlayingAudio: {
+    onPlay: { options: ['duckOthers'] },
+    onFinishPlaying: { notifyOthers: true },
+    msBeforeUnduck: 3000,
+  },
+  STTDuckingConfig: {
+    onUnpause: { options: ['duckOthers'] },
+    onPause: { notifyOthers: true },
+    msBeforeUnduck: 3000,
+  },
+};
+```
+
+An unpaused STT session holds its lease indefinitely, so no unduck deadline
+runs while recognition remains unpaused. Pausing STT releases its lease and
+starts its quiet-period deadline only if playback is also idle. Likewise,
+playback finishing cannot unduck while STT remains unpaused. If STT starts
+first, playback joins its ducked session; if playback starts first, STT joins
+the playback session without an intermediate route restore. New playback or an
+STT unpause cancels a pending deadline. Nested lite-pause calls change the lease
+only on the real unpaused-to-paused and paused-to-unpaused transitions.
+
+`STTDuckingConfig.msBeforeUnduck` defaults to `3000` milliseconds when the
+section contains `onUnpause` or `onPause`. Set it to `0` for immediate
+restoration once STT and playback are both inactive. Omitting
+`STTDuckingConfig` preserves the previous STT routing behavior.

package/speech/index.ts

@@ -142,6 +142,23 @@ export type AudioRoutingConfig = {
   WhenPlayingAudio?: {
     onPlay?: RouteConfigEntry;
     onFinishPlaying?: RouteConfigEntry;
+    /**
+     * Quiet period after the playback queue drains before restoring regular
+     * routing and notifying other audio. New playback restarts the deadline.
+     * Defaults to 3000 ms. Use 0 for immediate restoration.
+     */
+    msBeforeUnduck?: number;
+  };
+  /** Optional temporary ducking policy while native STT is unpaused. */
+  STTDuckingConfig?: {
+    onUnpause?: RouteConfigEntry;
+    onPause?: RouteConfigEntry;
+    /**
+     * Quiet period after STT pauses before restoring regular routing and
+     * notifying other audio. Playback and STT share one native scheduler.
+     * Defaults to 3000 ms. Use 0 for immediate restoration.
+     */
+    msBeforeUnduck?: number;
   };
 };