前言
前段時(shí)間基于vue寫(xiě)了一個(gè)自定義的video播放器組件,踩了一些小坑, 這里做一下復(fù)盤分享出來(lái),避免日后重復(fù)踩坑...
設(shè)計(jì)階段
這里就直接放幾張完成后的播放狀態(tài)圖吧,界面布局基本就是flex+vw適配一把梭,也比較容易.
需要實(shí)現(xiàn)的幾個(gè)功能基本都標(biāo)注出來(lái)了; 除了還有一個(gè)視頻加載失敗的...下面就這屆上代碼了;剛開(kāi)始構(gòu)思的時(shí)候考慮了一下功能的實(shí)現(xiàn)方式: 一是用原生的DOM操作,獲取video元素后,用addEventListener來(lái)監(jiān)聽(tīng); 二是用vue的方式綁定事件監(jiān)聽(tīng); 最后圖方便采用了兩者結(jié)合的方式,但是總感覺(jué)有點(diǎn)亂, 打算后期再做一下代碼格式優(yōu)化.
video組件實(shí)現(xiàn)過(guò)程
組件模板部分
主要是播放器的幾種播放狀態(tài)的邏輯理清楚就好了, 即: 播放中,緩存中,暫停,加載失敗這幾種情況,下面按功能分別說(shuō)一下
<template> <div class="video-player"> <!-- 播放器界面; 兼容ios controls--> <video ref="video" v-if="showVideo" webkit-playsinline="true" playsinline="true" x-webkit-airplay="true" x5-video-player-type="h5" x5-video-player-fullscreen="true" x5-video-orientation="portraint" style="object-fit:fill" preload="auto" muted="true" poster="https://photo.mac69.com/180205/18020526/a9yPQozt0g.jpg" :src="src" @waiting="handleWaiting" @canplaythrough="state.isLoading = false" @playing="state.isLoading = false, state.controlBtnShow = false, state.playing=true" @stalled="state.isLoading = true" @error="handleError" >您的瀏覽器不支持HTML5</video> <!-- 兼容Android端層級(jí)問(wèn)題, 彈出層被覆蓋 --> <img v-show="!showVideo || state.isEnd" class="poster" src="https://photo.mac69.com/180205/18020526/a9yPQozt0g.jpg" alt > <!-- 控制窗口 --> <div class="control" v-show="!state.isError" ref="control" @touchstart="touchEnterVideo" @touchend="touchLeaveVideo" > <!-- 播放 || 暫停 || 加載中--> <div class="play" @touchstart.stop="clickPlayBtn" v-show="state.controlBtnShow"> <img v-show="!state.playing && !state.isLoading" src="../../assets/video/content_btn_play.svg" > <img v-show="state.playing && !state.isLoading" src="../../assets/video/content_btn_pause.svg" > <div class="loader" v-show="state.isLoading"> <div class="loader-inner ball-clip-rotate"> <div></div> </div> </div> </div> <!-- 控制條 --> <div class="control-bar" :style="{ visibility: state.controlBarShow ? 'visible' : 'hidden'}"> <span class="time">{{video.displayTime}}</span> <span class="progress" ref="progress"> <img class="progress-btn ignore" :style="{transform: `translate3d(${video.progress.current}px, 0, 0)`}" src="../../assets/video/content_ic_tutu.svg" > <span class="progress-loaded" :style="{ width: `${video.loaded}%`}"></span> <!-- 設(shè)置手動(dòng)移動(dòng)的進(jìn)度條 --> <span class="progress-move" @touchmove.stop.prevent="moveIng($event)" @touchstart.stop="moveStart($event)" @touchend.stop="moveEnd($event)" ></span> </span> <span class="total-time">{{video.totalTime}}</span> <span class="full-screen" @click="fullScreen"> <img src="../../assets/video/content_ic_increase.svg" alt> </span> </div> </div> <!-- 錯(cuò)誤彈窗 --> <div class="error" v-show="state.isError"> <p class="lose">視頻加載失敗</p> <p class="retry" @click="retry">點(diǎn)擊重試</p> </div> </div></template>播放器初始化
這里有個(gè)坑點(diǎn)我就是當(dāng)父元素隱藏即display:none時(shí),getBoundingClientRect()是獲取不到元素的尺寸數(shù)值的,后來(lái)查了MDN文檔,按上面說(shuō)的改了一下border也沒(méi)有用,最后嘗試設(shè)置元素visibility屬性為hidden后發(fā)現(xiàn)就可以獲取了.
getBoundingClientRect() : 返回元素的大小及其相對(duì)于視口的位置, 這個(gè)api在計(jì)算元素相對(duì)位置的時(shí)候挺好用的.
init() { // 初始化video,獲取video元素 this.$video = this.$el.getElementsByTagName("video")[0]; this.initPlayer(); }, // 初始化播放器容器, 獲取video-player元素 // getBoundingClientRect()以client可視區(qū)的左上角為基點(diǎn)進(jìn)行位置計(jì)算 initPlayer() { const $player = this.$el; const $progress = this.$el.getElementsByClassName("progress")[0]; // 播放器位置 this.player.$player = $player; this.progressBar.$progress = $progress; this.player.pos = $player.getBoundingClientRect(); this.progressBar.pos = $progress.getBoundingClientRect() this.video.progress.width = Math.round($progress.getBoundingClientRect().width); },播放 && 暫停點(diǎn)擊
我這里把事件監(jiān)聽(tīng)都放在只有滿足正在播放視頻才開(kāi)始事件監(jiān)聽(tīng); 感覺(jué)原生監(jiān)聽(tīng)和vue方式的監(jiān)聽(tīng)混合在一起寫(xiě)有點(diǎn)別扭...emem...這里需要對(duì)this.$video.play()做一個(gè)異常處理,防止video剛開(kāi)始加載的時(shí)候失敗,如果視頻鏈接出錯(cuò),play方法調(diào)用不了會(huì)拋錯(cuò),后面我也用了video的error事件去監(jiān)聽(tīng)播放時(shí)的錯(cuò)誤
// 點(diǎn)擊播放 & 暫停按鈕 clickPlayBtn() { if (this.state.isLoading) return; this.isFirstTouch = false; this.state.playing = !this.state.playing; this.state.isEnd = false; if (this.$video) { // 播放狀態(tài) if (this.state.playing) { try { this.$video.play(); this.isPauseTouch = false; // 監(jiān)聽(tīng)緩存進(jìn)度 this.$video.addEventListener("progress", e => { this.getLoadTime(); }); // 監(jiān)聽(tīng)播放進(jìn)度 this.$video.addEventListener( "timeupdate", throttle(this.getPlayTime, 100, 1) ); // 監(jiān)聽(tīng)結(jié)束 this.$video.addEventListener("ended", e => { // 重置狀態(tài) this.state.playing = false; this.state.isEnd = true; this.state.controlBtnShow = true; this.video.displayTime = "00:00"; this.video.progress.current = 0; this.$video.currentTime = 0; }); } catch (e) { // 捕獲url異常出現(xiàn)的錯(cuò)誤 } } // 停止?fàn)顟B(tài) else { this.isPauseTouch = true; this.$video.pause(); } } },視頻控制條顯示和隱藏
這里需要加兩個(gè)開(kāi)關(guān); 首次觸屏和暫停觸屏; 做一下顯示處理即可
// 觸碰播放區(qū) touchEnterVideo() { if (this.isFirstTouch) return; if (this.hideTimer) { clearTimeout(this.hideTimer); this.hideTimer = null; } this.state.controlBtnShow = true; this.state.controlBarShow = true; }, // 離開(kāi)播放區(qū) touchLeaveVideo() { if (this.isFirstTouch) return; if (this.hideTimer) { clearTimeout(this.hideTimer); } // 暫停觸摸, 不隱藏 if (this.isPauseTouch) { this.state.controlBtnShow = true; this.state.controlBarShow = true; } else { this.hideTimer = setTimeout(() => { this.state.controlBarShow = false; // 加載中只顯示loading if (this.state.isLoading) { this.state.controlBtnShow = true; } else { this.state.controlBtnShow = false; } this.hideTimer = null; }, 3000); } },視頻錯(cuò)誤處理和等待處理
這里錯(cuò)誤直接用error事件, 加載中用stalled事件來(lái)監(jiān)聽(tīng)視頻阻塞狀態(tài),等待數(shù)據(jù)加載用的waiting事件; 顯示對(duì)應(yīng)的loading動(dòng)畫(huà)即可
// loading動(dòng)畫(huà)@keyframes rotate { 0% { transform: rotate(0deg); } 50% { transform: rotate(180deg); } 100% { transform: rotate(360deg); }}.loader { width: 58px; height: 58px; background: rgba(15, 16, 17, 0.3); border-radius: 50%; position: relative; .ball-clip-rotate { position: absolute; left: 50%; top: 50%; transform: translate(-50%, -50%); > div { width: 15px; height: 15px; border-radius: 100%; margin: 2px; animation-fill-mode: both; border: 2px solid #fff; border-bottom-color: transparent; height: 26px; width: 26px; background: transparent; display: inline-block; animation: rotate 0.75s 0s linear infinite; } }}播放時(shí)間設(shè)置
基本就是video對(duì)象的currentTime和duration這兩個(gè)屬性; 這里注意下視頻如果沒(méi)有設(shè)置預(yù)加載屬性preload的話,在video元素初始化的時(shí)候是獲取不到duration的...那你只能在播放的時(shí)候去拿了.
// 獲取播放時(shí)間 getPlayTime() { const percent = this.$video.currentTime / this.$video.duration; this.video.progress.current = Math.round( this.video.progress.width * percent ); // 賦值時(shí)長(zhǎng) this.video.totalTime = timeParse(this.$video.duration); this.video.displayTime = timeParse(this.$video.currentTime); }, // 獲取緩存時(shí)間 getLoadTime() { // console.log('緩存了...',this.$video.buffered.end(0)); this.video.loaded = (this.$video.buffered.end(0) / this.$video.duration) * 100; },手動(dòng)滑動(dòng)進(jìn)度條控制
這里直接用touch事件即可; 注意touchend中使用e.changedTouches;因?yàn)楫?dāng)手指離開(kāi)屏幕，touches和targetTouches中對(duì)應(yīng)的元素會(huì)同時(shí)移除，而changedTouches仍然會(huì)存在元素。
// 手動(dòng)調(diào)節(jié)播放進(jìn)度 moveStart(e) {}, moveIng(e) { // console.log("觸摸中..."); let currentX = e.targetTouches[0].pageX; let offsetX = currentX - this.progressBar.pos.left; // 邊界檢測(cè) if (offsetX <= 0) { offsetX = 0 } if (offsetX >= this.video.progress.width) { offsetX = this.video.progress.width } this.video.progress.current = offsetX; let percent = this.video.progress.current / this.video.progress.width; this.$video.duration && this.setPlayTime(percent, this.$video.duration) }, moveEnd(e) { // console.log("觸摸結(jié)束..."); let currentX = e.changedTouches[0].pageX; let offsetX = currentX - this.progressBar.pos.left; this.video.progress.current = offsetX; // 這里的offsetX都是正數(shù) let percent = offsetX / this.video.progress.width; this.$video.duration && this.setPlayTime(percent, this.$video.duration) }, // 設(shè)置手動(dòng)播放時(shí)間 setPlayTime(percent, totalTime) { this.$video.currentTime = Math.floor(percent * totalTime); },全屏功能
這個(gè)功能在手機(jī)上會(huì)有寫(xiě)兼容性問(wèn)題...有待完善
// 設(shè)置全屏 fullScreen() { console.log('點(diǎn)擊全屏...'); if (!this.state.fullScreen) { this.state.fullScreen = true; this.$video.webkitRequestFullScreen(); } else { this.state.fullScreen = false; document.webkitCancelFullScreen(); }坑點(diǎn)匯總
1.視頻預(yù)加載才能獲取時(shí)長(zhǎng)
需要設(shè)置預(yù)加載 preload="auto"
2.Element.getBoundingClientRect()方法返回元素的大小及其相對(duì)于視口的位置
父元素設(shè)置display:none時(shí)獲取不到尺寸數(shù)據(jù)民謠改為visibility:hidden
3.play()方法異常捕獲
try{ xxxxx.play } catch(e) { yyyyyy }
4.安卓手機(jī)video兼容性處理, 視頻播放時(shí)層級(jí)置頂,會(huì)影響全局彈出層樣式
我這里做的處理是當(dāng)彈出層出現(xiàn)時(shí)把視頻給隱藏掉(寬高為0,或者直接去掉),用封面圖來(lái)替代
5.ios下全屏處理
設(shè)置相應(yīng)屬性即可, playsinline
代碼直通車: https://github.com/appleguardu/vue-h5-video
以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持武林網(wǎng)。
新聞熱點(diǎn)
疑難解答
圖片精選
網(wǎng)友關(guān)注
