IA

VAudioRecorder

Componente5 exemplos10 props

Barra de nota de voz (gravar, pausar, salvar, ouvir, descartar) com waveform. É **controlada**: emite `pause`, `resume`, `save`, `play`, `stop`, `discard`, `close`. Use o composable `useAudioRecorder()` para captura real via MediaRecorder.

Importação
<script setup lang="ts">
import { VAudioRecorder } from 'vueui-nova-kit'
</script>

Uso

Exemplo
const rec = useAudioRecorder()
<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" />

Playground

Os controles abaixo são gerados a partir das props declaradas em VAudioRecorder.types.ts; o código acompanha cada mudança.

Exemplos

Variantes, tamanhos e estados, extraídos das stories da biblioteca.

Default

Variação Pronto para ouvir (0:00 + play).

Ver código
vue
<script setup lang="ts">
import { VAudioRecorder } from 'vueui-nova-kit'

const levels = [
  0.25,
  0.38888546368728943,
  0.5631957293930188,
  0.6857724267241416,
  0.6727281197113857,
  0.48226797516327613,
  0.3595205819337412,
  0.36711252467173017,
  0.5028542653477857,
  0.5915545072469255,
  0.5584219137493427,
  0.3708206721679675,
  0.4395951726524276,
  0.779233929839494,
  0.42787028209786004,
  0.49514911872073897,
  0.45555661350196197,
  0.2826581955131387,
  0.4892259101739538,
  0.7702247666218098,
  0.944278914833774,
  0.4030365250755459,
  0.3694777548620508,
  0.2793555094611609,
  0.5088207078577296,
  0.7341565343827968,
  0.850521223972836,
  0.7752355795680616,
  0.3045613042142261,
  0.3136865294605323,
  0.5001417060325775,
  0.675754599578066,
  0.7461101231971905,
  0.6418457383323425,
  0.3534478950652842,
  0.3201689189043481,
  0.46620473596617373,
  0.6005592429632202,
  0.6378145768283698,
  0.5193345871862819,
  0.25538665393958865,
  0.6181191112033947,
  0.41113372620754274,
  0.514684816687039,
  0.5322870125238748,
  0.41325744994848296,
  0.3370452589922861,
  0.65002697819959,
  0.9125465084620731,
  0.42456068125030905,
  0.43579806555406814,
  0.3281777404715173,
  0.3898594690522351,
  0.6515387627485288,
  0.8521735678091887,
  0.8881552791184826,
  0.3539887080002312,
  0.26750493565561834,
  0.4135508074047426,
  0.6256757483679617,
]
</script>

<template>
  <VAudioRecorder :duration="24" :levels="levels" />
</template>

Recording

Variação Gravando com waveform animado (simulado).

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VAudioRecorder } from 'vueui-nova-kit'

const args = {
  state: 'ready',
  elapsed: 0,
  duration: 24,
  levels: [
    0.25,
    0.38888546368728943,
    0.5631957293930188,
    0.6857724267241416,
    0.6727281197113857,
    0.48226797516327613,
    0.3595205819337412,
    0.36711252467173017,
    0.5028542653477857,
    0.5915545072469255,
    0.5584219137493427,
    0.3708206721679675,
    0.4395951726524276,
    0.779233929839494,
    0.42787028209786004,
    0.49514911872073897,
    0.45555661350196197,
    0.2826581955131387,
    0.4892259101739538,
    0.7702247666218098,
    0.944278914833774,
    0.4030365250755459,
    0.3694777548620508,
    0.2793555094611609,
    0.5088207078577296,
    0.7341565343827968,
    0.850521223972836,
    0.7752355795680616,
    0.3045613042142261,
    0.3136865294605323,
    0.5001417060325775,
    0.675754599578066,
    0.7461101231971905,
    0.6418457383323425,
    0.3534478950652842,
    0.3201689189043481,
    0.46620473596617373,
    0.6005592429632202,
    0.6378145768283698,
    0.5193345871862819,
    0.25538665393958865,
    0.6181191112033947,
    0.41113372620754274,
    0.514684816687039,
    0.5322870125238748,
    0.41325744994848296,
    0.3370452589922861,
    0.65002697819959,
    0.9125465084620731,
    0.42456068125030905,
    0.43579806555406814,
    0.3281777404715173,
    0.3898594690522351,
    0.6515387627485288,
    0.8521735678091887,
    0.8881552791184826,
    0.3539887080002312,
    0.26750493565561834,
    0.4135508074047426,
    0.6256757483679617
  ],
  bars: 32,
  size: 'md',
  closable: true,
  disabled: false
}
const levels = ref([])
const elapsed = ref(0)
const state = ref('recording')
</script>

<template>
  <VAudioRecorder v-bind="args" :state="state" :levels="levels" :elapsed="elapsed"
        @pause="state = 'paused'" @resume="state = 'recording'" @discard="levels = []; elapsed = 0" />
</template>

Paused

Variação Pausado.

Ver código
vue
<script setup lang="ts">
import { VAudioRecorder } from 'vueui-nova-kit'

const levels = [
  0.25,
  0.38888546368728943,
  0.5631957293930188,
  0.6857724267241416,
  0.6727281197113857,
  0.48226797516327613,
  0.3595205819337412,
  0.36711252467173017,
  0.5028542653477857,
  0.5915545072469255,
  0.5584219137493427,
  0.3708206721679675,
  0.4395951726524276,
  0.779233929839494,
  0.42787028209786004,
  0.49514911872073897,
  0.45555661350196197,
  0.2826581955131387,
  0.4892259101739538,
  0.7702247666218098,
]
</script>

<template>
  <VAudioRecorder
    state="paused"
    :elapsed="4"
    :duration="24"
    :levels="levels" />
</template>

Playing

Variação Reproduzindo a 40%.

Ver código
vue
<script setup lang="ts">
import { VAudioRecorder } from 'vueui-nova-kit'

const levels = [
  0.25,
  0.38888546368728943,
  0.5631957293930188,
  0.6857724267241416,
  0.6727281197113857,
  0.48226797516327613,
  0.3595205819337412,
  0.36711252467173017,
  0.5028542653477857,
  0.5915545072469255,
  0.5584219137493427,
  0.3708206721679675,
  0.4395951726524276,
  0.779233929839494,
  0.42787028209786004,
  0.49514911872073897,
  0.45555661350196197,
  0.2826581955131387,
  0.4892259101739538,
  0.7702247666218098,
  0.944278914833774,
  0.4030365250755459,
  0.3694777548620508,
  0.2793555094611609,
  0.5088207078577296,
  0.7341565343827968,
  0.850521223972836,
  0.7752355795680616,
  0.3045613042142261,
  0.3136865294605323,
  0.5001417060325775,
  0.675754599578066,
  0.7461101231971905,
  0.6418457383323425,
  0.3534478950652842,
  0.3201689189043481,
  0.46620473596617373,
  0.6005592429632202,
  0.6378145768283698,
  0.5193345871862819,
  0.25538665393958865,
  0.6181191112033947,
  0.41113372620754274,
  0.514684816687039,
  0.5322870125238748,
  0.41325744994848296,
  0.3370452589922861,
  0.65002697819959,
  0.9125465084620731,
  0.42456068125030905,
  0.43579806555406814,
  0.3281777404715173,
  0.3898594690522351,
  0.6515387627485288,
  0.8521735678091887,
  0.8881552791184826,
  0.3539887080002312,
  0.26750493565561834,
  0.4135508074047426,
  0.6256757483679617,
]
</script>

<template>
  <VAudioRecorder
    state="playing"
    :elapsed="9.6"
    :duration="24"
    :levels="levels" />
</template>

Live Microphone

Variação Microfone real com useAudioRecorder() (pede permissão de microfone).

Ver código
vue
<script setup lang="ts">
import { VAudioRecorder } from 'vueui-nova-kit'

const levels = [
  0.25,
  0.38888546368728943,
  0.5631957293930188,
  0.6857724267241416,
  0.6727281197113857,
  0.48226797516327613,
  0.3595205819337412,
  0.36711252467173017,
  0.5028542653477857,
  0.5915545072469255,
  0.5584219137493427,
  0.3708206721679675,
  0.4395951726524276,
  0.779233929839494,
  0.42787028209786004,
  0.49514911872073897,
  0.45555661350196197,
  0.2826581955131387,
  0.4892259101739538,
  0.7702247666218098,
  0.944278914833774,
  0.4030365250755459,
  0.3694777548620508,
  0.2793555094611609,
  0.5088207078577296,
  0.7341565343827968,
  0.850521223972836,
  0.7752355795680616,
  0.3045613042142261,
  0.3136865294605323,
  0.5001417060325775,
  0.675754599578066,
  0.7461101231971905,
  0.6418457383323425,
  0.3534478950652842,
  0.3201689189043481,
  0.46620473596617373,
  0.6005592429632202,
  0.6378145768283698,
  0.5193345871862819,
  0.25538665393958865,
  0.6181191112033947,
  0.41113372620754274,
  0.514684816687039,
  0.5322870125238748,
  0.41325744994848296,
  0.3370452589922861,
  0.65002697819959,
  0.9125465084620731,
  0.42456068125030905,
  0.43579806555406814,
  0.3281777404715173,
  0.3898594690522351,
  0.6515387627485288,
  0.8521735678091887,
  0.8881552791184826,
  0.3539887080002312,
  0.26750493565561834,
  0.4135508074047426,
  0.6256757483679617,
]
</script>

<template>
  <VAudioRecorder :duration="24" :levels="levels" />
</template>

Props

PropTipoDefaultDescrição
stateVAudioRecorderState"ready"—
elapsednumber0Seconds captured (recording/paused) or played (ready/playing).
durationnumber0Total take length in seconds; drives playback progress.
levelsnumber[]—Waveform amplitudes between 0 and 1, oldest first.
barsnumber32Number of waveform slots.
sizeVAudioRecorderSize"md"—
closablebooleantrueTrailing close button.
disabledbooleanfalse—
ariaLabelstring"Voice note"—
dataTestIdstring——

Events

EventoPayloadDescrição
@discard——
@pause——
@resume——
@save——
@play——
@stop——
@close——

Slots

Sem slots.

Fonte: src/components/form/VAudioRecorder/VAudioRecorder.vue · tipos: src/components/form/VAudioRecorder/VAudioRecorder.types.ts