Skip to content

Commit

Permalink
[zh-cn] sync translated content (#24884)
Browse files Browse the repository at this point in the history
Co-authored-by: Jason Ren <[email protected]>
  • Loading branch information
mdn-bot and jasonren0403 authored Dec 2, 2024
1 parent e5c55ec commit f7e2804
Show file tree
Hide file tree
Showing 5 changed files with 101 additions and 118 deletions.
1 change: 1 addition & 0 deletions files/zh-cn/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2442,6 +2442,7 @@
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/选择_www_或非_www_URL_作为域名 /zh-CN/docs/Web/URI/Authority/Choosing_between_www_and_non-www_URLs
/zh-CN/docs/Web/HTTP/CORS/Errors/CORS错误允许凭证 /zh-CN/docs/Web/HTTP/CORS/Errors/CORSMIssingAllowCredentials
/zh-CN/docs/Web/HTTP/Caching_FAQ /zh-CN/docs/Web/HTTP/Caching
/zh-CN/docs/Web/HTTP/Configuring_servers_for_Ogg_media /zh-CN/docs/Web/Media/Formats/Configuring_servers_for_Ogg_media
/zh-CN/docs/Web/HTTP/Content_negotiation/Accept_默认值 /zh-CN/docs/Web/HTTP/Content_negotiation/List_of_default_Accept_values
/zh-CN/docs/Web/HTTP/Feature_Policy /zh-CN/docs/Web/HTTP/Permissions_Policy
/zh-CN/docs/Web/HTTP/HTTP_Strict_Transport_Security /zh-CN/docs/Web/HTTP/Headers/Strict-Transport-Security
Expand Down
8 changes: 4 additions & 4 deletions files/zh-cn/_wikihistory.json
Original file line number Diff line number Diff line change
Expand Up @@ -22544,10 +22544,6 @@
"modified": "2019-09-19T06:11:16.911Z",
"contributors": ["leah_humlelu", "Trendymen", "xianweics", "WayneCui"]
},
"Web/HTTP/Configuring_servers_for_Ogg_media": {
"modified": "2019-12-27T03:08:09.838Z",
"contributors": ["Syaki"]
},
"Web/HTTP/Connection_management_in_HTTP_1.x": {
"modified": "2019-11-07T04:16:26.733Z",
"contributors": [
Expand Down Expand Up @@ -31168,6 +31164,10 @@
"modified": "2019-10-28T06:26:59.997Z",
"contributors": ["jswisher"]
},
"Web/Media/Formats/Configuring_servers_for_Ogg_media": {
"modified": "2019-12-27T03:08:09.838Z",
"contributors": ["Syaki"]
},
"Web/Media/Formats/Image_types": {
"modified": "2020-10-28T06:58:07.754Z",
"contributors": ["hylashyla", "RainSlide"]
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/html/element/video/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -531,4 +531,4 @@ AddType video/webm .webm
- {{htmlelement("audio")}}
- [使用 HTML 音频和视频](/zh-CN/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content)
- [使用 canvas 处理视频](/zh-CN/docs/Web/API/Canvas_API/Manipulating_video_using_canvas)
- [Ogg 格式媒体文件的服务器配置](/zh-CN/docs/Web/HTTP/Configuring_servers_for_Ogg_media)
- [Ogg 格式媒体文件的服务器配置](/zh-CN/docs/Web/Media/Formats/Configuring_servers_for_Ogg_media)
113 changes: 0 additions & 113 deletions files/zh-cn/web/http/configuring_servers_for_ogg_media/index.md

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
---
title: 为 Ogg 媒体配置服务器
slug: Web/Media/Formats/Configuring_servers_for_Ogg_media
l10n:
sourceCommit: 4d12b3e4f9afb311f2656641260e42c0b6f8f4c6
---

{{QuickLinksWithSubpages("/zh-CN/docs/Web/Media")}}

HTML {{HTMLElement("audio")}} 和 {{HTMLElement("video")}} 标签无需用户安装任何插件或软件即可播放媒体文件。本指南包括了一些服务器配置修改,这些修改对于 web 服务器提供 Ogg 媒体文件是必要的。这些信息在遇到服务器未配置为可识别的其他媒体类型文件时也可能提供帮助。

## 为媒体提供正确的 MIME 类型

如果不确定 Ogg 文件是否包含音频或视频,可以使用 MIME 类型 `application/ogg` 提供,浏览器会将其视为视频文件。

- 包含视频轨的 `*.ogg``*.ogv` 文件(通常也会包含音频轨),应当使用 MIME 类型 `video/ogg`
- 只包含音频轨的 `*.oga``*.ogg` 文件应当使用 MIME 类型 `audio/ogg`

默认情况下,大多数服务器不为 Ogg 媒体提供正确的 MIME 类型,因此可能需要为此添加适当的配置。

对于 Apache,可添加如下配置:

```apacheconf
AddType audio/ogg .oga
AddType video/ogg .ogv
AddType application/ogg .ogg
```

在配置服务器以正确托管媒体时,[媒体容器格式](/zh-CN/docs/Web/Media/Formats/Containers)这篇文章尤其有帮助。

## 正确处理范围请求

为了支持搜索和播放尚未下载的媒体区域,你可以使用[范围请求](/zh-CN/docs/Web/HTTP/Range_requests)从搜索目标位置检索媒体。此外,它还会使用字节范围请求寻址到媒体的末尾(假设提供了 {{HTTPHeader("Content-Length")}} 标头),以确定媒体的时长。

如果服务器可以接受范围请求,则应接受 {{HTTPHeader("Accept-Ranges")}} 标头。它必须向所有范围请求返回 {{HTTPStatus("206", "206 Partial Content")}},否则浏览器无法判断服务器是否支持范围请求。服务器也必须为请求 `Range: bytes=0-` 返回 `206: Partial Content`

参见[范围请求](/zh-CN/docs/Web/HTTP/Range_requests)以了解更多信息。

## 包含常规关键帧

当浏览器搜索 Ogg 媒体到指定时间时,它必须搜索到目标前最近的关键帧,然后从那里下载并解码视频,直到要求的目标时间。关键帧之间的距离越远,所需的时间就越长,因此在固定的时间间隔内加入关键帧会很有帮助。

默认情况下,[`ffmpeg2theora`](https://gitlab.xiph.org/xiph/ffmpeg2theora) 每 64 帧(或以每秒 30 帧计算,约每 2 秒)使用一个关键帧,效果相当不错。

> [!NOTE]
> 当然,使用的关键帧越多,视频文件就越大,因此可能需要进行一些试验,才能在文件大小和搜索性能之间取得适当的平衡。
## 考虑使用 preload 属性

HTML {{HTMLElement("audio")}} 和 {{HTMLElement("video")}} 元素提供了 `preload` 属性,它告诉浏览器在页面加载时尝试下载整个媒体。如果没有 `preload` 属性,浏览器将下载足够显示第一个视频帧的媒体,并确定媒体的时长。

- 默认情况下,`preload` 是关闭的,因此如果进入视频是网页的重点,在视频元素中加入 `preload` 可能会更受用户喜爱。
- 使用 `preload="metadata"` 会预载媒体文件的元数据,可能还会预载视频的前几帧。将 `payload` 设置为 `auto`,浏览器就会在页面加载完成后自动开始下载媒体文件,前提是用户会播放该文件。

## 不要对 Ogg 媒体使用 HTTP 压缩

减少 web 服务器负载的一个常用方法是在向支持的 web 浏览器提供服务时使用 [gzip 或 deflate 压缩](https://betterexplained.com/articles/how-to-optimize-your-site-with-gzip-compression/)

虽然可能性不大,但浏览器可能会在请求媒体文件时使用 `Accept-Encoding: gzip,deflate` 标头宣称其支持 HTTP 压缩(gzip/deflate)。服务器不应该配置如此;媒体文件中的数据已被压缩,因此你不会从压缩中获得任何真正的好处,而且使用压缩会使浏览器无法正确搜索视频或确定其持续时间。

允许对媒体流进行 HTTP 压缩的另一个问题:如果使用 gzip 编码,Apache 服务器不会发送 {{HTTPHeader("Content-Length")}} 响应标头。

## 获取 Ogg 媒体的时长

你可以使用 `oggz-info` 工具来获取媒体时长;这个工具包含在 [`oggz-tools`](https://www.xiph.org/oggz/) 软件包中。`oggz-info` 的输出如下:

```bash
$ oggz-info /g/media/bruce_vs_ironman.ogv
Content-Duration: 00:01:00.046

Skeleton: serialno 1976223438
4 packets in 3 pages, 1.3 packets/page, 27.508% Ogg overhead
Presentation-Time: 0.000
Basetime: 0.000

Theora: serialno 0170995062
1790 packets in 1068 pages, 1.7 packets/page, 1.049% Ogg overhead
Video-Framerate: 29.983 fps
Video-Width: 640
Video-Height: 360

Vorbis: serialno 0708996688
4531 packets in 167 pages, 27.1 packets/page, 1.408% Ogg overhead
Audio-Samplerate: 44100 Hz
Audio-Channels: 2
```

请注意,你不能直接使用由 `oggz-info` 报告的 Content-Duration 行,因为它是以 `HH:MM:SS` 格式报告的。需要将其转换为秒,然后将其作为 `X-Content-Duration` 值提供。为此,可以解析 `HH``MM``SS` 段,然后转换为 `(HH * 3600) + (MM * 60) + SS` 作为应该报告的值。

值得注意的是,`oggz-info` 似乎会对媒体进行一次读取以计算其时长,因此存储时长是个好主意,这样可以避免在每次对 Ogg 媒体进行 HTTP 请求时都要计算时长而造成长时间的延迟。

## 参见

- [视频和音频内容](/zh-CN/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content)
- [常用媒体类型的编解码器](/zh-CN/docs/Web/Media/Formats/codecs_parameter)

0 comments on commit f7e2804

Please sign in to comment.