FFmpeg协议文档

àì夳堔傛蜴生んèń 2022-12-05 12:18 345阅读 0赞

### 文章目录 ###

*  实时流协议(rtsp)
 *   *  支持以下选项(options)
     *   *  initial\_pause
         *  rtsp\_transport
         *  rtsp\_flags
         *  allowed\_media\_types
         *  min\_port
         *  max\_port
         *  timeout
         *  reorder\_queue\_size
         *  stimeout
         *  user-agent
     *  示例：examples
     *   *  Java代码示例
 *  实时消息传递协议（rtmp）
 *   *  可接受的参数为：
     *   *  username
         *  password
         *  server
         *  port
         *  app
         *  playpath
         *  listen
         *  timeout
         *  rtmp\_app
         *  rtmp\_buffer
         *  rtmp\_conn
         *  rtmp\_flashver
         *  rtmp\_flush\_interval
         *  rtmp\_live
         *  rtmp\_pageurl
         *  rtmp\_playpath
         *  rtmp\_subscribe
         *  rtmp\_swfhash
         *  rtmp\_swfsize
         *  rtmp\_swfurl
         *  rtmp\_swfverify
         *  rtmp\_tcurl
     *  examples
 *  传输控制协议(tcp)
 *   *  listen=1|0
     *  timeout=microseconds
     *  listen\_timeout=milliseconds
     *  recv\_buffer\_size=bytes
     *  send\_buffer\_size=bytes
     *  tcp\_nodelay=1|0
     *  tcp\_mss=bytes
 *  hls

# 实时流协议(rtsp) #

RTSP在技术上不是libavformat中的协议处理程序，而是一个demuxer和muxer。demuxer支持普通的RTSP（通过RTP传输数据；这是Apple和Microsoft等公司使用的）和Real RTSP（通过RDT传输数据）。

RTSP url所需的语法为：

rtsp://hostname[:port]/path

选项可以在ffmpeg/ffplay命令行上设置，也可以通过AVOptions在代码中设置，或者在avformat\_open\_输入中设置。

## 支持以下选项(options) ##

### initial\_pause ###

初始暂停

如果设置为1，请不要立即开始播放流。默认值为0。

### rtsp\_transport ###

设置RTSP传输协议。

它接受以下值：

*  “udp”

使用UDP作为较低的传输协议。

*  “tcp”

使用TCP（RTSP控制通道内的交错）作为较低的传输协议。

*  “udp\_multicast”

使用UDP多播作为较低的传输协议。

*  “http”

使用HTTP隧道作为较低的传输协议，这对于传递代理很有用。

可以指定多个较低的传输协议，在这种情况下，一次尝试一个协议（如果一个协议的设置失败，则尝试下一个协议）。对于muxer，只支持“tcp”和“udp”选项。

### rtsp\_flags ###

可接受以下值：

*  filter\_src：只接受来自协商的对等地址和端口的数据包。
 *  listen：充当服务器，监听传入的连接。
 *  prefer\_tcp：如果TCP可用作RTSP RTP传输，请先尝试使用TCP进行RTP传输。

默认值为“无”。

### allowed\_media\_types ###

允许的媒体类型

将媒体类型设置为从服务器接受。

接受以下标志：

*  ‘video’
 *  ‘audio’
 *  ‘data’

默认情况下，它接受所有媒体类型。

### min\_port ###

设置最小本地UDP端口。默认值为5000。

### max\_port ###

设置最大本地UDP端口。默认值为65000。

### timeout ###

设置等待传入连接的最大超时（秒）。

值-1表示无穷大（默认值）。此选项意味着将rtsp\_标志设置为“listen”。

### reorder\_queue\_size ###

设置用于处理重新排序的数据包的缓冲区的数据包数。

### stimeout ###

以微秒为单位设置套接字TCP I/O超时。

### user-agent ###

重写用户代理头。如果未指定，则默认为libavformat标识符字符串。

当通过UDP接收数据时，demuxer会尝试对接收到的数据包进行重新排序（因为它们可能会无序到达，或者数据包可能会完全丢失）。这可以通过将最大解复用延迟设置为零（通过AVFormatContext的max\_delay字段）来禁用。

当用ffplay观看多比特率的实时RTSP流时，可以用-vst n和-ast n分别选择视频和音频要显示的流，并且可以通过按v和a来动态切换。

## 示例：examples ##

通过UDP观看流，最大重新排序延迟为0.5秒：

ffplay -max_delay 500000 -rtsp_transport udp rtsp://server/video.mp4

观察一个stream tunneled over HTTP：

ffplay -rtsp_transport http rtsp://server/video.mp4

将流实时发送到RTSP服务器，供其他人观看：

ffmpeg -re -i input -f rtsp -muxdelay 0.1 rtsp://server/live.sdp

实时接收流：

ffmpeg -rtsp_flags listen -i rtsp://ownaddress/live.sdp output

### Java代码示例 ###

/** * 读流器 */
    private FFmpegFrameGrabber grabber;
    
     try { 
         grabber = new FFmpegFrameGrabber(url);
         if ("rtsp".equals(url.substring(0, 4))) { 
             //rw_timeout：等待（网络）读/写操作完成的最长时间（微秒）。
             //1秒= 1000000 微妙
             grabber.setOption("rtsp_transport", "tcp");
             grabber.setOption("stimeout", "5000000");
         } else { 
             grabber.setOption("timeout", "5000000");
         }
         grabber.start();

# 实时消息传递协议（rtmp） #

实时消息传递协议（RTMP）用于在TCP/IP网络上传输多媒体内容。

所需的语法是：

rtmp://[username:password@]server[:port][/app][/instance][/playpath]

## 可接受的参数为： ##

### username ###

An optional username (mostly for publishing).

### password ###

An optional password (mostly for publishing).

### server ###

The address of the RTMP server.

### port ###

The number of the TCP port to use (by default is 1935).

### app ###

It is the name of the application to access. It usually corresponds to the path where the application is installed on the RTMP server (e.g. /ondemand/, /flash/live/, etc.). You can override the value parsed from the URI through the `rtmp_app` option, too.

### playpath ###

It is the path or name of the resource to play with reference to the application specified in app, may be prefixed by “mp4:”. You can override the value parsed from the URI through the `rtmp_playpath` option, too.

### listen ###

Act as a server, listening for an incoming connection.

### timeout ###

Maximum time to wait for the incoming connection. Implies listen.

Additionally, the following parameters can be set via command line options (or in code via `AVOption`s):

### rtmp\_app ###

Name of application to connect on the RTMP server. This option overrides the parameter specified in the URI.

### rtmp\_buffer ###

Set the client buffer time in milliseconds. The default is 3000.

### rtmp\_conn ###

Extra arbitrary AMF connection parameters, parsed from a string, e.g. like `B:1 S:authMe O:1 NN:code:1.23 NS:flag:ok O:0`. Each value is prefixed by a single character denoting the type, B for Boolean, N for number, S for string, O for object, or Z for null, followed by a colon. For Booleans the data must be either 0 or 1 for FALSE or TRUE, respectively. Likewise for Objects the data must be 0 or 1 to end or begin an object, respectively. Data items in subobjects may be named, by prefixing the type with ’N’ and specifying the name before the value (i.e. `NB:myFlag:1`). This option may be used multiple times to construct arbitrary AMF sequences.

### rtmp\_flashver ###

Version of the Flash plugin used to run the SWF player. The default is LNX 9,0,124,2. (When publishing, the default is FMLE/3.0 (compatible; ).)

### rtmp\_flush\_interval ###

Number of packets flushed in the same request (RTMPT only). The default is 10.

### rtmp\_live ###

Specify that the media is a live stream. No resuming or seeking in live streams is possible. The default value is `any`, which means the subscriber first tries to play the live stream specified in the playpath. If a live stream of that name is not found, it plays the recorded stream. The other possible values are `live` and `recorded`.

### rtmp\_pageurl ###

URL of the web page in which the media was embedded. By default no value will be sent.

### rtmp\_playpath ###

Stream identifier to play or to publish. This option overrides the parameter specified in the URI.

### rtmp\_subscribe ###

Name of live stream to subscribe to. By default no value will be sent. It is only sent if the option is specified or if rtmp\_live is set to live.

### rtmp\_swfhash ###

SHA256 hash of the decompressed SWF file (32 bytes).

### rtmp\_swfsize ###

Size of the decompressed SWF file, required for SWFVerification.

### rtmp\_swfurl ###

URL of the SWF player for the media. By default no value will be sent.