Plugin Marketplace

nativephp/mobile-microphone

Microphone recording plugin for NativePHP Mobile - audio recording with pause/resume support

#Microphone Plugin for NativePHP Mobile

Audio recording plugin for NativePHP Mobile with pause/resume support, background recording, and native permission handling.

#Overview

The Microphone API provides access to the device's microphone for recording audio. It offers a fluent interface for starting and managing recordings, tracking them with unique identifiers, and responding to completion events.

#Installation

Copied!
composer require nativephp/mobile-microphone

#Usage

#PHP (Livewire/Blade)

Copied!
use Native\Mobile\Facades\Microphone;
 
// Start recording
Microphone::record()->start();
 
// Stop recording
Microphone::stop();
 
// Pause recording
Microphone::pause();
 
// Resume recording
Microphone::resume();
 
// Get status
$status = Microphone::getStatus();
// Returns: "idle", "recording", or "paused"
 
// Get last recording path
$path = Microphone::getRecording();

#JavaScript (Vue/React/Inertia)

Copied!
import { microphone, on, off, Events } from '#nativephp';
 
// Basic recording
await microphone.record();
 
// With identifier for tracking
await microphone.record()
    .id('voice-memo');
 
// Stop recording
await microphone.stop();
 
// Pause/resume
await microphone.pause();
await microphone.resume();
 
// Get status
const result = await microphone.getStatus();
if (result.status === 'recording') {
    // Recording in progress
}
 
// Get last recording
const result = await microphone.getRecording();
if (result.path) {
    // Process the recording
}

#PendingMicrophone API

#id(string $id)

Set a unique identifier for this recording.

Copied!
Microphone::record()
    ->id('voice-note-123')
    ->start();

#event(string $eventClass)

Set a custom event class to dispatch when recording completes.

Copied!
use App\Events\VoiceMessageRecorded;
 
Microphone::record()
    ->event(VoiceMessageRecorded::class)
    ->start();

#remember()

Store the recorder's ID in the session for later retrieval.

Copied!
Microphone::record()
    ->id('voice-note')
    ->remember()
    ->start();

#start()

Explicitly start the audio recording. Returns true if recording started successfully.

#Events

#MicrophoneRecorded

Dispatched when an audio recording completes.

Payload:

  • string $path - File path to the recorded audio
  • string $mimeType - MIME type of the audio (default: 'audio/m4a')
  • ?string $id - The recorder's ID, if one was set

PHP

Copied!
use Native\Mobile\Attributes\OnNative;
use Native\Mobile\Events\Microphone\MicrophoneRecorded;
 
#[OnNative(MicrophoneRecorded::class)]
public function handleAudioRecorded(string $path, string $mimeType, ?string $id)
{
    $this->recordings[] = [
        'path' => $path,
        'mimeType' => $mimeType,
        'id' => $id,
    ];
}

Vue

Copied!
import { on, off, Events } from '#nativephp';
import { ref, onMounted, onUnmounted } from 'vue';
 
const recordings = ref([]);
 
const handleAudioRecorded = (payload) => {
    const { path, mimeType, id } = payload;
    recordings.value.push({ path, mimeType, id });
};
 
onMounted(() => {
    on(Events.Microphone.MicrophoneRecorded, handleAudioRecorded);
});
 
onUnmounted(() => {
    off(Events.Microphone.MicrophoneRecorded, handleAudioRecorded);
});

React

Copied!
import { on, off, Events } from '#nativephp';
import { useState, useEffect } from 'react';
 
const [recordings, setRecordings] = useState([]);
 
const handleAudioRecorded = (payload) => {
    const { path, mimeType, id } = payload;
    setRecordings(prev => [...prev, { path, mimeType, id }]);
};
 
useEffect(() => {
    on(Events.Microphone.MicrophoneRecorded, handleAudioRecorded);
 
    return () => {
        off(Events.Microphone.MicrophoneRecorded, handleAudioRecorded);
    };
}, []);

#Notes

  • Microphone Permission: The first time your app requests microphone access, users will be prompted for permission. If denied, recording functions will fail silently.

  • Background Recording: You can allow your app to record audio while the device is locked by toggling microphone_background to true in the config.

  • File Format: Recordings are stored as M4A/AAC audio files (.m4a). This format is optimized for small file sizes while maintaining quality.

  • Recording State: Only one recording can be active at a time. Calling start() while a recording is in progress will return false.

  • Auto-Start Behavior: If you don't explicitly call start(), the recording will automatically start when the PendingMicrophone is destroyed.