Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_mp4_module.xml @ 271:4c6d2c614d2c
Cleaned up XML tag mess:
- all of <parameter> and <code>, and some of <dirname>, <value>,
and <command> were replaced by <literal>;
- the rest of <dirname> were replaced by links;
- <argument> were replaced by <value>;
- <value> is now rendered in HTML in italic;
- <literal> and <path> can now contain <value>.
Cleaned up terminology mess:
- directives take "parameters".
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Fri, 23 Dec 2011 17:29:59 +0000 |
parents | 682163f2b298 |
children | b082f02cb7a3 |
comparison
equal
deleted
inserted
replaced
270:945d7299c26c | 271:4c6d2c614d2c |
---|---|
7 lang="ru"> | 7 lang="ru"> |
8 | 8 |
9 <section id="summary"> | 9 <section id="summary"> |
10 | 10 |
11 <para> | 11 <para> |
12 Модуль <code>ngx_http_mp4_module</code> обеспечивает серверную поддержку | 12 Модуль <literal>ngx_http_mp4_module</literal> обеспечивает серверную поддержку |
13 псевдо-стриминга для файлов в формате H.264/AAC. Такие файлы обычно | 13 псевдо-стриминга для файлов в формате H.264/AAC. Такие файлы обычно |
14 имеют расширения | 14 имеют расширения |
15 <path>.mp4</path>, <path>.m4v</path> и <path>.m4a</path>. | 15 <path>.mp4</path>, <path>.m4v</path> и <path>.m4a</path>. |
16 </para> | 16 </para> |
17 | 17 |
18 <para> | 18 <para> |
19 Псевдо-стриминг работает в паре с совместимым Flash-плеером. | 19 Псевдо-стриминг работает в паре с совместимым Flash-плеером. |
20 Плеер посылает серверу HTTP-запрос с указанием точки времени старта | 20 Плеер посылает серверу HTTP-запрос с указанием точки времени старта |
21 в аргументе | 21 в аргументе |
22 <parameter>start</parameter> | 22 <literal>start</literal> |
23 строки запроса (время задаётся в секундах), а сервер в | 23 строки запроса (время задаётся в секундах), а сервер в |
24 ответ посылает поток, у которого начальная позиция соответствует | 24 ответ посылает поток, у которого начальная позиция соответствует |
25 запрошенному времени, например: | 25 запрошенному времени, например: |
26 <example> | 26 <example> |
27 http://example.com/elephants_dream.mp4?start=238.88 | 27 http://example.com/elephants_dream.mp4?start=238.88 |
38 </para> | 38 </para> |
39 | 39 |
40 <para> | 40 <para> |
41 До начала воспроизведения плееру необходимо прочитать метаданные. | 41 До начала воспроизведения плееру необходимо прочитать метаданные. |
42 Для этого он отсылает специальный запрос с аргументом | 42 Для этого он отсылает специальный запрос с аргументом |
43 <parameter>start=0</parameter>. | 43 <literal>start=0</literal>. |
44 Многие кодирующие программы добавляют метаданные в конец файла. | 44 Многие кодирующие программы добавляют метаданные в конец файла. |
45 Для псевдо-стриминга это плохо: метаданные должны быть расположены | 45 Для псевдо-стриминга это плохо: метаданные должны быть расположены |
46 в начале файла, иначе потребуется загрузить файл целиком, прежде | 46 в начале файла, иначе потребуется загрузить файл целиком, прежде |
47 чем начать воспроизведение. Если файл отформатирован хорошо, | 47 чем начать воспроизведение. Если файл отформатирован хорошо, |
48 с метаданными в начале файла, nginx просто посылает в ответ | 48 с метаданными в начале файла, nginx просто посылает в ответ |
56 нежели чем заставлять nginx делать это для каждого запроса. | 56 нежели чем заставлять nginx делать это для каждого запроса. |
57 </para> | 57 </para> |
58 | 58 |
59 <para> | 59 <para> |
60 Для запроса с ненулевым аргументом | 60 Для запроса с ненулевым аргументом |
61 <parameter>start</parameter> | 61 <literal>start</literal> |
62 nginx считывает из файла метаданные, готовит поток с запрошенного | 62 nginx считывает из файла метаданные, готовит поток с запрошенного |
63 смещения, и отправляет его клиенту. | 63 смещения, и отправляет его клиенту. |
64 Это тоже требует дополнительных ресурсов, как указано выше. | 64 Это тоже требует дополнительных ресурсов, как указано выше. |
65 </para> | 65 </para> |
66 | 66 |
67 <para> | 67 <para> |
68 Если запрос, обрабатываемый этим модулем, не содержит аргумента | 68 Если запрос, обрабатываемый этим модулем, не содержит аргумента |
69 <parameter>start</parameter>, | 69 <literal>start</literal>, |
70 дополнительные ресурсы не тратятся, а файл отсылается просто как | 70 дополнительные ресурсы не тратятся, а файл отсылается просто как |
71 статический ресурс. | 71 статический ресурс. |
72 Некоторые плееры также поддерживают запросы с указанием диапазона | 72 Некоторые плееры также поддерживают запросы с указанием диапазона |
73 запрашиваемых байт (byte-range requests), для них вообще не | 73 запрашиваемых байт (byte-range requests), для них вообще не |
74 требуется этот модуль. | 74 требуется этот модуль. |
75 </para> | 75 </para> |
76 | 76 |
77 <para> | 77 <para> |
78 По умолчанию этот модуль не собирается, его сборку необходимо | 78 По умолчанию этот модуль не собирается, его сборку необходимо |
79 разрешить с помощью конфигурационного параметра | 79 разрешить с помощью конфигурационного параметра |
80 <code>--with-http_mp4_module</code>. | 80 <literal>--with-http_mp4_module</literal>. |
81 <note> | 81 <note> |
82 Если вы ранее использовали сторонний модуль mp4, не забудьте его отключить. | 82 Если вы ранее использовали сторонний модуль mp4, не забудьте его отключить. |
83 </note> | 83 </note> |
84 </para> | 84 </para> |
85 | 85 |
119 | 119 |
120 </directive> | 120 </directive> |
121 | 121 |
122 | 122 |
123 <directive name="mp4_buffer_size"> | 123 <directive name="mp4_buffer_size"> |
124 <syntax><argument>размер</argument></syntax> | 124 <syntax><value>размер</value></syntax> |
125 <default>512K</default> | 125 <default>512K</default> |
126 <context>http</context> | 126 <context>http</context> |
127 <context>server</context> | 127 <context>server</context> |
128 <context>location</context> | 128 <context>location</context> |
129 | 129 |
133 | 133 |
134 </directive> | 134 </directive> |
135 | 135 |
136 | 136 |
137 <directive name="mp4_max_buffer_size"> | 137 <directive name="mp4_max_buffer_size"> |
138 <syntax><argument>размер</argument></syntax> | 138 <syntax><value>размер</value></syntax> |
139 <default>10M</default> | 139 <default>10M</default> |
140 <context>http</context> | 140 <context>http</context> |
141 <context>server</context> | 141 <context>server</context> |
142 <context>location</context> | 142 <context>location</context> |
143 | 143 |