@elevenlabs/react-native 0.5.5 → 0.5.7

package/src/components/LiveKitRoomWrapper.tsx

@@ -2,7 +2,7 @@
 import React from 'react';
 import { LiveKitRoom } from '@livekit/react-native';
 import type { LocalParticipant } from 'livekit-client';
-import type { Callbacks, ClientToolsConfig } from '../types';
+import type { Callbacks, ClientToolsConfig, AudioSessionConfig } from '../types';
 import { MessageHandler } from './MessageHandler';
 
 interface LiveKitRoomWrapperProps {
@@ -20,6 +20,8 @@ interface LiveKitRoomWrapperProps {
   clientTools: ClientToolsConfig['clientTools'];
   onEndSession: (reason?: "user" | "agent") => void;
   updateCurrentEventId?: (eventId: number) => void;
+  audioSessionConfig?: AudioSessionConfig;
+  textOnly?: boolean;
 }
 
 export const LiveKitRoomWrapper = ({
@@ -37,13 +39,37 @@ export const LiveKitRoomWrapper = ({
   clientTools,
   updateCurrentEventId,
   onEndSession,
+  audioSessionConfig,
+  textOnly = false,
 }: LiveKitRoomWrapperProps) => {
+  // Configure audio options based on audioSessionConfig
+  const audioOptions = React.useMemo(() => {
+    if (textOnly) {
+      return false;
+    }
+
+    if (!audioSessionConfig?.allowMixingWithOthers) {
+      return true;
+    }
+
+    // When mixing is enabled, configure audio to allow concurrent playback
+    return {
+      audio: {
+        noiseSuppression: true,
+        echoCancellation: true,
+      },
+      audioSessionConfiguration: {
+        allowMixingWithOthers: true,
+      },
+    };
+  }, [audioSessionConfig, textOnly]);
+
   return (
     <LiveKitRoom
       serverUrl={serverUrl}
       token={token}
       connect={connect}
-      audio={true}
+      audio={audioOptions}
       video={false}
       options={{
         adaptiveStream: { pixelDensity: 'screen' },

package/src/hooks/useLiveKitRoom.ts

@@ -7,12 +7,14 @@ export const useLiveKitRoom = (
   callbacksRef: { current: Callbacks },
   setStatus: (status: ConversationStatus) => void,
   conversationId: string,
-  status: ConversationStatus
+  status: ConversationStatus,
+  textOnly: boolean = false
 ) => {
   const [roomConnected, setRoomConnected] = useState(false);
   const [localParticipant, setLocalParticipant] =
     useState<LocalParticipant | null>(null);
   const hasCalledOnConnectRef = useRef(false);
+  const audioSessionActiveRef = useRef(false);
 
   // Reset room state when conversationId changes (new session starting)
   useEffect(() => {
@@ -24,15 +26,23 @@ export const useLiveKitRoom = (
   }, [conversationId]);
 
   useEffect(() => {
-    const start = async () => {
-      await AudioSession.startAudioSession();
-    };
+    const shouldHaveAudio = !textOnly && !!conversationId;
 
-    start();
-    return () => {
+    if (shouldHaveAudio && !audioSessionActiveRef.current) {
+      audioSessionActiveRef.current = true;
+      AudioSession.startAudioSession();
+    } else if (!shouldHaveAudio && audioSessionActiveRef.current) {
+      audioSessionActiveRef.current = false;
       AudioSession.stopAudioSession();
+    }
+
+    return () => {
+      if (audioSessionActiveRef.current) {
+        audioSessionActiveRef.current = false;
+        AudioSession.stopAudioSession();
+      }
     };
-  }, []);
+  }, [textOnly, conversationId]);
 
   // Fire onConnect when both participant and room are fully ready
   useEffect(() => {

package/src/index.ts

@@ -12,4 +12,5 @@ export type {
   ConversationOptions,
   ConversationConfig,
   ConversationEvent,
+  AudioSessionConfig,
 } from "./types";

package/src/types.ts

@@ -1,15 +1,15 @@
 import type * as Types from "@elevenlabs/types";
 import type {
+  AsrInitiationMetadataEvent as AsrMetadataEvent,
+  Callbacks,
+  ConversationMetadata,
+  Mode as ConversationMode,
   Incoming,
-  Outgoing,
   Interruption,
-  ConversationMetadata,
-  Ping,
   Role as MessageRole,
-  Mode as ConversationMode,
+  Outgoing,
+  Ping,
   Status,
-  Callbacks,
-  AsrInitiationMetadataEvent as AsrMetadataEvent,
 } from "@elevenlabs/types";
 export type { Callbacks } from "@elevenlabs/types";
 
@@ -70,6 +70,7 @@ export type ConversationConfig = {
     };
     tts?: {
       voiceId?: string;
+      speed?: number;
     };
     conversation?: {
       textOnly?: boolean;
@@ -139,3 +140,20 @@ export type ConversationEvent =
   | ConversationMetadataEvent
   | AsrInitiationMetadataEvent
   | AgentChatResponsePartEvent;
+
+/**
+ * Audio session configuration for controlling how the SDK handles audio
+ */
+export interface AudioSessionConfig {
+  /**
+   * Whether audio should mix with other audio sources.
+   * When true, the SDK will configure the audio session to allow
+   * concurrent audio playback with other audio sources.
+   *
+   * iOS: Adds AVAudioSessionCategoryOptionMixWithOthers
+   * Android: Uses AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
+   *
+   * @default false (exclusive audio session)
+   */
+  allowMixingWithOthers?: boolean;
+}

package/src/utils/overrides.ts

@@ -17,6 +17,7 @@ export function constructOverrides(
       },
       tts: {
         voice_id: config.overrides.tts?.voiceId,
+        speed: config.overrides.tts?.speed,
       },
       conversation: {
         text_only: config.overrides.conversation?.textOnly,

package/src/version.ts

@@ -1,2 +1,2 @@
 // This file is auto-generated during build
-export const PACKAGE_VERSION = "0.5.5";
+export const PACKAGE_VERSION = "0.5.7";