Menu

视频优化

本页概述了如何在 Next.js 应用中使用视频,展示了如何存储和显示视频文件而不影响性能。

使用 <video><iframe>

可以使用 HTML <video> 标签嵌入直接的视频文件,使用 <iframe> 嵌入外部平台托管的视频。

<video>

HTML <video> 标签可以嵌入自托管或直接提供的视频内容,允许完全控制播放和外观。

app/ui/video.jsx
export function Video() {
  return (
    <video width="320" height="240" controls preload="none">
      <source src="/path/to/video.mp4" type="video/mp4" />
      <track
        src="/path/to/captions.vtt"
        kind="subtitles"
        srcLang="en"
        label="English"
      />
      你的浏览器不支持视频标签。
    </video>
  );
}

常见的 <video> 标签属性

属性描述示例值
src指定视频文件的来源。<video src="/path/to/video.mp4" />
width设置视频播放器的宽度。<video width="320" />
height设置视频播放器的高度。<video height="240" />
controls如果存在,则显示默认的播放控件集。<video controls />
autoPlay页面加载时自动开始播放视频。注意:自动播放策略因浏览器而异。<video autoPlay />
loop循环播放视频。<video loop />
muted默认将音频静音。通常与 autoPlay 一起使用。<video muted />
preload指定如何预加载视频。值:nonemetadataauto<video preload="none" />
playsInline在 iOS 设备上启用内联播放,通常需要使 autoplay 在 iOS Safari 上工作。<video playsInline />

须知:使用 autoPlay 属性时,重要的是同时包含 muted 属性以确保视频在大多数浏览器中自动播放,以及 playsInline 属性以兼容 iOS 设备。

有关视频属性的完整列表,请参阅 MDN 文档

视频最佳实践

  • 回退内容:使用 <video> 标签时,在标签内包含回退内容,以供不支持视频播放的浏览器使用。
  • 字幕或标题:为聋人或听力障碍用户提供字幕或标题。在 <video> 元素中使用 <track> 标签来指定字幕文件源。
  • 无障碍控件:推荐使用标准 HTML5 视频控件,以支持键盘导航和屏幕阅读器兼容性。对于高级需求,考虑使用第三方播放器,如 react-playervideo.js,它们提供无障碍控件和一致的浏览器体验。

<iframe>

HTML <iframe> 标签允许你嵌入来自 YouTube 或 Vimeo 等外部平台的视频。

app/page.jsx
export default function Page() {
  return (
    <iframe
      src="https://www.youtube.com/watch?v=gfU1iZnjRZM"
      frameborder="0"
      allowfullscreen
    />
  );
}

常见的 <iframe> 标签属性

属性描述示例值
src要嵌入的页面的 URL。<iframe src="https://example.com" />
width设置 iframe 的宽度。<iframe width="500" />
height设置 iframe 的高度。<iframe height="300" />
frameborder指定是否在 iframe 周围显示边框。<iframe frameborder="0" />
allowfullscreen允许 iframe 内容以全屏模式显示。<iframe allowfullscreen />
sandbox对 iframe 内容启用一组额外的限制。<iframe sandbox />
loading优化加载行为 (例如,延迟加载)。<iframe loading="lazy" />
title为 iframe 提供标题以支持无障碍访问。<iframe title="描述" />

有关 iframe 属性的完整列表,请参阅 MDN 文档

选择视频嵌入方法

你可以通过两种方式在 Next.js 应用中嵌入视频:

  • 自托管或直接视频文件:使用 <video> 标签嵌入自托管视频,适用于需要对播放器功能和外观进行详细控制的场景。这种在 Next.js 中的集成方法允许你自定义和控制视频内容。
  • 使用视频托管服务 (YouTube、Vimeo 等):对于 YouTube 或 Vimeo 等视频托管服务,你将使用 <iframe> 标签嵌入它们基于 iframe 的播放器。虽然这种方法限制了对播放器的一些控制,但它提供了这些平台的易用性和功能。

选择与你的应用需求和你希望提供的用户体验相符的嵌入方法。

嵌入外部托管的视频

要嵌入来自外部平台的视频,你可以使用 Next.js 获取视频信息,并使用 React Suspense 处理加载时的回退状态。

1. 创建视频嵌入的服务器组件

第一步是创建一个 服务器组件,生成用于嵌入视频的适当 iframe。这个组件将获取视频的源 URL 并渲染 iframe。

app/ui/video-component.jsx
export default async function VideoComponent() {
  const src = await getVideoSrc();
 
  return <iframe src={src} frameborder="0" allowfullscreen />;
}

2. 使用 React Suspense 流式传输视频组件

创建用于嵌入视频的服务器组件后,下一步是使用 React Suspense 流式传输 该组件。

app/page.jsx
import { Suspense } from "react";
import VideoComponent from "../ui/VideoComponent.jsx";
 
export default function Page() {
  return (
    <section>
      <Suspense fallback={<p>正在加载视频...</p>}>
        <VideoComponent />
      </Suspense>
      {/* 页面的其他内容 */}
    </section>
  );
}

须知:在嵌入来自外部平台的视频时,请考虑以下最佳实践:

  • 确保视频嵌入是响应式的。使用 CSS 使 iframe 或视频播放器适应不同的屏幕尺寸。
  • 根据网络条件实施 视频加载策略,尤其是对于数据计划有限的用户。

这种方法可以带来更好的用户体验,因为它防止了页面阻塞,这意味着用户可以在视频组件流式传输时与页面进行交互。

为了提供更具吸引力和信息量的加载体验,考虑使用加载骨架作为回退 UI。因此,不是显示简单的加载消息,你可以显示一个类似视频播放器的骨架,如下所示:

app/page.jsx
import { Suspense } from "react";
import VideoComponent from "../ui/VideoComponent.jsx";
import VideoSkeleton from "../ui/VideoSkeleton.jsx";
 
export default function Page() {
  return (
    <section>
      <Suspense fallback={<VideoSkeleton />}>
        <VideoComponent />
      </Suspense>
      {/* 页面的其他内容 */}
    </section>
  );
}

自托管视频

出于以下几个原因,自托管视频可能更可取:

  • 完全控制和独立性:自托管让你能够直接管理视频内容,从播放到外观,确保完全拥有和控制,不受外部平台限制。
  • 针对特定需求的自定义:适用于独特需求,如动态背景视频,它允许根据设计和功能需求进行定制。
  • 性能和可扩展性考虑:选择既高性能又可扩展的存储解决方案,以有效支持不断增加的流量和内容规模。
  • 成本和集成:权衡存储和带宽成本与轻松集成到 Next.js 框架和更广泛的技术生态系统的需求。

使用 Vercel Blob 进行视频托管

Vercel Blob 提供了一种高效的视频托管方式,提供可扩展的云存储解决方案,非常适合 Next.js。以下是如何使用 Vercel Blob 托管视频:

1. 将视频上传到 Vercel Blob

在 Vercel 仪表板中,导航到"Storage"选项卡并选择你的 Vercel Blob 存储。在 Blob 表格的右上角,找到并点击"Upload"按钮。然后,选择你想上传的视频文件。上传完成后,视频文件将出现在 Blob 表格中。

或者,你可以使用服务器操作上传视频。有关详细说明,请参阅 Vercel 文档中的 服务器端上传。Vercel 还支持 客户端上传。对于某些用例,这种方法可能更可取。

2. 在 Next.js 中显示视频

一旦视频上传并存储,你就可以在 Next.js 应用中显示它。以下是使用 <video> 标签和 React Suspense 的示例:

app/page.jsx
import { Suspense } from "react";
import { list } from "@vercel/blob";
 
export default function Page() {
  return (
    <Suspense fallback={<p>正在加载视频...</p>}>
      <VideoComponent fileName="my-video.mp4" />
    </Suspense>
  );
}
 
async function VideoComponent({ fileName }) {
  const { blobs } = await list({
    prefix: fileName,
    limit: 1,
  });
  const { url } = blobs[0];
 
  return (
    <video controls preload="none" aria-label="视频播放器">
      <source src={url} type="video/mp4" />
      你的浏览器不支持视频标签。
    </video>
  );
}

在这种方法中,页面使用视频的 @vercel/blob URL 通过 VideoComponent 显示视频。React Suspense 用于在获取视频 URL 并准备显示视频之前显示回退内容。

为视频添加字幕

如果你有视频的字幕,可以使用 <video> 标签内的 <track> 元素轻松添加它们。你可以以类似于视频文件的方式从 Vercel Blob 获取字幕文件。以下是如何更新 <VideoComponent> 以包含字幕。

app/page.jsx
async function VideoComponent({ fileName }) {
  const { blobs } = await list({
    prefix: fileName,
    limit: 2,
  });
  const { url } = blobs[0];
  const { url: captionsUrl } = blobs[1];
 
  return (
    <video controls preload="none" aria-label="视频播放器">
      <source src={url} type="video/mp4" />
      <track src={captionsUrl} kind="subtitles" srcLang="en" label="English" />
      你的浏览器不支持视频标签。
    </video>
  );
}

通过遵循这种方法,你可以有效地自托管并将视频集成到 Next.js 应用中。

资源

要继续了解更多关于视频优化和最佳实践的信息,请参考以下资源:

  • 了解视频格式和编解码器:为你的视频需求选择正确的格式和编解码器,比如使用 MP4 实现兼容性或使用 WebM 进行 Web 优化。有关更多详细信息,请参阅 Mozilla 的视频编解码器指南
  • 视频压缩:使用像 FFmpeg 这样的工具有效地压缩视频,平衡质量和文件大小。在 FFmpeg 的官方网站 了解压缩技术。
  • 分辨率和比特率调整:根据观看平台调整 分辨率和比特率,移动设备使用较低的设置。
  • 内容分发网络 (CDN):使用 CDN 来提高视频传输速度并管理高流量。使用某些存储解决方案(如 Vercel Blob)时,CDN 功能会自动处理。了解更多 关于 CDN 及其优势。

探索这些视频流媒体平台,以将视频集成到你的 Next.js 项目中:

开源 next-video 组件

  • 为 Next.js 提供 <Video> 组件,兼容各种托管服务,包括 Vercel Blob、S3、Backblaze 和 Mux。
  • 详细文档 介绍如何将 next-video.dev 与不同的托管服务一起使用。

Cloudinary 集成

Mux 视频 API

Fastly

  • 了解更多关于将 Fastly 的 视频点播 和流媒体解决方案集成到 Next.js 中的信息。

ImageKit.io 集成