ReactJS使用react-player时如何检测视频完整播放及禁止快进
基于 react-player 实现强制完整观看的落地方案
针对拖拽进度条跳过视频直接触发onEnded的校验漏洞,有两个可直接落地的实现思路,分别对应禁用快进、累计有效时长校验两种场景:
方案1:从根源禁掉进度条拖拽能力
如果要求完全不允许用户快进,最简单的逻辑是不要使用react-player默认的原生播放控件——原生控件自带的可拖拽进度条、快捷键跳转、右键菜单跳转,没法通过props直接禁用,会直接给用户留下跳过的入口。
具体实现步骤:
- 把react-player的
controls属性设为false,隐藏浏览器默认的全套原生控件 - 自己手写极简控制条,只保留播放/暂停切换按钮、实时时长展示,不做可交互的进度条组件,从界面上阻断拖拽入口
- 兜底加跳转监听:用react-player提供的
onSeek事件捕获所有跳转行为(包括键盘快捷键跳、右键菜单跳、代码触发的跳),一旦检测到非连续的进度跳转,直接把播放位置拉回上一次记录的连续播放点,不让用户跳内容
调整后的基础配置代码:
const [isPlaying, setIsPlaying] = useState(false); const [lastValidPosition, setLastValidPosition] = useState(0); const playerRef = useRef(null); <ReactPlayer ref={playerRef} controls={false} playing={isPlaying} onProgress={(state) => setLastValidPosition(state.playedSeconds)} onSeek={(to) => { // 检测到跳转位置和连续播放位置偏差超过1秒,直接拉回 if (Math.abs(to - lastValidPosition) > 1) { playerRef.current.seekTo(lastValidPosition); } }} onEnded={() => setVideoEnded(true)} url={"https://...server.net/NodeUploadServer/public/" + course.video} width="100%" height="100%" />
方案2:累计有效播放时长校验(兼顾体验和校验强度)
如果觉得完全隐藏原生控件体验太差,可以保留基础控件,但千万不要单靠onEnded事件做解锁判断——只要用户把进度条拖到最后,哪怕只看了1秒视频,这个事件也会触发,完全起不到校验作用。
具体实现逻辑:
- 初始化状态记录:累计有效播放时长
totalValidTime、上一次回调的播放位置lastPlayPosition、视频总时长videoTotalDuration - 利用react-player默认每500ms触发一次的
onProgress回调,计算两次回调之间的播放增量:- 正常播放时,两次回调的播放位置差大概是0.5秒左右,如果增量超过2秒,就判定为用户做了快进操作,这部分增量不算入有效播放时长
- 增量在正常播放范围内时,把增量累加到有效播放时长的统计值里
- 解锁条件改为:有效播放时长达到视频总时长的95%(留少量开头结尾的冗余,避免卡在0.1秒的精度差上),同时触发过
onEnded,才把后续操作的按钮置为可点击
对应实现代码:
const [totalValidTime, setTotalValidTime] = useState(0); const [lastPlayPosition, setLastPlayPosition] = useState(0); const [videoTotalDuration, setVideoTotalDuration] = useState(0); // 进度监听 const handleProgress = (state) => { const currentPosition = state.playedSeconds; // 计算两次进度的差值 const playDelta = currentPosition - lastPlayPosition; // 差值在正常播放范围内才累计时长 if (playDelta > 0 && playDelta <= 2) { setTotalValidTime(prev => prev + playDelta); } setLastPlayPosition(currentPosition); }; // 视频加载完成拿总时长 const handleVideoReady = (playerInstance) => { setVideoTotalDuration(playerInstance.getDuration()); }; // 最终解锁条件 const canUnlockNextAction = totalValidTime >= videoTotalDuration * 0.95; <ReactPlayer controls={true} onProgress={handleProgress} onReady={handleVideoReady} onEnded={() => setVideoEnded(true)} url={"https://...server.net/NodeUploadServer/public/" + course.video} width="100%" height="100%" /> <Button disabled={!videoEnded || !canUnlockNextAction} > Go to test </Button>
上线必加的兜底逻辑
- 所有前端的时长统计、解锁判断都可以被用户通过控制台改state绕过,正式环境需要把累计的有效播放时长实时同步到后端存储,按钮的最终解锁状态要以后端的校验结果为准
- 快进判定的阈值可以根据实际的回调间隔调整,比如如果视频是2倍速的课程,就把判定阈值从2秒调到4秒,避免把正常倍速播放的内容误判为快进
- 可灵活扣除不需要强制观看的片段,比如视频开头的广告、片尾的滚动列表,统计有效时长时可以把这部分时间从总时长基准里扣掉,避免用户觉得体验生硬
内容的提问来源于stack exchange,提问作者SJ19
相关产品推荐
相关产品推荐

