Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_mp4_module.xml @ 271:4c6d2c614d2c

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