comparison xml/ru/docs/http/ngx_http_mp4_module.xml @ 2797:17ed19394953

Documented the mp4_start_key_frame directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 15 Nov 2021 12:52:47 +0000
parents bcdb13e1e8c6
children 9eadb98ec770
comparison
equal deleted inserted replaced
2796:bcdb13e1e8c6 2797:17ed19394953
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Модуль ngx_http_mp4_module" 9 <module name="Модуль ngx_http_mp4_module"
10 link="/ru/docs/http/ngx_http_mp4_module.html" 10 link="/ru/docs/http/ngx_http_mp4_module.html"
11 lang="ru" 11 lang="ru"
12 rev="8"> 12 rev="9">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_http_mp4_module</literal> обеспечивает серверную поддержку 17 Модуль <literal>ngx_http_mp4_module</literal> обеспечивает серверную поддержку
80 nginx считывает из файла метаданные, готовит поток с запрошенным 80 nginx считывает из файла метаданные, готовит поток с запрошенным
81 диапазоном и отправляет его клиенту. 81 диапазоном и отправляет его клиенту.
82 Это тоже требует дополнительных ресурсов, как указано выше. 82 Это тоже требует дополнительных ресурсов, как указано выше.
83 </para> 83 </para>
84 84
85 <para id="keyframe">
86 Если аргумент <literal>start</literal> указывает на
87 видеокадр, не являющийся ключевым,
88 то начало такого видео может воспроизводиться с ошибками.
89 В этом случае к запрашиваемому видео
90 <link id="mp4_start_key_frame">могут</link> быть добавлены
91 ближайший к точке <literal>start</literal> ключевой кадр
92 и все промежуточные кадры между ними.
93 При воспроизведении эти кадры будут скрыты
94 при помощи edit-листа (1.21.4).
95 </para>
96
85 <para> 97 <para>
86 Если запрос, обрабатываемый этим модулем, не содержит аргументов 98 Если запрос, обрабатываемый этим модулем, не содержит аргументов
87 <literal>start</literal> и <literal>end</literal>, 99 <literal>start</literal> и <literal>end</literal>,
88 дополнительные ресурсы не тратятся, а файл отсылается непосредственно как 100 дополнительные ресурсы не тратятся, а файл отсылается непосредственно как
89 статический ресурс. 101 статический ресурс.
226 </note> 238 </note>
227 </para> 239 </para>
228 240
229 </directive> 241 </directive>
230 242
243
244 <directive name="mp4_start_key_frame">
245 <syntax><literal>on</literal> | <literal>off</literal></syntax>
246 <default>off</default>
247 <context>http</context>
248 <context>server</context>
249 <context>location</context>
250 <appeared-in>1.21.4</appeared-in>
251
252 <para>
253 Включает режим, в котором видео всегда начинается с ключевого видеокадра.
254 Если аргумент <literal>start</literal> не указывает на ключевой кадр,
255 то первоначальные кадры будут скрыты при помощи mp4 edit-листа.
256 Edit-листы поддерживаются большинством плееров и браузеров
257 включая Chrome, Safari, QuickTime и ffmpeg,
258 частично поддерживаются в Firefox.
259 </para>
260
261 </directive>
262
231 </section> 263 </section>
232 264
233 </module> 265 </module>