如何使用和优化视频
关于在 Next.js 应用程序中优化视频的建议和最佳实践。
本页概述了如何在 Next.js 应用程序中使用视频,展示如何在不影响性能的情况下存储和显示视频文件。
使用 <video> 和 <iframe>#
可以使用 HTML 的 <video> 标签嵌入直接的视频文件,使用 <iframe> 嵌入外部平台托管的视频。
<video>#
HTML 的 <video> 标签可以嵌入自托管或直接提供的视频内容,让你完全控制播放和外观。
export function Video() {
return (
<video
width="320"
height="240"
poster="/path/to/poster.jpg"
controls
preload="none"
>
<source src="/path/to/video.mp4" type="video/mp4" />
<track
src="/path/to/captions.vtt"
kind="subtitles"
srcLang="en"
label="English"
/>
Your browser does not support the video tag.
</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 /> |
poster | 在视频画面可用之前显示在视频框中的图片。 | <video poster="/poster.jpg" /> |
preload | 指定视频的预加载方式。值:none、metadata、auto。 | <video preload="none" /> |
playsInline | 在 iOS 设备上启用内联播放,这通常是 iOS Safari 中自动播放正常工作的必要条件。 | <video playsInline /> |
小知识:使用
autoPlay属性时,务必同时包含muted属性以确保视频在大多数浏览器中自动播放,并包含playsInline属性以兼容 iOS 设备。
有关视频属性的完整列表,请参阅 MDN 文档。
视频最佳实践#
- 尺寸: 设置
width和height,或 CSS 的aspect-ratio,以便浏览器在文件加载前预留出空间。没有尺寸的视频会先折叠,然后将页面其余部分向下推,这会影响累积布局偏移(Cumulative Layout Shift)。 - 海报图片: 使用
poster在视频加载期间填充预留的框,尤其是在preload="none"时——在播放开始之前不会获取任何画面。 - 回退内容: 使用
<video>标签时,请在标签内包含回退内容,以供不支持视频播放的浏览器使用。 - 字幕或说明字幕: 为失聪或有听力障碍的用户提供字幕。结合
<video>元素使用<track>标签来指定字幕文件的来源。 - 无障碍控件: 推荐使用标准的 HTML5 视频控件,以支持键盘导航和屏幕阅读器兼容。对于更高级的需求,可以考虑 react-player 或 video.js 等第三方播放器,它们提供无障碍控件和一致的浏览器体验。
<iframe>#
HTML 的 <iframe> 标签允许你嵌入来自 YouTube 或 Vimeo 等外部平台的视频。
export default function Page() {
return (
<iframe src="https://www.youtube.com/embed/19g66ezsKAg" allowFullScreen />
)
}常见的 <iframe> 标签属性#
| 属性 | 描述 | 示例值 |
|---|---|---|
src | 要嵌入的页面的 URL。 | <iframe src="https://example.com" /> |
width | 设置 iframe 的宽度。 | <iframe width="500" /> |
height | 设置 iframe 的高度。 | <iframe height="300" /> |
allowFullScreen | 允许 iframe 内容以全屏模式显示。 | <iframe allowFullScreen /> |
sandbox | 对 iframe 内的内容启用一组额外的限制。 | <iframe sandbox /> |
loading | 优化加载行为(例如懒加载)。 | <iframe loading="lazy" /> |
style | 应用 CSS,例如使用 aspect-ratio 使框保持固定形状。 | <iframe style={{ border: 0 }} /> |
title | 为 iframe 提供标题以支持无障碍访问。 | <iframe title="Description" /> |
没有尺寸的 iframe 在内容加载前会折叠,与视频一样。请为其设置 width 和 height 或 aspect-ratio,尤其是在使用 loading="lazy" 时,因为嵌入内容可能要等到周围页面绘制很久之后才会解析完成。
有关 iframe 属性的完整列表,请参阅 MDN 文档。
选择视频嵌入方式#
在 Next.js 应用程序中嵌入视频有两种方式:
- 自托管或直接的视频文件: 在需要对播放器功能和外观进行详细控制的场景下,使用
<video>标签嵌入自托管视频。这种在 Next.js 中的集成方式允许你对视频内容进行自定义和控制。 - 使用视频托管服务(YouTube、Vimeo 等): 对于 YouTube 或 Vimeo 等视频托管服务,你可以使用
<iframe>标签嵌入其基于 iframe 的播放器。虽然这种方式限制了对播放器的部分控制,但它提供了易用性和这些平台所提供的功能。
请选择符合应用程序需求以及你希望提供的用户体验的嵌入方式。
嵌入外部托管的视频#
要嵌入来自外部平台的视频,你可以使用 Next.js 获取视频信息,并使用 React Suspense 处理加载期间的回退状态。
1. 创建一个用于嵌入视频的 Server Component
第一步是创建一个 Server Component,用于生成嵌入视频所需的 iframe。该组件会获取视频的源 URL 并渲染 iframe。
export default async function VideoComponent() {
const src = await getVideoSrc()
return <iframe src={src} allowFullScreen />
}2. 使用 React Suspense 流式传输视频组件
创建用于嵌入视频的 Server Component 后,下一步是使用 React Suspense 对该组件进行流式传输。
import { Suspense } from 'react'
import VideoComponent from '../ui/VideoComponent.jsx'
export default function Page() {
return (
<section>
<Suspense fallback={<p>Loading video...</p>}>
<VideoComponent />
</Suspense>
</section>
)
}小知识:嵌入来自外部平台的视频时,请考虑以下最佳实践:
- 确保视频嵌入具有响应式设计。使用 CSS 使 iframe 或视频播放器适应不同的屏幕尺寸。
- 根据网络状况实施视频加载策略,尤其针对流量套餐受限的用户。
这种方式能带来更好的用户体验,因为它避免了页面阻塞,意味着用户可以在视频组件流式进入的同时与页面进行交互。
为了提供更具吸引力和信息量的加载体验,可以考虑使用加载骨架屏(skeleton)作为回退 UI。这样,你可以显示一个类似视频播放器的骨架屏,而不是简单的加载提示,如下所示:
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 表格中。
或者,你可以使用 Server Action 上传视频。有关详细说明,请参阅 Vercel 文档中关于服务端上传的部分。Vercel 也支持客户端上传。对于某些用例,这种方式可能更合适。
2. 在 Next.js 中显示视频
视频上传并存储后,你就可以在 Next.js 应用程序中显示它。以下是使用 <video> 标签和 React Suspense 实现这一点的示例:
import { Suspense } from 'react'
import { list } from '@vercel/blob'
export default function Page() {
return (
<Suspense fallback={<p>Loading video...</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="Video player">
<source src={url} type="video/mp4" />
Your browser does not support the video tag.
</video>
)
}在这种方式中,页面使用视频的 @vercel/blob URL,通过 VideoComponent 显示视频。React Suspense 用于在视频 URL 获取完成且视频准备好显示之前展示回退内容。
为视频添加字幕#
如果你有视频的字幕文件,可以使用 <video> 标签内的 <track> 元素轻松添加。你可以用与视频文件类似的方式从 Vercel Blob 获取字幕文件。以下是如何更新 <VideoComponent> 以包含字幕的示例。
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="Video player">
<source src={url} type="video/mp4" />
<track src={captionsUrl} kind="subtitles" srcLang="en" label="English" />
Your browser does not support the video tag.
</video>
)
}按照这种方式,你可以有效地自托管视频并将其集成到 Next.js 应用程序中。
资源#
要继续了解更多关于视频优化和最佳实践的内容,请参阅以下资源:
- 了解视频格式和编解码器:根据你的视频需求选择合适的格式和编解码器,例如注重兼容性的 MP4 或针对 Web 优化的 WebM。有关更多详情,请参阅 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 集成#
- 将 Cloudinary 与 Next.js 配合使用的官方文档和集成指南。
- 包含
<CldVideoPlayer>组件,提供开箱即用的视频支持。 - 查找将 Cloudinary 与 Next.js 集成的示例,包括自适应比特率流。
- 其他 Cloudinary 库也可使用,包括 Node.js SDK。
Mux Video API#
- Mux 提供了一个入门模板,用于使用 Mux 和 Next.js 创建视频课程。
- 了解 Mux 关于为 Next.js 应用程序嵌入高性能视频的建议。
- 探索一个演示 Mux 与 Next.js 配合使用的示例项目。
Fastly#
- 了解更多关于将 Fastly 的点播视频和流媒体解决方案集成到 Next.js 的信息。
ImageKit.io 集成#
- 查看将 ImageKit 与 Next.js 集成的官方快速入门指南。
- 该集成提供
<IKVideo>组件,带来无缝的视频支持。 - 你还可以探索其他 ImageKit 库,例如同样可用的 Node.js SDK。