Composables e utilitários
useAudioRecorder
Composable / módulo
Captura de microfone para o VAudioRecorder: status, tempo, níveis (0–1) e o `blob` gravado via MediaRecorder.
import { isAudioRecordingSupported, useAudioRecorder } from 'vueui-nova-kit'Uso
Ligue status à prop state do VAudioRecorder (começa em idle antes da primeira tomada). Trate permissão negada e navegadores sem MediaRecorder com isAudioRecordingSupported() e o error devolvido.
<script setup lang="ts">
import { VAudioRecorder, useAudioRecorder } from 'vueui-nova-kit'
const rec = useAudioRecorder()
</script>
<template>
<VAudioRecorder
v-if="rec.status.value !== 'idle'"
:state="rec.status.value"
:elapsed="rec.elapsed.value"
:duration="rec.duration.value"
:levels="rec.levels.value"
@pause="rec.pause"
@resume="rec.resume"
@save="rec.save"
@play="rec.play"
@stop="rec.stop"
@discard="rec.discard"
/>
</template>Retorno
| Nome | Tipo | Descrição |
|---|---|---|
status | Ref<'idle' | 'recording' | 'paused' | 'ready' | 'playing'> | Estado da captura; ligue à prop `state` do VAudioRecorder. |
elapsed | Ref<number> | Segundos da tomada atual. |
duration | Ref<number> | Duração do áudio salvo. |
levels | Ref<number[]> | Amostras de amplitude 0–1 para a waveform. |
blob | Ref<Blob | null> | Arquivo gravado após `save`. |
error | Ref<string | null> | Falha de permissão ou de suporte do navegador. |
Demo
Exemplo ao vivo usando o próprio composable ou módulo, com componentes da lib.
API
AudioRecorderStatusexport type AudioRecorderStatus = 'idle' | 'recording' | 'paused' | 'ready' | 'playing'UseAudioRecorderOptionsexport interface UseAudioRecorderOptions {
sampleRate?: number
mimeType?: string
}isAudioRecordingSupportedIndica se o ambiente atual expõe MediaRecorder e getUserMedia.
isAudioRecordingSupported()useAudioRecorderInicia a captura via getUserMedia + MediaRecorder e devolve estado reativo para o VAudioRecorder.
useAudioRecorder(options: UseAudioRecorderOptions = {}) Fonte: src/composables/useAudioRecorder.ts