4個小時實現一個HTML5音樂播放器

技術點:ES6+Webpack+HTML5 Audio+Sass
這里,我們將一步步的學到如何從零去實現一個H5音樂播放器。
首先來看一下最終的實現效果:Demo鏈接 =>
界面:

skPlayer


接下來就步入正題:

  1. 要做一個音樂播放器就要非常了解在Web中音頻播放的方式,通常都采用HTML5的audio標簽
    關于audio標簽,它有大量的屬性、方法和事件,在這里我就做一個大致的介紹。
    屬性
    src:必需,音頻來源;
    controls:常見,設置后顯示瀏覽器默認的audio控制面板,不設置默認隱藏audio標簽;
    autoplay:常見,設置后自動播放音頻(移動端不支持);
    loop:常見,設置后音頻將循環播放;
    preload:常見,設置音頻預加載(移動端不支持);
    volume:少見,設置或返回音頻大小,值為0-1之間的一個浮點數(移動端不支持);
    muted:少見,設置或返回靜音狀態;
    duration:少見,返回音頻時長;
    currentTime:少見,設置或返回當前播放時間;
    paused:少見,返回當前播放狀態,是否暫停;
    buffered:少見,一個TimeRanges對象,包含已緩沖的時間段信息,即加載進度。該對象包含一個屬性length,返回一個從0開始的數表示當前緩沖了多少段音頻;還包含兩個方法,start()end(),分別需要傳入一個參數,即傳入音頻已加載的第幾段,從0開始。start()返回該段的起始時間,end()返回該段的終點時間。舉例:即傳入0,第一段的起始是0,終止時間是17,單位秒;
    屬性就介紹到這里,可能還有一些比較少用的屬性如:playbackRate等,在視頻播放中可能會用到,我就暫不講解。
    方法
    play():開始播放音頻;
    pause():暫停播放音頻;
    事件
    canplay:當前音頻可以開始播放(只加載了部分buffered,并未全部加載完成);
    canplaythrough:可以無停頓播放(即音頻全部加載完成);
    durationchange:音頻時長發生變化;
    ended:播放結束;
    error:發生錯誤;
    pause:播放暫停;
    play:播放開始;
    progress:音頻下載過程中觸發,事件觸發過程中可以通過訪問audiobuffered屬性獲取加載進度;
    seeking:音頻跳躍中觸發,即為修改currentTime時;
    seeked:音頻跳躍完成時觸發,即為修改完成currentTime時;
    timeupdate:音頻播放過程中觸發,同時currentTime屬性在同步更新;
    事件就介紹到這里,可能還有一些不常用的事件暫不講解。
    最后再講解一下 一個音頻從開始加載到播放結束過程中,所觸發的事件流以及我們在不同時間段可以操作的屬性
    loadstart:開始加載;
    durationchange:獲取到音頻時長(此時可以獲取duration屬性);
    progress:音頻下載中(將伴隨下載過程一直觸發,此時可以獲取buffered屬性);
    canplay:所加載的音頻足夠開始播放(每次暫停后開始播放也會觸發);
    canplaythrough:音頻全部加載完成;
    timeupdate:播放過程中(currentTime屬性伴隨著同步更新);
    seeking:修改當前播放進度中(即為修改currentTime屬性);
    seeked:修改當前播放進度完成;
    ended:播放完成;
    這就是整個音頻的大致事件流,可能有一些少用的事件沒有列舉出。
    在事件觸發過程中,有一些屬性在音頻還沒有開始加載的時候就可以設置,如:controlsloopvolume等等;

  2. 因為自己是做成插件的方式發布在npm上供他人使用的,所以我們就采用面向對象的方式進行代碼編寫,又因為用戶的需求不一,所以在設計之初就暴露出大量的API和配置項以滿足大部分用戶的需求。
    這里因為自己更習慣es6的語法,就全程以es6為基礎進行開發,同時為了開發效率,又使用了sass進行css的編寫,最后還使用了webpackwebpack-dev-server用以編譯es6sass,項目打包,構建本地服務器。

  3. 確定播放器UI和交互:
    可能關于界面每個人有自己的想法,這里就不過多贅述了,以我做好的播放器UI為例進行分解

    skPlayer

    從界面中可以看出一個播放器所需要的最基礎功能
    播放/暫停、封面/歌名/歌手的顯示、播放進度條/加載進度條/進度操作功能、循環模式切換、進度文字更新/歌曲時長、靜音/音量大小控制、列表顯示狀態控制、點擊列表項切歌功能
    再結合我們想要滿足用戶需求,提供配置項和API的出發點可以得出我們想設計的配置項和暴露的API項:
    配置項:自動播放是否開啟、默認歌曲列表的顯示狀態、默認循環模式的設置
    API:播放/暫停/toggle、循環模式的切換、靜音/恢復、列表顯示狀態的切換、上一曲/下一曲/切歌、銷毀當前實例

  4. 確立項目結構,開始編碼:
    因為使用webpack,所以我們直接將css打包至js內,以便作為插件供用戶使用:

require('./skPlayer.scss');

抽離公共方法,在播放器中有很多可能需要抽離的公共方法如:點擊播放進度條和音量進度條時需要計算鼠標距離進度條左端的距離以進行進度跳轉,時間從duration中獲取到的以秒為單位的時間轉換成標準時間格式等等:

const Util = {
    leftDistance: (el) => {
        let left = el.offsetLeft;
        let scrollLeft;
        while (el.offsetParent) {
            el = el.offsetParent;
            left += el.offsetLeft;
        }
        scrollLeft = document.body.scrollLeft + document.documentElement.scrollLeft;
        return left - scrollLeft;
    },
    timeFormat: (time) => {
        let tempMin = parseInt(time / 60);
        let tempSec = parseInt(time % 60);
        let curMin = tempMin < 10 ? ('0' + tempMin) : tempMin;
        let curSec = tempSec < 10 ? ('0' + tempSec) : tempSec;
        return curMin + ':' + curSec;
    },
    percentFormat: (percent) => {
        return (percent * 100).toFixed(2) + '%';
    },
    ajax: (option) => {
        option.beforeSend && option.beforeSend();
        let xhr = new XMLHttpRequest();
        xhr.onreadystatechange = () => {
            if(xhr.readyState === 4){
                if(xhr.status >= 200 && xhr.status < 300){
                    option.success && option.success(xhr.responseText);
                }else{
                    option.fail && option.fail(xhr.status);
                }
            }
        };
        xhr.open('GET',option.url);
        xhr.send(null);
    }
};

由于設計之初,考慮到播放器的獨特性,設計為只能存在一個實例,設置了一個全局變量以判斷當前是否存在實例:
(實例判斷,如果存在返回無原型的空對象,因為ES6構造函數內默認返回帶原型的實例)

let instance = false;
if(instance){
    console.error('SKPlayer只能存在一個實例!');
    return Object.create(null);
}else{
    instance = true;
}

在使用ES6的情況下,我們將主邏輯放在構造函數內部,將通用性強和API放在公共函數內部:

class skPlayer {
    constructor(option){}
    template(){}
    init(){}
    bind(){}
    prev(){}
    next(){}
    switchMusic(index){}
    play(){}
    pause(){}
    toggle(){}
    toggleList(){}
    toggleMute(){}
    switchMode(){}
    destroy(){}
}

初始化配置項,默認配置與用戶配置合并:

const defaultOption = {
     ... 
};
this.option = Object.assign({},defaultOption,option);

將常用屬性綁定在實例上:

this.root = this.option.element;
this.type = this.option.music.type;
this.music = this.option.music.source;
this.isMobile = /mobile/i.test(window.navigator.userAgent);

一些公共的API內部this指向在默認情況下指向實例,但是為了減少代碼量,將操作界面上的功能與API調用一套代碼,在綁定事件的時候this指向會改變,所以通過bind的方式綁定this,當然也可以在綁定事件的時候使用箭頭函數

this.toggle = this.toggle.bind(this);
this.toggleList = this.toggleList.bind(this);
this.toggleMute = this.toggleMute.bind(this);
this.switchMode = this.switchMode.bind(this);

接下來,我們就使用ES6字符串模板開始生成HTML,插入到頁面中:

this.root.innerHTML = this.template();

接下來初始化,初始化過程中將常用DOM節點綁定,初始化配置項,初始化操作界面:

this.init();
    init(){
        this.dom = {
            cover: this.root.querySelector('.skPlayer-cover'),
            playbutton: this.root.querySelector('.skPlayer-play-btn'),
            name: this.root.querySelector('.skPlayer-name'),
            author: this.root.querySelector('.skPlayer-author'),
            timeline_total: this.root.querySelector('.skPlayer-percent'),
            timeline_loaded: this.root.querySelector('.skPlayer-line-loading'),
            timeline_played: this.root.querySelector('.skPlayer-percent .skPlayer-line'),
            timetext_total: this.root.querySelector('.skPlayer-total'),
            timetext_played: this.root.querySelector('.skPlayer-cur'),
            volumebutton: this.root.querySelector('.skPlayer-icon'),
            volumeline_total: this.root.querySelector('.skPlayer-volume .skPlayer-percent'),
            volumeline_value: this.root.querySelector('.skPlayer-volume .skPlayer-line'),
            switchbutton: this.root.querySelector('.skPlayer-list-switch'),
            modebutton: this.root.querySelector('.skPlayer-mode'),
            musiclist: this.root.querySelector('.skPlayer-list'),
            musicitem: this.root.querySelectorAll('.skPlayer-list li')
        };
        this.audio = this.root.querySelector('.skPlayer-source');
        if(this.option.listshow){
            this.root.className = 'skPlayer-list-on';
        }
        if(this.option.mode === 'singleloop'){
            this.audio.loop = true;
        }
        this.dom.musicitem[0].className = 'skPlayer-curMusic';
         ... 
    }

事件綁定,主要綁定audio的事件以及操作面板的事件:

this.bind();
    bind(){
        this.updateLine = () => {
            let percent = this.audio.buffered.length ? (this.audio.buffered.end(this.audio.buffered.length - 1) / this.audio.duration) : 0;
            this.dom.timeline_loaded.style.width = Util.percentFormat(percent);
        };

        // this.audio.addEventListener('load', (e) => {
        //     if(this.option.autoplay && this.isMobile){
        //         this.play();
        //     }
        // });
        this.audio.addEventListener('durationchange', (e) => {
            this.dom.timetext_total.innerHTML = Util.timeFormat(this.audio.duration);
            this.updateLine();
        });
        this.audio.addEventListener('progress', (e) => {
            this.updateLine();
        });
        this.audio.addEventListener('canplay', (e) => {
            if(this.option.autoplay && !this.isMobile){
                this.play();
            }
        });
        this.audio.addEventListener('timeupdate', (e) => {
            let percent = this.audio.currentTime / this.audio.duration;
            this.dom.timeline_played.style.width = Util.percentFormat(percent);
            this.dom.timetext_played.innerHTML = Util.timeFormat(this.audio.currentTime);
        });
        //this.audio.addEventListener('seeked', (e) => {
        //    this.play();
        //});
        this.audio.addEventListener('ended', (e) => {
            this.next();
        });

        this.dom.playbutton.addEventListener('click', this.toggle);
        this.dom.switchbutton.addEventListener('click', this.toggleList);
        if(!this.isMobile){
            this.dom.volumebutton.addEventListener('click', this.toggleMute);
        }
        this.dom.modebutton.addEventListener('click', this.switchMode);
        this.dom.musiclist.addEventListener('click', (e) => {
            let target,index,curIndex;
            if(e.target.tagName.toUpperCase() === 'LI'){
                target = e.target;
            }else{
                target = e.target.parentElement;
            }
            index = parseInt(target.getAttribute('data-index'));
            curIndex = parseInt(this.dom.musiclist.querySelector('.skPlayer-curMusic').getAttribute('data-index'));
            if(index === curIndex){
                this.play();
            }else{
                this.switchMusic(index + 1);
            }
        });
        this.dom.timeline_total.addEventListener('click', (event) => {
            let e = event || window.event;
            let percent = (e.clientX - Util.leftDistance(this.dom.timeline_total)) / this.dom.timeline_total.clientWidth;
            if(!isNaN(this.audio.duration)){
                this.dom.timeline_played.style.width = Util.percentFormat(percent);
                this.dom.timetext_played.innerHTML = Util.timeFormat(percent * this.audio.duration);
                this.audio.currentTime = percent * this.audio.duration;
            }
        });
        if(!this.isMobile){
            this.dom.volumeline_total.addEventListener('click', (event) => {
                let e = event || window.event;
                let percent = (e.clientX - Util.leftDistance(this.dom.volumeline_total)) / this.dom.volumeline_total.clientWidth;
                this.dom.volumeline_value.style.width = Util.percentFormat(percent);
                this.audio.volume = percent;
                if(this.audio.muted){
                    this.toggleMute();
                }
            });
        }
    }

最后我們暴露模塊:

module.exports = skPlayer;

至此,核心代碼基本完成,接下來就是自己根據需要完成API部分,詳細部分移步至我的github查看源碼。
一個HTML5音樂播放器就大功告成了 ~ !

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,882評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,208評論 3 414
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,746評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,666評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,477評論 6 407
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,960評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,047評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,200評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,726評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,617評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,807評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,327評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,049評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,425評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,674評論 1 281
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,432評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,769評論 2 372

推薦閱讀更多精彩內容