Guide
Comment utiliser Audio Recorder dans Capacitor
Utiliser @capgo/capacitor-audio-recorder
Contrat du plugin Capacitor pour l’enregistrement audio.
Installer
bun add @capgo/capacitor-audio-recorder
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.
Importer
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
Aperçu de API
| Méthode | Description |
|---|---|
startRecording |
Démarrez l'enregistrement audio via le micro de l'appareil. |
pauseRecording |
Mettez en pause l'enregistrement en cours. Disponible uniquement sur Android (API 24+), iOS et Web. |
resumeRecording |
Reprenez un enregistrement précédemment mis en pause. |
stopRecording |
Arrêtez l'enregistrement en cours et conservez l'audio enregistré. |
cancelRecording |
Annulez l'enregistrement en cours et supprimez l'audio capturé. |
getRecordingStatus |
Récupérez le statut de l'enregistrement en cours. |
getCurrentAmplitude |
Récupère l'amplitude d'entrée actuelle (niveau du microphone) sous la forme d'un nombre normalisé dans la [0, 1] plage. |
checkPermissions |
Renvoie l'état actuel des permissions pour l'accès au microphone. |
requestPermissions |
Demande la permission d'accéder au microphone. |
Exemples
startRecording()
Démarrez l'enregistrement audio via le micro de l'appareil.
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.startRecording();
pauseRecording()
Mettez en pause l'enregistrement en cours. Disponible uniquement sur Android (API 24+), iOS et Web.
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.pauseRecording();
resumeRecording()
Reprenez un enregistrement précédemment mis en pause.
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.resumeRecording();
stopRecording()
Arrêtez l'enregistrement en cours et conservez l'audio enregistré.
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
const result = await CapacitorAudioRecorder.stopRecording();
console.log(result);
cancelRecording()
Annulez l'enregistrement en cours et supprimez l'audio capturé.
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.cancelRecording();
getRecordingStatus()
Récupérez le statut de l'enregistrement en cours.
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
const result = await CapacitorAudioRecorder.getRecordingStatus();
console.log(result);
Le tableau ci-dessus liste les 9 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.
Écouter les événements
addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou CapacitorAudioRecorder.removeAllListeners() pour supprimer tous les listeners.
Référence complète
Continuer depuis « Utiliser @capgo/capacitor-audio-recorder »
Si vous utilisez Utiliser @capgo/capacitor-audio-recorder pour planifier le comportement des médias et de l'interface natifs, connectez-l’à @capgo/capacitor-audio-recorder pour les détails d'implémentation dans @capgo/capacitor-audio-recorder, Prise en main pour les détails d'implémentation dans Getting Started Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-live-activities, et Utiliser @capgo/capacitor-video-player pour la fonctionnalité native dans Utilisation de @capgo/capacitor-video-player.