Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_hls_module.xml @ 1111:9c766ddc3535

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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&amp;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>