VAudioRecorder
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.
<script setup lang="ts">
import { VAudioRecorder } from 'vueui-nova-kit'
</script>Uso
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
<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
<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
<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
<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
<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
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
state | VAudioRecorderState | "ready" | — |
elapsed | number | 0 | Seconds captured (recording/paused) or played (ready/playing). |
duration | number | 0 | Total take length in seconds; drives playback progress. |
levels | number[] | — | Waveform amplitudes between 0 and 1, oldest first. |
bars | number | 32 | Number of waveform slots. |
size | VAudioRecorderSize | "md" | — |
closable | boolean | true | Trailing close button. |
disabled | boolean | false | — |
ariaLabel | string | "Voice note" | — |
dataTestId | string | — | — |
Events
| Evento | Payload | Descriçã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