首頁

flashSound 是一個簡單的 jQuery plugin,使用瀏覽器的 flash plugin 播放 mp3 音效。

Demo

下載

目前版本 flashSound.zip version 2008-03-17


使用方式

  1. 下載 flashSound.zip,解壓縮後會得到 flashSound.swfjquery.flashSound.min.js 兩個檔案,
    把它們連同 mp3 聲音檔、另外下載的 jquery.js 一起放到主機上的同一個資料夾。
  2. 在網頁的 head 區段引入它們,例如:
    <script type="text/javascript" src="jquery-1.2.3.js"></script>
    <script type="text/javascript" src="jquery.flashSound.min.js"></script>
  3. 然後就能使用 jQuery.flashSound 發聲了,標準用法:
    $.flashSound( 'foo.mp3', {id: 'se1'} );     // 讀取聲音檔(還不會播放),並將物件命名為 se1
    $.flashSound.play('se1');                   // 播放
    $.flashSound.play('se1', true);             // 播放,但先停止前一個播放的聲音
    $.flashSound.stop('se1');                   // 停止播放
    $.flashSound.remove('se1');                 // 移除 flash 物件
    

    或者比較方便的用法:
    var se1 = $.flashSound( 'foo.mp3' );   // 讀取聲音檔
    se1.play();                            // 播放
    se1.play(true);                        // 播放,但先停止前一個播放的聲音
    se1.stop();                            // 停止播放
    se1.remove();                          // 移除 flash 物件
    // 請留意若在 se1 建立前呼叫 play, stop,會發生「物件沒有該方法」的錯誤。

    只有一種用法的功能:
    $.flashSound.enable();        // 全面啟用 flashSound
    $.flashSound.disable();       // 全面停用 flashSound

選項

$.flashSound({ id: var, swf: var }) 完整選項說明如下:

名稱預設值用途
idnull用於 flash OBJECT 元素的 DOM id。
swf'flashSound.swf' flashSound.swf 影片檔的位置。

例:可以用 $.flashSound.defaults = {swf:'path/flashSound.swf'}; 更改預設的影片位置。

附註

  • 內部使用 ActionScript 3.0 的 ExternalInterface 類別與 flashSound.swf 溝通。
  • 作者宣稱可以任意使用這個 plugin,不用擔心授權問題。
    若有疑慮歡迎來信 bootleq@gmail.com