Mercurial > hg > nginx-site

changeset 1106:5a7f86254a34

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Mp4: documented the "end" request argument support.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 04 Mar 2014 13:02:21 +0000
parents eb3713019359
children f6e128eb2566
files xml/en/docs/http/ngx_http_mp4_module.xml xml/ru/docs/http/ngx_http_mp4_module.xml
diffstat 2 files changed, 34 insertions(+), 12 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_mp4_module.xml	Tue Mar 04 13:02:21 2014 +0000
+++ b/xml/en/docs/http/ngx_http_mp4_module.xml	Tue Mar 04 13:02:21 2014 +0000
@@ -9,7 +9,7 @@
 <module name="Module ngx_http_mp4_module"
         link="/en/docs/http/ngx_http_mp4_module.html"
         lang="en"
-        rev="5">
+        rev="6">
 
 <section id="summary">
 
@@ -64,17 +64,28 @@
 </para>
 
 <para>
+The module also supports the <literal>end</literal> argument of an HTTP request
+(1.5.13) which sets the end point of playback.
+The <literal>end</literal> argument can be specified with the
+<literal>start</literal> argument
+or separately:
+<example>
+http://example.com/elephants_dream.mp4?start=238.88&amp;end=555.55
+</example>
+</para>
+
+<para>
 For a matching request with a non-zero
-<literal>start</literal>
+<literal>start</literal> or <literal>end</literal>
 argument, nginx will read the metadata from the file, prepare the
-stream starting from the requested offset, and send it to the client.
+stream with the requested time range, and send it to the client.
 This has the same overhead as described above.
 </para>
 
 <para>
 If a matching request does not include the
-<literal>start</literal>
-argument, there is no overhead, and the file is sent simply as a static
+<literal>start</literal> and <literal>end</literal>
+arguments, there is no overhead, and the file is sent simply as a static
 resource.
 Some players also support byte-range requests, and thus do not require
 this module.
--- a/xml/ru/docs/http/ngx_http_mp4_module.xml	Tue Mar 04 13:02:21 2014 +0000
+++ b/xml/ru/docs/http/ngx_http_mp4_module.xml	Tue Mar 04 13:02:21 2014 +0000
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_http_mp4_module"
         link="/ru/docs/http/ngx_http_mp4_module.html"
         lang="ru"
-        rev="5">
+        rev="6">
 
 <section id="summary">
 
@@ -64,16 +64,27 @@
 </para>
 
 <para>
-Для запроса с ненулевым аргументом
-<literal>start</literal>
-nginx считывает из файла метаданные, готовит поток с запрошенного
-смещения и отправляет его клиенту.
+Модуль также поддерживает аргумент <literal>end</literal> HTTP-запроса
+(1.5.13), задающий время окончания воспроизведения потока.
+Аргумент <literal>end</literal> задаётся совместно с
+аргументом <literal>start</literal>
+или самостоятельно:
+<example>
+http://example.com/elephants_dream.mp4?start=238.88&amp;end=555.55
+</example>
+</para>
+
+<para>
+Для запроса с ненулевыми аргументами
+<literal>start</literal> или <literal>end</literal>
+nginx считывает из файла метаданные, готовит поток с запрошенным
+диапазоном и отправляет его клиенту.
 Это тоже требует дополнительных ресурсов, как указано выше.
 </para>
 
 <para>
-Если запрос, обрабатываемый этим модулем, не содержит аргумента
-<literal>start</literal>,
+Если запрос, обрабатываемый этим модулем, не содержит аргументов
+<literal>start</literal> и <literal>end</literal>,
 дополнительные ресурсы не тратятся, а файл отсылается непосредственно как
 статический ресурс.
 Некоторые плееры также поддерживают запросы с указанием диапазона