comparison xml/ru/docs/http/ngx_http_hls_module.xml @ 1476:c20c2b945f8c

Added new URI arguments, corrected file formats in hls.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 15 May 2015 16:11:59 +0300
parents 0ffd5caf0766
children ad8a1fae0b72
comparison
equal deleted inserted replaced
1475:1179ca80e110 1476:c20c2b945f8c
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Module ngx_http_hls_module" 9 <module name="Module ngx_http_hls_module"
10 link="/ru/docs/http/ngx_http_hls_module.html" 10 link="/ru/docs/http/ngx_http_hls_module.html"
11 lang="ru" 11 lang="ru"
12 rev="4"> 12 rev="5">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_http_hls_module</literal> обеспечивает серверную поддержку 17 Модуль <literal>ngx_http_hls_module</literal> обеспечивает серверную поддержку
18 протокола HTTP Live Streaming (HLS) для файлов в формате H.264/AAC. 18 протокола HTTP Live Streaming (HLS) для медиафайлов в формате MP4 и MOV.
19 Такие файлы обычно имеют расширения 19 Такие файлы обычно имеют расширения <path>.mp4</path>, <path>.m4v</path>
20 <path>.mp4</path>, <path>.m4v</path> и <path>.m4a</path>. 20 <path>.m4a</path>, <path>.mov</path> или <path>.qt</path>.
21 </para> 21 Модуль поддерживает видеокодек H.264, аудиокодеки AAC и MP3.
22 22 </para>
23 <para> 23
24 nginx поддерживает два вида URI для каждого MP4-файла: 24 <para>
25 Для каждого медиафайла поддерживается два вида URI:
25 <list type="bullet"> 26 <list type="bullet">
26 27
27 <listitem> 28 <listitem>
28 URI плейлиста, имеющий расширение “<literal>.m3u8</literal>” и принимающий 29 URI плейлиста, имеющего расширение “<literal>.m3u8</literal>”.
29 необязательный аргумент “<literal>len</literal>”, 30 URI может принимать необязательные аргументы:
30 который задаёт длину фрагмента в секундах; 31 <list type="bullet">
31 </listitem> 32
32 33 <listitem>
33 <listitem> 34 “<literal>start</literal>” и “<literal>end</literal>”
34 URI фрагмента, имеющий расширение “<literal>.ts</literal>” и принимающий 35 задают границы плейлиста в секундах (1.9.0);
36 </listitem>
37
38 <listitem>
39 “<literal>offset</literal>” сдвигает первоначальную позицию воспроизведения
40 на указанное время в секундах (1.9.0).
41 Положительное значение задаёт временной сдвиг с начала плейлиста.
42 Отрицательное значение задаёт временной сдвиг с конца последнего фрагмента
43 в плейлисте;
44 </listitem>
45
46 <listitem>
47 “<literal>len</literal>” задаёт длину фрагмента в секундах,
48 </listitem>
49 </list>
50
51 </listitem>
52
53 <listitem>
54 URI фрагмента, имеющего расширение “<literal>.ts</literal>”.
55 URI может принимать необязательные
35 аргументы “<literal>start</literal>” и “<literal>end</literal>”, которые 56 аргументы “<literal>start</literal>” и “<literal>end</literal>”, которые
36 задают границы фрагмента в секундах. 57 задают границы фрагмента в секундах.
37 </listitem> 58 </listitem>
38 59
39 </list> 60 </list>
63 } 84 }
64 </example> 85 </example>
65 В такой конфигурации для файла “<path>/var/video/test.mp4</path>” 86 В такой конфигурации для файла “<path>/var/video/test.mp4</path>”
66 будут поддерживаться следующие URI: 87 будут поддерживаться следующие URI:
67 <example> 88 <example>
89 http://hls.example.com/video/test.mp4.m3u8?offset=1.000&amp;start=1.000&amp;end=2.200
68 http://hls.example.com/video/test.mp4.m3u8?len=8.000 90 http://hls.example.com/video/test.mp4.m3u8?len=8.000
69 http://hls.example.com/video/test.mp4.ts?start=1.000&amp;end=2.200 91 http://hls.example.com/video/test.mp4.ts?start=1.000&amp;end=2.200
70 </example> 92 </example>
71 </para> 93 </para>
72 94
216 <context>server</context> 238 <context>server</context>
217 <context>location</context> 239 <context>location</context>
218 240
219 <para> 241 <para>
220 Задаёт начальный <value>размер</value> буфера, используемого для 242 Задаёт начальный <value>размер</value> буфера, используемого для
221 обработки MP4-файлов. 243 обработки MP4 и MOV-файлов.
222 </para> 244 </para>
223 245
224 </directive> 246 </directive>
225 247
226 248