Mercurial > hg > nginx-quic
annotate docs/xml/http/ngx_http_mp4_module.xml @ 4120:42135dd1f0ea
Upstream: keepalive flag.
This patch introduces r->upstream->keepalive flag, which is set by protocol
handlers if connection to upstream is in good state and can be kept alive.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Thu, 15 Sep 2011 19:03:15 +0000 |
parents | d889195c8db4 |
children | a18b10aea510 |
rev | line source |
---|---|
4110
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1 <?xml version="1.0"?> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
2 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
3 <!DOCTYPE module SYSTEM "../../dtd/module.dtd"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
4 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
5 <module name="HTTP MP4 Module" id="http_mp4_module"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
6 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
7 <section name="Summary"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
8 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
9 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
10 The module <code>ngx_http_mp4_module</code> provides pseudo-streaming |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
11 server-side support for H.264/AAC files typically having filename extensions |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
12 <pathname>.mp4</pathname>, <pathname>.m4v</pathname>, |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
13 and <pathname>.m4a</pathname>. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
14 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
15 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
16 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
17 Pseudo-streaming works in alliance with conformant Flash players. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
18 A player sends an HTTP request to the server with a start time |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
19 argument in the request URI’s query string (named simply |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 <parameter>start</parameter> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
21 and specified in seconds), and the server responds with a stream |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
22 so that its start position corresponds to the requested time, |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
23 for example: |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
24 <example> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
25 http://example.com/elephants_dream.mp4?start=238.88 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 </example> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 This allows for a random seeking at any time, or starting playback |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
28 in the middle of a timeline. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
29 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
30 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 To support seeking, H.264-based formats store the metadata |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 in the so-called “moov atom.” |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 It is a part of the file that holds the index information for the |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 whole file. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 To start playback, a player first needs to read metadata. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
40 This is done by sending a special request with the |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 <parameter>start=0</parameter> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 argument. Many encoding software will insert the metadata at |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 the end of the file. This is bad for pseudo-streaming: |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 the metadata needs to be located at the beginning of the file, |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 or else the entire file will have to be downloaded before it |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
46 starts playing. If a file is well-formed (with metadata at the |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
47 beginning of a file), nginx just sends back the contents of a file. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
48 Otherwise, it has to read the file and prepare a new stream so that |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
49 metadata comes before media data. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
50 This involves some CPU, memory, and disk I/O overhead, |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
51 so it is a good idea to |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
52 <link url="http://flowplayer.org/plugins/streaming/pseudostreaming.html#prepare"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
53 prepare an original file for pseudo-streaming</link>, |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
54 rather than having nginx do this on every such request. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
55 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
56 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
57 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
58 For a matching request with a non-zero |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
59 <parameter>start</parameter> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
60 argument, nginx will read metadata from the file, prepare the |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
61 stream starting from the requested offset, and send it to a client. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
62 This has the same overhead as described above. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
63 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
64 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
65 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 If a matching request does not include the |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
67 <parameter>start</parameter> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
68 argument, there is no overhead, and the file is just sent as a static resource. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
69 Some players also support byte-range requests, and thus do not require |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
70 this module at all. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
71 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
72 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
73 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
74 This module is not built by default, it should be enabled with the |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
75 <command>--with-http_mp4_module</command> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
76 configuration parameter. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
77 <note> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
78 If you were using the third-party mp4 module, be sure to disable it. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
79 </note> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
80 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
83 A similar pseudo-streaming support for FLV files is provided by the module |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 <link doc="ngx_http_flv_module.xml">ngx_http_flv_module</link>. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
85 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
86 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
87 </section> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
88 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
89 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
90 <section id="example" name="Example Configuration"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
91 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
92 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
93 <example> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
94 location /video/ { |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
95 mp4; |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
96 mp4_buffer_size 1m; |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
97 mp4_max_buffer_size 5m; |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
98 } |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
99 </example> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
100 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
101 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
102 </section> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
103 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
105 <section id="directives" name="Directives"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
106 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
107 <directive name="mp4"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
108 <syntax>mp4</syntax> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
109 <default/> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
110 <context>location</context> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
111 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
112 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
113 Turns on module processing in a surrounding location. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
114 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
115 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
116 </directive> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
117 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
118 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
119 <directive name="mp4_buffer_size"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
120 <syntax>mp4_buffer_size <argument>size</argument></syntax> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
121 <default>mp4_buffer_size 512K</default> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
122 <context>http</context> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
123 <context>server</context> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
124 <context>location</context> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
125 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
126 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
127 Sets the initial size of a memory buffer used to process MP4 files. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
128 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
129 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
130 </directive> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
131 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
132 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
133 <directive name="mp4_max_buffer_size"> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
134 <syntax>mp4_max_buffer_size <argument>size</argument></syntax> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
135 <default>mp4_max_buffer_size 10M</default> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
136 <context>http</context> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
137 <context>server</context> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
138 <context>location</context> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
139 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
140 <para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
141 During metadata processing, a larger buffer may become necessary. |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
142 Its size cannot exceed the specified <argument>size</argument>, |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
143 or else nginx will return the server error |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
144 <http-status code="500" text="Internal Server Error"/>, |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
145 and log the following: |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
146 <example> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
147 "/some/movie/file.mp4" mp4 moov atom is too large: |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
148 12583268, you may want to increase mp4_max_buffer_size |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
149 </example> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
150 </para> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
151 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
152 </directive> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
153 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
154 </section> |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
155 |
d889195c8db4
Added ngx_http_mp4_module documentation.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
156 </module> |