使用指南：React Native 音频库 `react-native-audio`

使用指南：React Native 音频库 react-native-audio

react-native-audioAudio recorder library for React Native项目地址:https://gitcode.com/gh_mirrors/re/react-native-audio

本文档将指导你安装和使用基于 GitHub 仓库 jsierles/react-native-audio 的 React Native 音频处理库。

1. 项目目录结构及介绍

在 react-native-audio 项目中，主要目录结构如下：

react-native-audio/
├── Example      // 示例应用目录
│   ├── App.js     // 示例应用的主入口文件
│   └── ...        // 其他相关示例文件和资源
└── src           // 库源代码目录
    ├── ios       // iOS 平台相关的源码和配置
    ├── android   // Android 平台相关的源码和配置
    └── index.js   // 主入口文件，导出库的所有功能

• Example：包含了如何在实际应用中使用 react-native-audio 的样例。
• src：核心库的源代码，分为 iOS 和 Android 两个子目录，分别对应平台特定的实现，而 index.js 是整个库的导出点。

2. 项目的启动文件介绍

Example/App.js

App.js 文件是示例应用的起点，它展示了 react-native-audio 库的基本用法。通常包括以下部分：

• 导入库：import { Audio } from 'react-native-audio';
• 初始化音频：创建音频对象并加载文件。
• 控制音频播放：如播放、暂停、停止等操作。
• 监听事件：例如播放结束、错误发生等事件监听器。

示例中的关键代码可能如下所示：

import React, { Component } from 'react';
import { Audio } from 'react-native-audio';

class App extends Component {
  async componentDidMount() {
    try {
      await this.loadSound();
    } catch (error) {
      console.log(error);
    }
  }

  loadSound = async () => {
    const { status } = await Audio.requestPermissionsAsync();
    if (status !== 'granted') {
      return;
    }
    const sound = new Audio.Sound();
    try {
      await sound.loadAsync('path/to/audio.mp3');
      await sound.playAsync();
    } catch (error) {
      console.error(error);
    } finally {
      sound.release();
    }
  };

  render() {
    return <Text>Playground</Text>;
  }
}

export default App;

请注意替换成你的音频文件路径并根据需要调整其他功能。

3. 项目的配置文件介绍

react-native-audio 不直接依赖于特定的配置文件，但你需要确保你的React Native项目已经正确地配置了iOS和Android的环境。对于iOS，可能需要更新Info.plist以请求音频播放权限；而对于Android，需要在AndroidManifest.xml中添加相应的权限声明。

在iOS上，打开ios/YourProjectName/Info.plist，添加以下条目来允许后台播放：

<key>UIBackgroundModes</key>
<array>
    <string>audio</string>
</array>

在Android上，打开android/app/src/main/AndroidManifest.xml，确保有以下权限：

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

以上就是对 react-native-audio 项目的简单介绍和配置说明。在实际开发中，参照此指南结合项目文档和示例应用，你应该能够顺利集成和使用这个库。祝你好运！

react-native-audioAudio recorder library for React Native项目地址:https://gitcode.com/gh_mirrors/re/react-native-audio