denar90 / yii2-wavesurfer-audio-widget
yii2的音频小部件,基于wavesurfer.js。
v1.0
2015-08-14 09:10 UTC
Requires
- npm-asset/wavesurfer.js: *
- yiisoft/yii2: *
This package is not auto-updated.
Last update: 2024-09-28 18:21:20 UTC
README
基于wavesurfer.js的yii2音频小部件
安装
安装此扩展的首选方式是通过composer。
- 运行以下命令之一
php composer.phar require --prefer-dist "denar90/yii2-wavesurfer-audio-widget": "dev-master"
或者将以下内容添加到您应用程序的composer.json
文件的require部分。
"denar90/yii2-wavesurfer-audio-widget": "dev-master"
使用
在您的视图中添加
use denar90\waveSurferAudio\WaveSurferAudioWidget;
在需要显示小部件的位置添加
echo WaveSurferAudioWidget::widget([ 'settings' => [ 'fileUrl' => url_to_your_mp3_file, 'init' => [ 'container' => 'selector_name' //it has to be id not class ], 'callbacks' => [ 'ready' => new \yii\web\JsExpression("function(event) { this.play(); }") ], 'controls' => [ 'play' => true, 'pause' => true ] ] ]);
选项
在init
数组中设置初始化选项。选项列表
在callbacks
数组中设置支持的javascript回调
error
– 发生错误时。回调将接收错误消息(字符串)。finish
– 播放结束后。loading
– 通过XHR或拖放加载时连续触发。mouseup
- 当鼠标按钮抬起时。pause
– 当音频暂停时。play
– 当播放开始时。ready
– 当音频加载、解码并绘制波形图时。scroll
- 当滚动条移动时。seek
– 在搜索时。
在controls
数组中设置支持的控件
playPause
- 如果暂停则播放,如果正在播放则暂停。play
- 从当前位置开始播放。可以使用可选的以秒为单位的start和end来设置要播放的音频范围。pause
- 停止播放。back
- 回退skipLength秒。forth
- 前进skipLength秒。toggleMute
- 切换音量开/关。toggleInteraction
- 切换鼠标交互。toggleScroll
- 切换scrollParent。