annotate xml/ru/docs/http/ngx_http_mp4_module.xml @ 2796:bcdb13e1e8c6

Minor updates to ngx_http_mp4_module module intro.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 12 Nov 2021 20:16:05 +0000
parents 1594ed379f1f
children 17ed19394953
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 365
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 365
diff changeset
4 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 365
diff changeset
5 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 365
diff changeset
6
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9 <module name="Модуль ngx_http_mp4_module"
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 link="/ru/docs/http/ngx_http_mp4_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
11 lang="ru"
2796
bcdb13e1e8c6 Minor updates to ngx_http_mp4_module module intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1128
diff changeset
12 rev="8">
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
13
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
14 <section id="summary">
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16 <para>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 148
diff changeset
17 Модуль <literal>ngx_http_mp4_module</literal> обеспечивает серверную поддержку
1105
eb3713019359 The module is no longer restricted to acv1/mp4a.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1104
diff changeset
18 псевдо-стриминга для файлов в формате MP4.
365
b082f02cb7a3 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
19 Такие файлы обычно имеют расширения
148
682163f2b298 Unified article/path and module/pathname into a single "path".
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
20 <path>.mp4</path>, <path>.m4v</path> и <path>.m4a</path>.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23 <para>
2796
bcdb13e1e8c6 Minor updates to ngx_http_mp4_module module intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1128
diff changeset
24 Псевдо-стриминг работает в паре с совместимым медиаплеером.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25 Плеер посылает серверу HTTP-запрос с указанием точки времени старта
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26 в аргументе
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 148
diff changeset
27 <literal>start</literal>
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 строки запроса (время задаётся в секундах), а сервер в
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29 ответ посылает поток, у которого начальная позиция соответствует
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30 запрошенному времени, например:
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
31 <example>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
32 http://example.com/elephants_dream.mp4?start=238.88
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
33 </example>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
34 Это позволяет в любой момент времени выполнить произвольное
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
35 позиционирование, а также начать воспроизведение с середины
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36 временной шкалы.
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 <para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40 В форматах, основанных на H.264, метаданные, необходимые для поддержки
1104
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
41 позиционирования, хранятся в так называемом “moov-атоме”.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 Это часть файла, которая содержит индексную информацию для всего файла.
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 <para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46 До начала воспроизведения плееру необходимо прочитать метаданные.
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47 Для этого он отсылает специальный запрос с аргументом
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 148
diff changeset
48 <literal>start=0</literal>.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 Многие кодирующие программы добавляют метаданные в конец файла.
1104
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
50 Это неоптимально для псевдо-стриминга, поскольку плееру
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
51 потребуется загрузить файл целиком прежде чем начать воспроизведение.
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
52 Если метаданные находятся в начале файла,
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
53 nginx’у достаточно начать отправлять в ответ содержимое файла.
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
54 Если же метаданные находятся в конце файла,
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
55 потребуется прочитать весь
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 файл и подготовить новый поток, в котором метаданные предшествуют
1096
f34be6b26447 Corrected text formatting for ngx_http_mp4_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
57 медийным данным.
f34be6b26447 Corrected text formatting for ngx_http_mp4_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
58 Это требует дополнительного процессорного
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 времени, памяти и дискового ввода/вывода, поэтому лучше
1104
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
60 заранее <link
2796
bcdb13e1e8c6 Minor updates to ngx_http_mp4_module module intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1128
diff changeset
61 url="https://github.com/flowplayer/flowplayer/wiki/7.1.1-video-file-correction">
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 подготовить исходный файл для псевдо-стриминга</link>,
1104
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
63 нежели делать это для каждого запроса.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66 <para>
1106
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
67 Модуль также поддерживает аргумент <literal>end</literal> HTTP-запроса
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
68 (1.5.13), задающий время окончания воспроизведения потока.
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
69 Аргумент <literal>end</literal> задаётся совместно с
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
70 аргументом <literal>start</literal>
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
71 или самостоятельно:
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
72 <example>
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
73 http://example.com/elephants_dream.mp4?start=238.88&amp;end=555.55
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
74 </example>
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
75 </para>
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
76
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
77 <para>
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
78 Для запроса с ненулевыми аргументами
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
79 <literal>start</literal> или <literal>end</literal>
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
80 nginx считывает из файла метаданные, готовит поток с запрошенным
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
81 диапазоном и отправляет его клиенту.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
82 Это тоже требует дополнительных ресурсов, как указано выше.
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85 <para>
1106
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
86 Если запрос, обрабатываемый этим модулем, не содержит аргументов
5a7f86254a34 Mp4: documented the "end" request argument support.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1105
diff changeset
87 <literal>start</literal> и <literal>end</literal>,
1104
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
88 дополнительные ресурсы не тратятся, а файл отсылается непосредственно как
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89 статический ресурс.
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90 Некоторые плееры также поддерживают запросы с указанием диапазона
1104
028f6a4d8046 Corrected punctuation, grammar, style, rephrased some sentences.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1103
diff changeset
91 запрашиваемых байт (byte-range requests), для них этот модуль не требуется.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
94 <para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
95 По умолчанию этот модуль не собирается, его сборку необходимо
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96 разрешить с помощью конфигурационного параметра
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 148
diff changeset
97 <literal>--with-http_mp4_module</literal>.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
98 <note>
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
99 Если ранее использовался сторонний модуль mp4, следует его отключить.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100 </note>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
102
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103 <para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104 Схожая поддержка псевдо-стриминга для FLV-файлов обеспечивается модулем
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
105 <link doc="ngx_http_flv_module.xml">ngx_http_flv_module</link>.
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
108 </section>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
109
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
110
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
111 <section id="example" name="Пример конфигурации">
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
112
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
113 <para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
114 <example>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
115 location /video/ {
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
116 mp4;
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117 mp4_buffer_size 1m;
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118 mp4_max_buffer_size 5m;
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
119 }
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
120 </example>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
121 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
122
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
123 </section>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126 <section id="directives" name="Директивы">
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
127
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
128 <directive name="mp4">
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 87
diff changeset
129 <syntax/>
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
130 <default/>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
131 <context>location</context>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
133 <para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134 Включает в содержащем location обработку этим модулем.
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137 </directive>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140 <directive name="mp4_buffer_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 148
diff changeset
141 <syntax><value>размер</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 87
diff changeset
142 <default>512K</default>
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143 <context>http</context>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 <context>server</context>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
145 <context>location</context>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 <para>
1115
65bc9d1ec234 MP4 and HLS: updated the "buffer size" phrase for _buffer_size directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1106
diff changeset
148 Задаёт начальный размер буфера, используемого при обработке MP4-файлов.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
150
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
151 </directive>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
152
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
153
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
154 <directive name="mp4_max_buffer_size">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 148
diff changeset
155 <syntax><value>размер</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 87
diff changeset
156 <default>10M</default>
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
157 <context>http</context>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
158 <context>server</context>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
159 <context>location</context>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
160
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
161 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 659
diff changeset
162 В ходе обработки метаданных может понадобиться буфер большего размера.
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163 Его размер не может превышать указанного,
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 659
diff changeset
164 иначе nginx вернёт серверную ошибку
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165 <http-status code="500" text="Internal Server Error"/>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 659
diff changeset
166 и запишет в лог следующее сообщение:
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
167 <example>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
168 "/some/movie/file.mp4" mp4 moov atom is too large:
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169 12583268, you may want to increase mp4_max_buffer_size
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170 </example>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 </para>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
172
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173 </directive>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174
1103
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
175
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
176 <directive name="mp4_limit_rate">
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
177 <syntax>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
178 <literal>on</literal> |
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
179 <literal>off</literal> |
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
180 <value>множитель</value></syntax>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
181 <default>off</default>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
182 <context>http</context>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
183 <context>server</context>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
184 <context>location</context>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
185
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
186 <para>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
187 Ограничивает скорость передачи ответа клиенту.
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
188 Ограничение основывается на значении усреднённого битрейта запрашиваемого
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
189 MP4-файла.
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
190 Скорость вычисляется умножением битрейта на задаваемый
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
191 <value>множитель</value>.
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
192 Специальное значение “<literal>on</literal>” соответствует множителю 1.1.
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
193 Специальное значение “<literal>off</literal>” отключает ограничение скорости.
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
194 Ограничение устанавливается на запрос, поэтому, если клиент одновременно
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
195 откроет два соединения, суммарная скорость будет вдвое выше
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
196 заданного ограничения.
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
197 </para>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
198
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
199 <para>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
200 <note>
1128
1594ed379f1f De-i18n'ed <commercial_version/>.
Ruslan Ermilov <ru@nginx.com>
parents: 1115
diff changeset
201 Директива доступна как часть
1594ed379f1f De-i18n'ed <commercial_version/>.
Ruslan Ermilov <ru@nginx.com>
parents: 1115
diff changeset
202 <commercial_version>коммерческой подписки</commercial_version>.
1103
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
203 </note>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
204 </para>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
205
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
206 </directive>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
207
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
208
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
209 <directive name="mp4_limit_rate_after">
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
210 <syntax><value>время</value></syntax>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
211 <default>60s</default>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
212 <context>http</context>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
213 <context>server</context>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
214 <context>location</context>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
215
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
216 <para>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
217 Задаёт начальный объём медиаданных (измеряется как время воспроизведения),
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
218 после отправки которого начинает ограничиваться
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
219 скорость передачи ответа клиенту.
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
220 </para>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
221
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
222 <para>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
223 <note>
1128
1594ed379f1f De-i18n'ed <commercial_version/>.
Ruslan Ermilov <ru@nginx.com>
parents: 1115
diff changeset
224 Директива доступна как часть
1594ed379f1f De-i18n'ed <commercial_version/>.
Ruslan Ermilov <ru@nginx.com>
parents: 1115
diff changeset
225 <commercial_version>коммерческой подписки</commercial_version>.
1103
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
226 </note>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
227 </para>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
228
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
229 </directive>
1fcf8c840dbe Corrected EN text of mp4_limit_rate, mp4_limit_rate_after, translated into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1096
diff changeset
230
87
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
231 </section>
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
232
f5539fb36bbb Russian translation of ngx_http_mp4_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
233 </module>