Quick Start

<key>NSMicrophoneUsageDescription</key>
<string>Microphone access is required for audio and video calls.</string>

<!-- Required for video calls -->
<key>NSCameraUsageDescription</key>
<string>Camera access is required for video calls.</string>

<key>UIBackgroundModes</key>
<array>
  <string>audio</string>
  <string>voip</string>
  <string>remote-notification</string>
</array>

cd ios && pod install && cd ..

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<!-- Video (or apps that offer both voice and video) -->
<uses-permission android:name="android.permission.CAMERA" />

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.VIBRATE" />

{
  "expo": {
    "plugins": ["@alaznah/calling"]
  }
}

npx expo prebuild
# or
eas build --profile development

# React Native CLI
npx react-native run-ios
npx react-native run-android

# Expo development build
npx expo run:ios
npx expo run:android

POST https://api.yourapp.com/calling/token
Authorization: Bearer <sessionToken>

POST https://www.alaznah.com/api/v1/calling/token
Authorization: Bearer ac_live_YOUR_API_KEY
Content-Type: application/json

{ "userId": "alice", "ttlSeconds": 900 }

import React from 'react';
import {
  CallingProvider,
  CallingScreen,
  DEFAULT_HOSTED_SIGNALING_URL,
} from '@alaznah/calling';

// Device A: 'alice' / Device B: 'bob' — must match the token you minted
const APP_USER_ID = 'alice';
const DEFAULT_PEER_ID = 'bob';

async function fetchCallingToken(): Promise<string> {
  // Demo: return a Console Test Token minted for APP_USER_ID
  // return 'eyJ...';

  // Production: sessionToken comes from YOUR app login — see Authentication docs
  const res = await fetch('https://api.yourapp.com/calling/token', {
    headers: { Authorization: `Bearer ${sessionToken}` },
  });
  if (!res.ok) throw new Error('Failed to mint calling token');
  const { token } = await res.json();
  return token;
}

export default function App() {
  return (
    <CallingProvider
      config={{
        userId: APP_USER_ID,
        getAuthToken: fetchCallingToken,
        // Hosted Signaling is the default — omit signalingUrl, or set explicitly:
        signalingUrl: DEFAULT_HOSTED_SIGNALING_URL, // wss://signal.alaznah.com
      }}
    >
      <CallingScreen
        userId={APP_USER_ID}
        defaultPeerId={DEFAULT_PEER_ID}
        onError={(e) => console.warn('calling', e)}
      />
    </CallingProvider>
  );
}

import React from 'react';
import { Button } from 'react-native';
import {
  CallingProvider,
  CallingUI,
  useCallingClient,
  useCallingReady,
  requestCallPermissions,
  DEFAULT_HOSTED_SIGNALING_URL,
} from '@alaznah/calling';
const APP_USER_ID = 'alice';

async function fetchCallingToken(): Promise<string> {
  // sessionToken = YOUR app login token — see Authentication docs
  const res = await fetch('https://api.yourapp.com/calling/token', {
    headers: { Authorization: `Bearer ${sessionToken}` },
  });
  if (!res.ok) throw new Error('Failed to mint calling token');
  const { token } = await res.json();
  return token;
}

function CallingOverlay() {
  const client = useCallingClient();
  return (
    <CallingUI
      client={client}
      onError={(e) => console.warn('calling', e)}
    />
  );
}

function ChatHeader({ peerId }: { peerId: string }) {
  const client = useCallingClient();
  const ready = useCallingReady();

  const call = async (mediaType: 'audio' | 'video') => {
    if (!ready) return;
    await requestCallPermissions(mediaType);
    await client.startCall({ calleeId: peerId, mediaType });
  };

  return (
    <>
      <Button title="Audio" disabled={!ready} onPress={() => void call('audio')} />
      <Button title="Video" disabled={!ready} onPress={() => void call('video')} />
    </>
  );
}

export default function App() {
  return (
    <CallingProvider
      config={{
        userId: APP_USER_ID,
        getAuthToken: fetchCallingToken,
        signalingUrl: DEFAULT_HOSTED_SIGNALING_URL,
      }}
    >
      {/* Your navigator / chat screens */}
      <ChatHeader peerId="bob" />
      <CallingOverlay />
    </CallingProvider>
  );
}

import { requestCallPermissions } from '@alaznah/calling';

await requestCallPermissions('audio'); // voice call
await requestCallPermissions('video'); // video call (mic + camera)