denar90/yii2-wavesurfer-audio-widget

yii2的音频小部件,基于wavesurfer.js。

v1.0 2015-08-14 09:10 UTC

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。