React-Native-Audio-Recorder-Player 技术文档

【免费下载链接】react-native-audio-recorder-player 项目地址: https://gitcode.com/gh_mirrors/rea/react-native-audio-recorder-player

本篇文档将详细介绍React-Native库react-native-audio-recorder-player的安装、使用方法及API详情，旨在帮助开发者快速上手并充分利用此音频录制播放模块。

安装指南

环境要求

• React Native版本≥0.61（对于旧版React Native，请参考手动安装步骤）
• iOS支持版本10.0以上
• Android SDK 24及以上

安装步骤

Step 1: 在项目根目录下执行以下命令以添加依赖：

yarn add react-native-audio-recorder-player

Step 2: 根据React Native的版本进行相应配置：

• 对于React Native ≥ 0.61，执行pod安装（仅限iOS）：

  npx pod-install
  

• 对于React Native < 0.60，则需要手动链接库：

  react-native link react-native-audio-recorder-player
  

• 手动安装步骤（适用于所有情况，但自动处理后通常无需操作）：

  • iOS: 需要在Xcode中添加RNAudioRecorderPlayer.xcodeproj，并将libRNAudioRecorderPlayer.a加入到Link Binary With Libraries。
  • Android: 修改MainApplication.java添加必要的导入和初始化，以及在settings.gradle和app/build.gradle中添加对应路径和依赖。

项目使用说明

基础配置

在iOS的Info.plist中添加麦克风权限描述：

<key>NSMicrophoneUsageDescription</key>
<string>应用需要您的允许来使用麦克风录音。</string>

同样，在Android的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"/>

对于Android Marshmallow及以后版本，还需动态请求录音权限。

API使用文档

库中的核心方法提供了异步操作，以下是部分关键方法说明：

• mmss(seconds): 将秒数转换为分钟:秒的字符串格式。
• startRecorder(path, options): 开始录音，传入文件路径和可选参数。
• stopRecorder(): 结束录音。
• startPlayer(url): 播放音频文件，URL可以是本地路径或远程地址。
• stopPlayer(): 停止播放。
• pauseRecorder(): （v3新增）暂停录音。
• resumeRecorder(): （v3新增）恢复录音。
• addPlayBackListener(listener): 添加播放状态监听器。
• addRecordBackListener(listener): （v3新增）添加录音回掉监听器。
• setSubscriptionDuration(duration): 设置回调间隔时间，默认为0.5秒。

更多详细的方法参数和用法，请查看官方文档或源码注释。

注意事项

从v3.0开始，代码基础被重写至Kotlin（Android）和Swift（iOS），并且内部实现了一些重大变化，因此从较早版本升级时需遵循迁移指南，尤其是API命名的变化。

使用该库前，请确保理解上述配置步骤以及库的更新特性，以便顺利集成音频录制与播放功能到您的React Native应用中。

【免费下载链接】react-native-audio-recorder-player 项目地址: https://gitcode.com/gh_mirrors/rea/react-native-audio-recorder-player