Guide
Comment utiliser Audio Recorder dans Capacitor
Tester sur l'appareil
Téléchargez l'application Capgo, puis scannez le QR code.
Utiliser @capgo/capacitor-audio-recorder
Le 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 |
Commence l'enregistrement audio via le microphone de l'appareil. |
pauseRecording |
Met en pause l'enregistrement en cours. Disponible uniquement sur Android (API 24+), iOS et Web. |
resumeRecording |
Reprend un enregistrement précédemment mis en pause. |
stopRecording |
Arrête l'enregistrement actuel et sauvegarde l'audio enregistré. |
cancelRecording |
Annule l'enregistrement actuel et supprime l'audio capturé. |
getRecordingStatus |
Récupère le statut de l'enregistrement en cours. |
getCurrentAmplitude |
Récupère l'amplitude d'entrée actuelle (niveau du micro) sous la forme d'un nombre normalisé dans la [0, 1] plage. |
checkPermissions |
Retourne l'état actuel des permissions pour l'accès au microphone. |
requestPermissions |
Demande l'autorisation d'accéder au microphone. |
Exemples
startRecording()
Commencez 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 le 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 actuel et sauvegardez l'audio enregistré.
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
const result = await CapacitorAudioRecorder.stopRecording();
console.log(result);
cancelRecording()
Annulez l'enregistrement actuel et supprimez l'audio capturé.
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.cancelRecording();
getRecordingStatus()
Récupérez le statut de l'enregistrement actuel.
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 version et de listener, 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 capacité native dans l'utilisation de @capgo/capacitor-video-player.