export default VoiceRecorder;
`

📚 API Documentation

$3

The main hook that provides all voice recording functionality.

#### Options (VoiceRecorderOptions)

`tsx
interface VoiceRecorderOptions {
/* MIME type of recorded file (default: 'audio/webm') /
mimeType?: string;
/* Smoothing coefficient for audio level measurement (default: 0.8) /
smoothing?: number;
/* FFT size (default: 2048) /
fftSize?: number;
/* Whether to automatically enable microphone (default: false) /
autoEnableMicrophone?: boolean;
/* Whether to automatically play after recording (default: false) /
autoPlayAfterRecording?: boolean;
}
`

#### Return Value (UseVoiceRecorderReturn)

`tsx
interface UseVoiceRecorderReturn {
// State
isRecording: boolean; // Whether currently recording
isPaused: boolean; // Whether recording is paused
isMicrophoneEnabled: boolean; // Whether microphone is enabled
isPlaying: boolean; // Whether audio is playing
permission: PermissionState | 'prompt' | 'unknown'; // Microphone permission state
audioLevel: number; // Current audio level (0-1)
elapsedTime: number; // Recording elapsed time (seconds)
formattedTime: string; // Formatted recording time (HH:MM:SS)
recordedBlob: Blob | null; // Recorded audio Blob
audioUrl: string | null; // Audio URL (for playback)
error: string | null; // Error message

// Control functions
startRecording: () => void; // Start recording
pauseRecording: () => void; // Pause recording
resumeRecording: () => void; // Resume recording
stopRecording: () => Promise; // Stop recording and return Blob
enableMicrophone: () => Promise; // Enable microphone
disableMicrophone: () => void; // Disable microphone
playPause: () => void; // Play/pause recorded audio
reset: () => void; // Reset recording state
resumeAudioContext: () => Promise; // Resume audio context (for iOS/Safari)

// References
audioRef: React.RefObject; // HTML Audio element reference
}
`

🛠️ Advanced Usage

$3

`tsx
const recorder = useVoiceRecorder({
mimeType: 'audio/mp4', // Use MP4 format
smoothing: 0.9, // Smoother audio level
fftSize: 4096, // More accurate analysis
autoEnableMicrophone: true, // Auto microphone activation
autoPlayAfterRecording: true, // Auto play after recording
});
`

$3

Individual hooks are also provided for advanced users:

`tsx
import {
useAudioContext,
useAudioMeter,
useAudioPlayer,
useMediaRecorder,
useMicrophone,
useRecordingTimer
} from 'react-voice-recorder-pro';

// Can be used individually
const { audioContext, isRunning, resume } = useAudioContext();
const { stream, isEnabled, enable, disable } = useMicrophone();
// ... other hooks
`

$3

`tsx
import {
getBestAudioFormat,
downloadBlob,
formatFileSize,
formatDuration,
isMediaRecorderSupported
} from 'react-voice-recorder-pro';

// Select optimal audio format
const bestFormat = getBestAudioFormat();

// Download file
downloadBlob(blob, 'my-recording.webm');

// Format file size
const size = formatFileSize(blob.size); // "1.2 MB"

// Format duration
const duration = formatDuration(120); // "2:00"

// Check browser support
if (isMediaRecorderSupported()) {
// MediaRecorder is available
}
`

📱 Mobile Support

$3

In iOS Safari, audio context must be activated after user gesture:

`tsx
const { resumeAudioContext } = useVoiceRecorder();

const handleUserInteraction = async () => {
await resumeAudioContext(); // Call after user gesture
// Now recording can be started
};
`

$3

Android Chrome requires no additional setup. It works well with default settings.

🌐 Browser Support

| Browser | Version | Support Status |
|---------|---------|----------------|
| Chrome | 80+ | ✅ Full Support |
| Firefox | 75+ | ✅ Full Support |
| Safari | 13+ | ✅ Full Support |
| Edge | 80+ | ✅ Full Support |
| iOS Safari | 13+ | ✅ Full Support |
| Android Chrome | 80+ | ✅ Full Support |

📦 Bundle Size

- gzipped: ~15KB
- minified: ~45KB
- Individual hooks: ~3-8KB each

🔧 Development and Build

$3

`bash


Clone repository

`bash
npm test
`

📖 Examples

For more examples, see the examples/ folder:

- Basic Usage
- Advanced Usage
- Voice Memo App

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork this repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature`)
5. Create a Pull Request

📄 License

This project is distributed under the MIT License. See the LICENSE file for details.

🐛 Bug Reports

Found a bug? Please report it on the Issues page.

💡 Feature Requests

Want to suggest a new feature? Please propose it on the Issues page with the "Feature Request" label.

🙏 Acknowledgments

This library was built with the help of the following open source projects:

- React
- Web Audio API
- MediaRecorder API

📞 Support

- 📧 Email: rkdalsgh0106@naver.com
---

Build amazing voice recording apps with React Voice Recorder Pro! 🎤✨