Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_hls_module.xml @ 1111:9c766ddc3535
HLS: Translated the "http_ngx_http_hls_module.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 25 Mar 2014 16:21:37 +0400 |
parents | |
children | 65bc9d1ec234 |
comparison
equal
deleted
inserted
replaced
1110:4a4fe2d79d14 | 1111:9c766ddc3535 |
---|---|
1 <?xml version="1.0"?> | |
2 | |
3 <!-- | |
4 Copyright (C) Nginx, Inc. | |
5 --> | |
6 | |
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | |
8 | |
9 <module name="Module ngx_http_hls_module" | |
10 link="/ru/docs/http/ngx_http_hls_module.html" | |
11 lang="ru" | |
12 rev="1"> | |
13 | |
14 <section id="summary"> | |
15 | |
16 <para> | |
17 Модуль <literal>ngx_http_hls_module</literal> обеспечивает серверную поддержку | |
18 протокола HTTP Live Streaming (HLS) для файлов в формате H.264/AAC. | |
19 Такие файлы обычно имеют расширения | |
20 <path>.mp4</path>, <path>.m4v</path> и <path>.m4a</path>. | |
21 </para> | |
22 | |
23 <para> | |
24 nginx поддерживает два вида URI для каждого MP4-файла: | |
25 <list type="bullet"> | |
26 | |
27 <listitem> | |
28 URI плейлиста, имеющий расширение “<literal>.m3u8</literal>” и принимающий | |
29 необязательный параметр “<literal>len</literal>”, | |
30 который задаёт длину фрагмента в секундах; | |
31 </listitem> | |
32 | |
33 <listitem> | |
34 URI фрагмента, имеющий расширение “<literal>.ts</literal>” и принимающий | |
35 аргументы “<literal>start</literal>” и “<literal>end</literal>”, которые | |
36 задают границы фрагмента в секундах. | |
37 </listitem> | |
38 | |
39 </list> | |
40 </para> | |
41 | |
42 <para> | |
43 <note> | |
44 Модуль доступен как часть <commercial_version/>. | |
45 </note> | |
46 </para> | |
47 | |
48 </section> | |
49 | |
50 | |
51 <section id="example" name="Пример конфигурации"> | |
52 | |
53 <para> | |
54 <example> | |
55 location /video/ { | |
56 hls; | |
57 hls_fragment 5s; | |
58 hls_buffers 10 10m; | |
59 hls_mp4_buffer_size 1m; | |
60 hls_mp4_max_buffer_size 5m; | |
61 alias /var/video/; | |
62 } | |
63 </example> | |
64 В такой конфигурации для файла “<path>/var/video/test.mp4</path>” | |
65 будут поддерживаться следующие URI: | |
66 <example> | |
67 http://hls.example.com/video/test.mp4.m3u8?len=8.000 | |
68 http://hls.example.com/video/test.mp4.ts?start=1.000&end=2.200 | |
69 </example> | |
70 </para> | |
71 | |
72 </section> | |
73 | |
74 | |
75 <section id="directives" name="Директивы"> | |
76 | |
77 <directive name="hls"> | |
78 <syntax/> | |
79 <default/> | |
80 <context>location</context> | |
81 | |
82 <para> | |
83 Включает HLS-поток во вложенном location. | |
84 </para> | |
85 | |
86 </directive> | |
87 | |
88 | |
89 <directive name="hls_buffers"> | |
90 <syntax><value>число</value> <value>размер</value></syntax> | |
91 <default>8 2m</default> | |
92 <context>http</context> | |
93 <context>server</context> | |
94 <context>location</context> | |
95 | |
96 <para> | |
97 Задаёт максимальное <value>число</value> и <value>размер</value> буферов, | |
98 которые используются для чтения и записи блоков данных. | |
99 </para> | |
100 | |
101 </directive> | |
102 | |
103 | |
104 <directive name="hls_fragment"> | |
105 <syntax><value>время</value></syntax> | |
106 <default>5s</default> | |
107 <context>http</context> | |
108 <context>server</context> | |
109 <context>location</context> | |
110 | |
111 <para> | |
112 Задаёт длину фрагмента по умолчанию для всех URI в плейлисте, | |
113 запрошенных без аргумента “<literal>len</literal>”. | |
114 </para> | |
115 | |
116 </directive> | |
117 | |
118 | |
119 <directive name="hls_mp4_buffer_size"> | |
120 <syntax><value>размер</value></syntax> | |
121 <default>512k</default> | |
122 <context>http</context> | |
123 <context>server</context> | |
124 <context>location</context> | |
125 | |
126 <para> | |
127 Задаёт начальный <value>размер</value> буфера памяти, используемого для | |
128 обработки MP4-файлов. | |
129 </para> | |
130 | |
131 </directive> | |
132 | |
133 | |
134 <directive name="hls_mp4_max_buffer_size"> | |
135 <syntax><value>размер</value></syntax> | |
136 <default>10m</default> | |
137 <context>http</context> | |
138 <context>server</context> | |
139 <context>location</context> | |
140 | |
141 <para> | |
142 В ходе обработки метаданных может понадобиться буфер большего размера. | |
143 Его <value>размер</value> не может превышать указанного, | |
144 иначе nginx вернёт серверную ошибку | |
145 <http-status code="500" text="Internal Server Error"/> | |
146 и запишет в лог следующее сообщение: | |
147 <example> | |
148 "/some/movie/file.mp4" mp4 moov atom is too large: | |
149 12583268, you may want to increase hls_mp4_max_buffer_size | |
150 </example> | |
151 </para> | |
152 | |
153 </directive> | |
154 | |
155 </section> | |
156 | |
157 </module> |