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.

Importação
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.

Exemplo
<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

NomeTipoDescrição
statusRef<'idle' | 'recording' | 'paused' | 'ready' | 'playing'>Estado da captura; ligue à prop `state` do VAudioRecorder.
elapsedRef<number>Segundos da tomada atual.
durationRef<number>Duração do áudio salvo.
levelsRef<number[]>Amostras de amplitude 0–1 para a waveform.
blobRef<Blob | null>Arquivo gravado após `save`.
errorRef<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

AudioRecorderStatus
ts
export type AudioRecorderStatus = 'idle' | 'recording' | 'paused' | 'ready' | 'playing'
UseAudioRecorderOptions
ts
export interface UseAudioRecorderOptions {
  
  sampleRate?: number
  mimeType?: string
}
isAudioRecordingSupported

Indica se o ambiente atual expõe MediaRecorder e getUserMedia.

ts
isAudioRecordingSupported()
useAudioRecorder

Inicia a captura via getUserMedia + MediaRecorder e devolve estado reativo para o VAudioRecorder.

ts
useAudioRecorder(options: UseAudioRecorderOptions = {})

Fonte: src/composables/useAudioRecorder.ts