React Native

npm install sarvam-conv-ai-sdk

import { ConversationAgent } from "sarvam-conv-ai-sdk/react-native";

import {
  ConversationAgent,
  InteractionType,
} from "sarvam-conv-ai-sdk/react-native";

const agent = new ConversationAgent({
  apiKey: "your_api_key",
  config: {
    org_id: "your_org_id",
    workspace_id: "your_workspace_id",
    app_id: "your_app_id",
    user_identifier: "user123",
    user_identifier_type: "custom",
    interaction_type: InteractionType.CHAT,
    input_sample_rate: 16000,
    output_sample_rate: 16000,
  },
  textCallback: async (msg) => console.log("Agent:", msg.text),
  platform: "react-native",
});

await agent.start();
await agent.waitForConnect(10);
await agent.sendText("Hello!");

import {
  ConversationAgent,
  InteractionType,
} from "sarvam-conv-ai-sdk/react-native";

const audioInterface = new MyRNAudioInterface();

const agent = new ConversationAgent({
  apiKey: "your_api_key",
  config: {
    org_id: "your_org_id",
    workspace_id: "your_workspace_id",
    app_id: "your_app_id",
    user_identifier: "user123",
    user_identifier_type: "custom",
    interaction_type: InteractionType.CALL,
    input_sample_rate: 16000,
    output_sample_rate: 16000,
  },
  audioInterface,
  platform: "react-native",
  transcriptCallback: async (msg) => {
    console.log(`${msg.role}: ${msg.content}`);
  },
});

await agent.start();
await agent.waitForConnect(10);

import {
  AsyncAudioInterface,
  AudioData,
} from "sarvam-conv-ai-sdk/react-native";

class MyRNAudioInterface implements AsyncAudioInterface {
  /**
   * Start capturing audio from the microphone.
   * Call inputCallback with PCM audio data (16-bit, mono, at configured sample rate).
   */
  async start(
    inputCallback: (audioData: AudioData, frameCount: number) => Promise<void>,
  ): Promise<void> {
    // Initialize your audio recording library
    // Call inputCallback with Uint8Array of 16-bit PCM data
  }

  /**
   * Play audio through the speaker.
   * @param audio - Uint8Array of 16-bit PCM mono audio
   * @param sampleRate - Sample rate of the audio (e.g., 16000 or 22050)
   */
  async output(audio: Uint8Array, sampleRate?: number): Promise<void> {
    // Play the audio using your playback library
  }

  /**
   * Interrupt and stop any ongoing playback immediately.
   * Called when the user interrupts the agent.
   */
  interrupt(): void {
    // Stop all queued/playing audio
  }

  /**
   * Stop recording and clean up resources.
   */
  async stop(): Promise<void> {
    // Release microphone and audio resources
  }
}

const agent = new ConversationAgent({
  apiKey: "", // Empty - proxy handles Sarvam auth
  baseUrl: "https://api.yourapp.com/sarvam/",
  customHeaders: {
    Authorization: "Bearer eyJhbGciOiJIUzI1NiIs...",
    "X-User-Id": "user-123",
  },
  config: {
    // ... your config
  },
  platform: "react-native",
});

useEffect(() => {
  return () => {
    agentRef.current?.stop().catch(console.error);
  };
}, []);

import { useEffect, useRef } from "react";
import { AppState, AppStateStatus } from "react-native";

const appState = useRef(AppState.currentState);

useEffect(() => {
  const subscription = AppState.addEventListener(
    "change",
    (nextState: AppStateStatus) => {
      if (appState.current.match(/active/) && nextState === "background") {
        agentRef.current?.stop();
      }
      appState.current = nextState;
    },
  );

  return () => subscription.remove();
}, []);

const connected = await agent.waitForConnect(10);
if (!connected) {
  // Handle connection failure — show an error or retry
}

import { Audio } from "expo-av";

const { granted } = await Audio.requestPermissionsAsync();
if (!granted) {
  // Show dialog asking user to enable permission in Settings
}

import { request, PERMISSIONS, RESULTS } from "react-native-permissions";
import { Platform } from "react-native";

const result = await request(
  Platform.OS === "ios"
    ? PERMISSIONS.IOS.MICROPHONE
    : PERMISSIONS.ANDROID.RECORD_AUDIO,
);

if (result !== RESULTS.GRANTED) {
  // Handle denied permission
}

const subscription = AppState.addEventListener("change", async (nextState) => {
  if (nextState === "active" && !agentRef.current?.isConnected()) {
    await agentRef.current?.stop();
    // Create a new ConversationAgent instance and call start()
  }
});