0.2.1 • Published 6 years ago

v-audio-player v0.2.1

Weekly downloads
5
License
MIT
Repository
-
Last release
6 years ago

v-audio-player

NPM version npm download jsdelivr license

A audio player vue component based on html5.

Demo

demo

Installation

npm i v-audio-player

Usage

<template>
  <div id="app">
    <v-audio-player :audio="audio" ref="audio"></v-audio-player>
  </div>
</template>

<script>
import VAudioPlayer from '../src/index.js'

export default {
  data () {
    return {
      audio: {
        name: 'Sometimes When We Touch',
        loop: true,
        url: 'https://fengxianqi.github.io/v-audio-player/dist/media/sometimes_when_we_touch.010fafb2.mp3'
      }
    }
  },
  components: {
    VAudioPlayer
  }
}
</script>

props

audio 属性下:

nameExplanationTypeDefault
url音频路径string
name音频名称string
autoplay是否自动播放booltrue
loop是否循环播放boolfalse

Events

暴露一些audio标签默认的常用事件

nameExplanation
play音频开始播放时触发
pause音频暂停时触发
loadstart音频开始加载时
progress音频正在加载时
canplay音频可以播放时
error音频加载失败或出现错误时
ended音频播放结束时触发

Events Example

<template>
  <v-audio-player :audio="audio" @play="onPlay" @ended="onEnded"></v-audio-player>
</template>
<script>
export default {
  data () {
    return {
      audio: {
        name: 'Sometimes When We Touch',
        url: 'https://fengxianqi.github.io/v-audio-player/dist/media/sometimes_when_we_touch.010fafb2.mp3'
      }
    }
  },
  methods: {
    onPlay (e) {
      console.log('onplay', e)
    },
    onEnded (e) {
      console.log('this audio play ended', e)
    }
  }
}
</script>

Methods

可以通过ref来调用音频的方法,如

<v-audio-player :audio="audio" ref="audio"></v-audio-player>
nameExplanation
this.$refs.audio.play()播放音频
this.$refs.audio.pause()暂停音频
this.$refs.audio.volume()获取或设置音频的音量,设置时的值范围是:0~1
this.$refs.audio.seek(seconds)跳到指定时间开始播放,单位:秒
this.$refs.audio.currentSrc()获取当前播放的音频url
this.$refs.audio.duration()获取当前音频的时长,单位:秒
this.$refs.audio.currentTime获取当前播放的时间,单位:秒
this.$refs.audio.audioReady获取当前音频是否已ready
this.$refs.audio.isPlaying获取当前音频是否正在播放
0.2.1

6 years ago

0.2.0

6 years ago

0.1.0

6 years ago