You need to enable JavaScript to run this app. Angular9 单页多视频滚动自动播放与互斥暂停实现
优惠活动
大模型
产品
解决方案
定价
更多

Angular9 单页多视频滚动自动播放与互斥暂停实现

Angular9 单页多视频滚动联动播放实现方案

核心实现思路

采用Angular自定义结构指令封装通用联动逻辑,搭配浏览器原生IntersectionObserver做视口检测,替代传统scroll事件监听,从根源避免滚动卡顿问题;通过指令内的静态属性做跨实例的播放状态协调,保证同一时刻仅单个视频处于播放状态。

第一步:改造原有重复的模板代码

原模板中4个结构完全一致的视频块可以通过*ngFor遍历渲染,避免重复冗余代码:

  1. 先在组件中定义视频数据源:
// 业务组件内的属性定义
videoList = [
  { id: 1, url: '第一个视频的实际地址' },
  { id: 2, url: '第二个视频的实际地址' },
  { id: 3, url: '第三个视频的实际地址' },
  { id: 4, url: '第四个视频的实际地址' }
]
  1. 替换原模板中写死的视频块,给每个video元素挂上自定义指令标识:
<div class="video_content left" *ngFor="let video of videoList">
  <span style="font-weight:bold">{{ video.id }}</span>
  <video 
    width="213" 
    height="120" 
    controls 
    class="video_tag"
    appVideoAutoPlay
  >
    <source [src]="video.url" type="video/mp4" />
  </video>
</div>

第二步:编写联动逻辑的自定义指令

指令的核心能力包含两点:

  • 检测绑定的video元素的可视区域露出比例,当露出占比超过60%时判定为进入可视区
  • 全局维护唯一的正在播放的视频实例,当新视频满足播放条件时,先暂停之前的播放实例,再播放当前视频;当视频滚出可视区时自动暂停

兼容Angular9的指令实现代码:

import { Directive, ElementRef, OnDestroy, OnInit } from '@angular/core';

@Directive({
  selector: '[appVideoAutoPlay]'
})
export class VideoAutoPlayDirective implements OnInit, OnDestroy {
  // 跨指令实例共享的当前播放视频引用
  private static currentPlayingVideo: HTMLVideoElement | null = null;
  private intersectionObserver: IntersectionObserver;

  constructor(private elementRef: ElementRef<HTMLVideoElement>) {}

  ngOnInit(): void {
    this.intersectionObserver = new IntersectionObserver((entries) => {
      entries.forEach(entry => {
        // 露出比例超过60%时触发播放逻辑
        if (entry.intersectionRatio >= 0.6) {
          this.triggerPlay();
        } else {
          this.triggerPause();
        }
      })
    }, {
      // 配置检测阈值,覆盖全露出/半露出/完全滚出的场景
      threshold: [0, 0.6, 1]
    });

    this.intersectionObserver.observe(this.elementRef.nativeElement);
  }

  /** 处理视频播放逻辑 */
  private triggerPlay(): void {
    const targetVideo = this.elementRef.nativeElement;
    // 若当前已有其他视频在播放,优先暂停
    if (VideoAutoPlayDirective.currentPlayingVideo && 
        VideoAutoPlayDirective.currentPlayingVideo !== targetVideo) {
      VideoAutoPlayDirective.currentPlayingVideo.pause();
    }
    // 调用播放方法,捕获浏览器自动播放策略的拦截异常,避免控制台报错
    targetVideo.play().catch(() => {});
    // 更新全局播放状态引用
    VideoAutoPlayDirective.currentPlayingVideo = targetVideo;
  }

  /** 处理视频暂停逻辑 */
  private triggerPause(): void {
    const targetVideo = this.elementRef.nativeElement;
    targetVideo.pause();
    // 若被暂停的是全局记录的播放实例,清空状态引用
    if (VideoAutoPlayDirective.currentPlayingVideo === targetVideo) {
      VideoAutoPlayDirective.currentPlayingVideo = null;
    }
  }

  ngOnDestroy(): void {
    // 组件销毁时断开观察,避免内存泄漏
    this.intersectionObserver.disconnect();
  }
}

版本适配与常见踩坑说明

  • 指令的注册:只需要在对应业务模块的declarations数组中声明一次VideoAutoPlayDirective,所有挂了appVideoAutoPlay标识的video元素都能自动生效,不需要在每个使用场景重复写逻辑
  • 自动播放策略兼容:部分浏览器会拦截没有用户交互场景下的自动播放,代码中通过.catch()捕获拦截异常,不会造成控制台未捕获报错;如果需要适配严格的自动播放策略,可以在用户首次点击页面时给全局video元素标记允许自动播放
  • 避免scroll监听的性能损耗:不要用window.scroll事件手动计算元素位置做可视判定,IntersectionObserver是浏览器原生的异步检测能力,长列表滚动时不会造成明显的性能掉帧
  • 状态兼容:用户手动通过video的controls控件操作播放/暂停时,只要没有触发元素进入/离开视口的判定,指令不会强行覆盖用户的操作状态

内容的提问来源于stack exchange,提问作者Saad Ahmed

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 23:06:04