1# Migrating from expo-av to expo-audio
2 
3## Imports
4 
5```tsx
6// Before
7import { Audio } from 'expo-av';
8 
9// After
10import { useAudioPlayer, useAudioRecorder, RecordingPresets, AudioModule, setAudioModeAsync } from 'expo-audio';
11```
12 
13## Audio Playback
14 
15### Before (expo-av)
16 
17```tsx
18const [sound, setSound] = useState<Audio.Sound>();
19 
20async function playSound() {
21  const { sound } = await Audio.Sound.createAsync(require('./audio.mp3'));
22  setSound(sound);
23  await sound.playAsync();
24}
25 
26useEffect(() => {
27  return sound ? () => { sound.unloadAsync(); } : undefined;
28}, [sound]);
29```
30 
31### After (expo-audio)
32 
33```tsx
34const player = useAudioPlayer(require('./audio.mp3'));
35 
36// Play
37player.play();
38```
39 
40## Audio Recording
41 
42### Before (expo-av)
43 
44```tsx
45const [recording, setRecording] = useState<Audio.Recording>();
46 
47async function startRecording() {
48  await Audio.requestPermissionsAsync();
49  await Audio.setAudioModeAsync({ allowsRecordingIOS: true, playsInSilentModeIOS: true });
50  const { recording } = await Audio.Recording.createAsync(Audio.RecordingOptionsPresets.HIGH_QUALITY);
51  setRecording(recording);
52}
53 
54async function stopRecording() {
55  await recording?.stopAndUnloadAsync();
56  const uri = recording?.getURI();
57}
58```
59 
60### After (expo-audio)
61 
62```tsx
63const recorder = useAudioRecorder(RecordingPresets.HIGH_QUALITY);
64 
65async function startRecording() {
66  await AudioModule.requestRecordingPermissionsAsync();
67  await recorder.prepareToRecordAsync();
68  recorder.record();
69}
70 
71async function stopRecording() {
72  await recorder.stop();
73  const uri = recorder.uri;
74}
75```
76 
77## Audio Mode
78 
79### Before (expo-av)
80 
81```tsx
82await Audio.setAudioModeAsync({
83  allowsRecordingIOS: true,
84  playsInSilentModeIOS: true,
85  staysActiveInBackground: true,
86  interruptionModeIOS: InterruptionModeIOS.DoNotMix,
87});
88```
89 
90### After (expo-audio)
91 
92```tsx
93await setAudioModeAsync({
94  playsInSilentMode: true,
95  shouldPlayInBackground: true,
96  interruptionMode: 'doNotMix',
97});
98```
99 
100## API Mapping
101 
102| expo-av | expo-audio |
103|---------|------------|
104| `Audio.Sound.createAsync()` | `useAudioPlayer(source)` |
105| `sound.playAsync()` | `player.play()` |
106| `sound.pauseAsync()` | `player.pause()` |
107| `sound.setPositionAsync(ms)` | `player.seekTo(seconds)` |
108| `sound.setVolumeAsync(vol)` | `player.volume = vol` |
109| `sound.setRateAsync(rate)` | `player.playbackRate = rate` |
110| `sound.setIsLoopingAsync(loop)` | `player.loop = loop` |
111| `sound.unloadAsync()` | Automatic via hook |
112| `playbackStatus.positionMillis` | `player.currentTime` (seconds) |
113| `playbackStatus.durationMillis` | `player.duration` (seconds) |
114| `playbackStatus.isPlaying` | `player.playing` |
115| `Audio.Recording.createAsync()` | `useAudioRecorder(preset)` |
116| `Audio.RecordingOptionsPresets.*` | `RecordingPresets.*` |
117| `recording.stopAndUnloadAsync()` | `recorder.stop()` |
118| `recording.getURI()` | `recorder.uri` |
119| `Audio.requestPermissionsAsync()` | `AudioModule.requestRecordingPermissionsAsync()` |
120 
121## Key Differences
122 
123- **No auto-reset on finish**: After `play()` completes, the player stays paused at the end. To replay, call `player.seekTo(0)` then `play()`
124- **Time in seconds**: expo-audio uses seconds, not milliseconds (matching web standards)
125- **Immediate loading**: Audio loads immediately when the hook mounts—no explicit preloading needed
126- **Automatic cleanup**: No need to call `unloadAsync()`, hooks handle resource cleanup on unmount
127- **Multiple players**: Create multiple `useAudioPlayer` instances and store them—all load immediately
128- **Direct property access**: Set volume, rate, loop directly on the player object (`player.volume = 0.5`)
129 
130## API Reference
131 
132https://docs.expo.dev/versions/latest/sdk/audio/
133