comparison xml/en/docs/http/ngx_http_mp4_module.xml @ 1106:5a7f86254a34

Mp4: documented the "end" request argument support.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 04 Mar 2014 13:02:21 +0000
parents eb3713019359
children 65bc9d1ec234
comparison
equal deleted inserted replaced
1105:eb3713019359 1106:5a7f86254a34
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Module ngx_http_mp4_module" 9 <module name="Module ngx_http_mp4_module"
10 link="/en/docs/http/ngx_http_mp4_module.html" 10 link="/en/docs/http/ngx_http_mp4_module.html"
11 lang="en" 11 lang="en"
12 rev="5"> 12 rev="6">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 The <literal>ngx_http_mp4_module</literal> module provides pseudo-streaming 17 The <literal>ngx_http_mp4_module</literal> module provides pseudo-streaming
62 prepare an original file for pseudo-streaming</link> in advance, 62 prepare an original file for pseudo-streaming</link> in advance,
63 rather than having nginx do this on every such request. 63 rather than having nginx do this on every such request.
64 </para> 64 </para>
65 65
66 <para> 66 <para>
67 The module also supports the <literal>end</literal> argument of an HTTP request
68 (1.5.13) which sets the end point of playback.
69 The <literal>end</literal> argument can be specified with the
70 <literal>start</literal> argument
71 or separately:
72 <example>
73 http://example.com/elephants_dream.mp4?start=238.88&amp;end=555.55
74 </example>
75 </para>
76
77 <para>
67 For a matching request with a non-zero 78 For a matching request with a non-zero
68 <literal>start</literal> 79 <literal>start</literal> or <literal>end</literal>
69 argument, nginx will read the metadata from the file, prepare the 80 argument, nginx will read the metadata from the file, prepare the
70 stream starting from the requested offset, and send it to the client. 81 stream with the requested time range, and send it to the client.
71 This has the same overhead as described above. 82 This has the same overhead as described above.
72 </para> 83 </para>
73 84
74 <para> 85 <para>
75 If a matching request does not include the 86 If a matching request does not include the
76 <literal>start</literal> 87 <literal>start</literal> and <literal>end</literal>
77 argument, there is no overhead, and the file is sent simply as a static 88 arguments, there is no overhead, and the file is sent simply as a static
78 resource. 89 resource.
79 Some players also support byte-range requests, and thus do not require 90 Some players also support byte-range requests, and thus do not require
80 this module. 91 this module.
81 </para> 92 </para>
82 93