Mercurial > hg > nginx-site
changeset 1106:5a7f86254a34
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 +++ b/xml/en/docs/http/ngx_http_mp4_module.xml @@ -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 @@ rather than having nginx do this on ever </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&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 +++ b/xml/ru/docs/http/ngx_http_mp4_module.xml @@ -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 @@ url="http://flowplayer.org/plugins/strea </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&end=555.55 +</example> +</para> + +<para> +Для запроса с ненулевыми аргументами +<literal>start</literal> или <literal>end</literal> +nginx считывает из файла метаданные, готовит поток с запрошенным +диапазоном и отправляет его клиенту. Это тоже требует дополнительных ресурсов, как указано выше. </para> <para> -Если запрос, обрабатываемый этим модулем, не содержит аргумента -<literal>start</literal>, +Если запрос, обрабатываемый этим модулем, не содержит аргументов +<literal>start</literal> и <literal>end</literal>, дополнительные ресурсы не тратятся, а файл отсылается непосредственно как статический ресурс. Некоторые плееры также поддерживают запросы с указанием диапазона