expo-av

What is expo-av?

The expo-av package is part of the Expo ecosystem and provides a comprehensive set of tools for handling audio and video playback in React Native applications. It allows developers to easily integrate multimedia functionalities such as playing, recording, and controlling audio and video files.

What are expo-av's main functionalities?

Audio Playback

This feature allows you to play audio files in your application. The code sample demonstrates how to load and play an audio file using the Audio module from expo-av.

import { Audio } from 'expo-av';

async function playSound() {
  const { sound } = await Audio.Sound.createAsync(
     require('./assets/sound.mp3')
  );
  await sound.playAsync();
}

Video Playback

This feature allows you to play video files in your application. The code sample demonstrates how to render a video component that plays a video from a given URI.

import { Video } from 'expo-av';

<Video
  source={{ uri: 'https://www.example.com/video.mp4' }}
  rate={1.0}
  volume={1.0}
  isMuted={false}
  resizeMode="cover"
  shouldPlay
  style={{ width: 300, height: 300 }}
/>

Audio Recording

This feature allows you to record audio within your application. The code sample demonstrates how to request permissions, set the audio mode, and start recording audio using the Audio module from expo-av.

import { Audio } from 'expo-av';

async function recordAudio() {
  await Audio.requestPermissionsAsync();
  await Audio.setAudioModeAsync({ allowsRecordingIOS: true });
  const recording = new Audio.Recording();
  await recording.prepareToRecordAsync(Audio.RECORDING_OPTIONS_PRESET_HIGH_QUALITY);
  await recording.startAsync();
  // You are now recording!
}

Other packages similar to expo-av

react-native-video

react-native-video is a popular package for video playback in React Native applications. It provides a <Video> component that supports various video formats and offers extensive customization options. Compared to expo-av, react-native-video is more focused on video playback and does not include audio recording functionalities.

react-native-sound

react-native-sound is a library for playing sound clips in React Native applications. It supports various audio formats and provides simple methods for playing, pausing, and stopping sounds. Unlike expo-av, react-native-sound does not support video playback or audio recording.

react-native-audio-toolkit

react-native-audio-toolkit is a comprehensive library for audio playback and recording in React Native applications. It offers features such as audio streaming, recording, and playback control. While it provides similar functionalities to expo-av, it does not support video playback.

README

Expo universal module for Audio and Video playback

API documentation

• Documentation for the latest stable release
• Documentation for the main branch

Installation in managed Expo projects

For managed Expo projects, please follow the installation instructions in the API documentation for the latest stable release.

Installation in bare React Native projects

For bare React Native projects, you must ensure that you have installed and configured the expo package before continuing.

Add the package to your npm dependencies

npx expo install expo-av

Configure for Android

Add android.permission.RECORD_AUDIO permission to your manifest (android/app/src/main/AndroidManifest.xml):

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

Configure for iOS

Add NSMicrophoneUsageDescription key to your Info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>Allow $(PRODUCT_NAME) to access your microphone</string>

Run npx pod-install after installing the npm package.

Contributing

Contributions are very welcome! Please refer to guidelines described in the contributing guide.