diff 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
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_mp4_module.xml	Fri Nov 12 20:16:05 2021 +0000
+++ b/xml/ru/docs/http/ngx_http_mp4_module.xml	Mon Nov 15 12:52:47 2021 +0000
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_http_mp4_module"
         link="/ru/docs/http/ngx_http_mp4_module.html"
         lang="ru"
-        rev="8">
+        rev="9">
 
 <section id="summary">
 
@@ -82,6 +82,18 @@
 Это тоже требует дополнительных ресурсов, как указано выше.
 </para>
 
+<para id="keyframe">
+Если аргумент <literal>start</literal> указывает на
+видеокадр, не являющийся ключевым,
+то начало такого видео может воспроизводиться с ошибками.
+В этом случае к запрашиваемому видео
+<link id="mp4_start_key_frame">могут</link> быть добавлены
+ближайший к точке <literal>start</literal> ключевой кадр
+и все промежуточные кадры между ними.
+При воспроизведении эти кадры будут скрыты
+при помощи edit-листа (1.21.4).
+</para>
+
 <para>
 Если запрос, обрабатываемый этим модулем, не содержит аргументов
 <literal>start</literal> и <literal>end</literal>,
@@ -228,6 +240,26 @@
 
 </directive>
 
+
+<directive name="mp4_start_key_frame">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.21.4</appeared-in>
+
+<para>
+Включает режим, в котором видео всегда начинается с ключевого видеокадра.
+Если аргумент <literal>start</literal> не указывает на ключевой кадр,
+то первоначальные кадры будут скрыты при помощи mp4 edit-листа.
+Edit-листы поддерживаются большинством плееров и браузеров
+включая Chrome, Safari, QuickTime и ffmpeg,
+частично поддерживаются в Firefox.
+</para>
+
+</directive>
+
 </section>
 
 </module>