移动端自制音乐播放器--React

相信大家都有过开发音乐播放器的需求,我也不例外,最近刚好就做了一个这样的需求,所以就顺便把遇到的问题和踩过的坑,分享一下~

因为项目是基于React,所以下面的源码基本都是在播放器组件中抽出来的,不过无论在什么框架下开发,逻辑是一样滴。

播放器皮肤

先从简单的开始讲起吧,说到播放器几个常用的操作按钮肯定少不了,但是最重要的是那一个可以拖动的播放条。

播放器样式

<!--进度条begin-->
<div className="audio-progress" ref={(r) => { this.audioProgress = r }}>
    <div className="audio-progress-bar" ref={(bar) => { this.progressBar = bar }}>
        <div className="audio-progress-bar-preload" style={{ width: bufferedPercent + '%' }}></div>
        <div className="audio-progress-bar-current" style={{ width: `calc(${currentTime}/${currentTotalTime} * ${this.progressBar && this.progressBar.clientWidth}px)` }}></div>
    </div>
    <div className="audio-progress-point-area" ref={(point) => { this.audioPoint = point }} style={{ left: left + 'px' }}>
        <div className="audio-progress-point">

        </div>
    </div>
</div>
<!--进度条begin-->
    <div className="audio-timer">
        <p>{this.renderPlayTime(currentTime)}</p>
        <p>{this.renderPlayTime(currentTotalTime)}</p>
    </div>

    <div className="audio-control">
        <div className="audio-control-pre">
            <img src={PreIcon} alt="" />
        </div>
        <div className="audio-control-play">
            <img src={Play} alt="" />
        </div>
        <div className="audio-control-next">
            <img src={NextIcon} alt="" />
        </div>
    </div>

进度条的大致原理就是获取音频的当前播放时长以及音频总时长的比例,然后通过这个比例与进度条宽度相乘,可以得到当前播放时长下进度条需要被填充的宽度。

代码中的“audio-progress-bar-preload”是用来做缓冲条的,大概的做法也是一样,不过获取缓冲进度得用到audio的buffered属性,具体的用法推荐大家去MDN看看,在这里就不多赘述。

进度条以及播放按钮的布局代码大概就是这样,在css方面需要注意的就是进度条容器与进度条填充块以及进度条触点间的层级关系就好。

播放器功能逻辑

也许看了上面,大家觉得很疑惑,为什么没有见到最关键的audio标签。那是因为,其实整个播放器的逻辑重点都在那个标签里,我们需要单独抽出来分析一下。

<audio 
    preload="metadata" 
    src={src} 
    ref={(audio) => {this.lectureAudio = audio}} 
    style={{width: '1px', height: '1px', visibility: 'hidden'}} 
    onCanPlay={() => this.handleAudioCanplay()}
    onTimeUpdate={() => this.handleTimeUpdate()}>
</audio>

① 怎么让进度条动起来?

解决思路--音频在播放的时候,当前进度(currentTime)是一直都在变化的,也就是说,能找到一个将currentTime变化具现为进度条长度的常数是关键。说的这么复杂,其实在上面的布局代码里已经剧透了,

calc(${currentTime}/${currentTotalTime} * $this.progressBar.clientWidth}px

这样就能很轻松的算出当前进度需要对应的进度条填充长度。问题又来了,我知道进度条该填充多长了,但是它还是不会动额...
在这里,我们有两个方法可以解决:

  • 利用setInterval
    我们可以每隔300ms就检测一下当前audio的currentTime,然后在setState动态改变state中的currentTime,接着组件便会重渲染进度条部分的展示,从而也就让我们的进度条动起来了。
  • 利用audio的ontimeupdate事件
    这个是audio和video都拥有的原生事件,作用是--“当currentTime更新时会触发timeupdate事件”,一般推荐使用这种方式来动态计算进度条的宽度,毕竟可以少写一个计时器,说不定可以规避一些项目中的隐患。而且这是HTML的原生事件,浏览器的支持肯定是充分的,所以从性能的角度来说应该是比上一种方式要好。

ontimeupdate时执行的方法--每次触发该事件时都重新给currentTime赋值,剩下的改动都可以通过currentTime值的变化而做出相应的变化。

handleTimeUpdate() {
    if (this.state.currentTime < (this.state.currentTotalTime - 1)) {
        this.setState({
            currentTime: this.lectureAudio.currentTime
        });
    } else {
        ......
    }
}

② 怎么在移动端拖动进度条?

解决思路--既然是移动端的触碰事件,那么touch事件自然就是主角了。通过touch事件我们可以计算出,拖动的距离,进而得到进度条以及触点该移动的距离。

initListenTouch() {
    this.audioPoint.addEventListener('touchstart', (e) => this.pointStart(e), false);
    this.audioPoint.addEventListener('touchmove', (e) => this.pointMove(e), false);
    this.audioPoint.addEventListener('touchend', (e) => this.pointEnd(e), false);
}

这是组件加载时挂在到进度条触点的三个事件监听,这里讲一下三个监听具体都有些什么作用。

  • touchstart--负责获取触摸进度触点时触点的方位
pointStart(e) {
    e.preventDefault();
    let touch = e.touches[0];
    this.lectureAudio.pause();
    //为了更好的体验,在移动触点的时候我选择将音频暂停
    this.setState({
        isPlaying: false,//播放按钮变更
        startX: touch.pageX//进度触点在页面中的x坐标
    });
}
  • touchmove--负责动态计算触点的拖动距离,并转换成this.state.currentTime从而触发组件的重渲染.
pointMove(e) {
    e.preventDefault();
    let touch = e.touches[0];
    let x = touch.pageX - this.state.startX; //滑动的距离
    let maxMove = this.progressBar.clientWidth;//最大的移动距离不可超过进度条宽度

    //(this.state.moveX) = this.lectureAudio.duration / this.progressBar.clientWidth;
    //moveX是一个固定的常数,它代表着进度条宽度与音频总时长的关系,我们可以通过获取触点移动的距离从而计算出此时对应的currentTime
    //下面是触点移动时会碰到的情况,分为正移动、负移动以及两端的极限移动。
    if (x >= 0) {
        if (x + this.state.startX - this.offsetWindowLeft >= maxMove) {
            this.setState({
                currentTime: this.state.currentTotalTime,
                //改变当前播放时间的数值
            }, () => {
                this.lectureAudio.currentTime = this.state.currentTime;
                //改变audio真正的播放时间
            })
        } else {
            this.setState({
                currentTime: (x + this.state.startX - this.offsetWindowLeft) * this.state.moveX
            }, () => {
                this.lectureAudio.currentTime = this.state.currentTime;
            })
        }
    } else {
        if (-x <= this.state.startX - this.offsetWindowLeft) {
            this.setState({
                currentTime: (this.state.startX + x - this.offsetWindowLeft) * this.state.moveX,
            }, () => {
                this.lectureAudio.currentTime = this.state.currentTime;
            })
        } else {
            this.setState({
                currentTime: 0
            }, () => {
                this.lectureAudio.currentTime = this.state.currentTime;
            })
        }
    }
}
  • touchend--负责恢复音频的播放
pointEnd(e) {
    e.preventDefault();
    if (this.state.currentTime < this.state.currentTotalTime) {
        this.touchendPlay = setTimeout(() => {
            this.handleAudioPlay();
        }, 300)
    }
    //关于300ms的setTimeout,一是为了体验的良好,大家在做的时候可以试试不要300ms的延迟,会发现收听体验不好,音频的播放十分仓促。
    //另外还有一点是,audio的pause与play间隔过短会出现报错,导致audio无法准确的执行相应的动作。
}

③ 怎么实现列表播放与循环播放?

解决思路--时刻关注currentTime与duration之间的关系

handleTimeUpdate() {
        if (this.state.currentTime < (this.state.currentTotalTime - 1)){
            ......
        }else {
            //此情况为音频已播放至最后
            if (this.state.isLooping){//是否为循环播放
            //currentTime归零,并且手动将audio的currentTime设为0,并手动执行play()
                this.setState({
                    currentTime: 0
                }, () => {
                    this.lectureAudio.currentTime = this.state.currentTime;
                    this.lectureAudio.play();
                })
            }else {
                //列表播放则只需判断是否有下一首,有则跳转或播放,无则暂停播放。
                if (this.props.audioInfo.next_lecture_id && this.state.currentTime !== 0){
                    this.handleNextLecture();
                }else {
                    this.handleAudioPause();
                }
            }
        }
    }

总结

不知道大家看完之后有没一种感觉,好像无论是什么都离不开this.state中的currentTime。

是的,这个播放器的核心就是currentTime,这也是开发时的刻意为之,最后我们会发现这个组件中的唯一变量就是currentTime,我们可以通过currentTime的变化完成所有的需求,并且不需要考虑其他因素的影响,因为所有的子组件都是围绕着currentTime运转。

以上是我关于播放器开发的一点小心得,虽然没有十分酷炫的皮肤,也没有十分复杂的功能,但是对个人而言,它很好的帮我理清了一个[可用的]播放器的开发流程。

关注一下呗
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,711评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,932评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,770评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,799评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,697评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,069评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,535评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,200评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,353评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,290评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,331评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,020评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,610评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,694评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,927评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,330评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,904评论 2 341

推荐阅读更多精彩内容