Sound service

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Diego31-10/TableOrderApp/llms.txt

Use this file to discover all available pages before exploring further.

​

Configuration

const BEEP_SOURCE = {
  uri: 'https://assets.mixkit.co/active_storage/sfx/2568/2568-preview.mp3',
};

const BEEP_SOURCE = require('@/assets/sounds/beep.mp3');

​

Functions

​

preloadBeep

preloadBeep(): Promise<void>

​

Example

import { preloadBeep } from '@/src/lib/core/sound/SoundService';
import { useEffect } from 'react';

// In RootLayout or App.tsx
export default function RootLayout() {
  useEffect(() => {
    preloadBeep();
  }, []);
  
  return <Slot />;
}

​

Behavior

1. Sets audio mode to play in silent mode on iOS:
   await Audio.setAudioModeAsync({ playsInSilentModeIOS: true });
   
2. Creates and caches the sound instance:
   const { sound } = await Audio.Sound.createAsync(BEEP_SOURCE, {
     shouldPlay: false,
     volume: 0.8,
   });
   soundInstance = sound;
   
3. Errors are caught silently (graceful degradation):
   try {
     // ... load logic
   } catch {
     // Haptics will still work
   }
   

​

playBeep

playBeep(): Promise<void>

​

Example

import { playBeep } from '@/src/lib/core/sound/SoundService';
import * as Haptics from 'expo-haptics';

const handleQRCodeScanned = async (data: string) => {
  // Play sound and haptic feedback
  await playBeep();
  await Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Medium);
  
  // Process QR code
  console.log('Scanned:', data);
};

​

Behavior

1. Checks if sound is preloaded, lazy-loads if not:
   if (!soundInstance) {
     await preloadBeep();
   }
   
2. Resets playback position to start:
   await soundInstance?.setPositionAsync(0);
   
3. Plays the sound:
   await soundInstance?.playAsync();
   
4. All errors are silently caught:
   try {
     // ... play logic
   } catch {
     // Intentionally swallowed — haptic feedback is the primary signal
   }
   

​

unloadBeep

unloadBeep(): Promise<void>

​

Example

import { unloadBeep } from '@/src/lib/core/sound/SoundService';
import { useEffect } from 'react';

export default function RootLayout() {
  useEffect(() => {
    return () => {
      unloadBeep();
    };
  }, []);
  
  return <Slot />;
}

​

Behavior

1. Unloads the sound instance and clears memory:
   await soundInstance?.unloadAsync();
   soundInstance = null;
   
2. Errors are caught silently:
   try {
     // ... unload logic
   } catch {
     // no-op
   }
   

​

Sound instance management

let soundInstance: Audio.Sound | null = null;

• Only one sound object is loaded in memory
• Subsequent playBeep() calls reuse the same instance
• Multiple rapid calls won’t create audio resource leaks

​

Graceful degradation

1. Network failures: Remote URI loading fails silently
2. Missing assets: Local file not found fails silently
3. Audio permissions: iOS audio restrictions fail silently
4. Resource exhaustion: Memory/CPU limits fail silently

​

iOS silent mode

await Audio.setAudioModeAsync({ playsInSilentModeIOS: true });

​

Volume control

const { sound } = await Audio.Sound.createAsync(BEEP_SOURCE, {
  shouldPlay: false,
  volume: 0.8, // 0.0 to 1.0
});

await soundInstance?.setVolumeAsync(0.5); // 50% volume

​

Best practices

1. Preload early: Call preloadBeep() in RootLayout for instant first-play
2. Don’t await playback: Fire and forget for responsive UI
   playBeep(); // No await needed
   Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Medium);
   
3. Test on device: Audio doesn’t work reliably in simulators
4. Pair with haptics: Audio alone may not be perceived (silent mode, hearing impairment)
   const provideFeedback = async () => {
     await Promise.all([
       playBeep(),
       Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Medium)
     ]);
   };
   
5. Unload on unmount: Prevent memory leaks in long-running apps

​

Common patterns

​

QR scanner feedback

import { playBeep } from '@/src/lib/core/sound/SoundService';
import * as Haptics from 'expo-haptics';

const handleBarCodeScanned = ({ data }: { data: string }) => {
  playBeep();
  Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Medium);
  processQRCode(data);
};

​

Payment confirmation

const handlePaymentSuccess = async () => {
  await playBeep();
  await Haptics.notificationAsync(Haptics.NotificationFeedbackType.Success);
  await sendPaymentNotification(amount, tableName);
  router.push('/success');
};

​

Button press enhancement

const FancyButton = ({ onPress, children }) => {
  const handlePress = () => {
    playBeep();
    Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Light);
    onPress();
  };
  
  return <Pressable onPress={handlePress}>{children}</Pressable>;
};

​

Troubleshooting

​

Sound doesn’t play

1. Check device volume (physical buttons)
2. Verify audio mode on iOS (should play in silent mode)
3. Test with headphones connected
4. Check console for silent error logs
5. Verify network connection (if using remote URI)

​

Sound plays with delay

• Ensure preloadBeep() was called during app initialization
• Check network latency (if using remote URI)
• Switch to local asset for zero-latency playback

​

Memory warnings

• Ensure unloadBeep() is called on app unmount
• Check for multiple sound instances (should only be one)
• Verify cleanup in useEffect return functions