From a507af97eef468238d545ff954a39d7432832e54 Mon Sep 17 00:00:00 2001 From: Sven Dueking Date: Mon, 21 May 2018 14:40:17 +0700 Subject: avformat/libsrt: add latency options and deprecate tspbdelay Signed-off-by: Sven Dueking Signed-off-by: Luca Barbato --- doc/protocols.texi | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) (limited to 'doc/protocols.texi') diff --git a/doc/protocols.texi b/doc/protocols.texi index 5b625e571b..c3d6e150e0 100644 --- a/doc/protocols.texi +++ b/doc/protocols.texi @@ -710,6 +710,17 @@ IP Type of Service. Applies to sender only. Default value is 0xB8. @item ipttl=@var{ttl} IP Time To Live. Applies to sender only. Default value is 64. +@item latency +Timestamp-based Packet Delivery Delay. +Used to absorb bursts of missed packet retransmissions. +This flag sets both @option{rcvlatency} and @option{peerlatency} +to the same value. Note that prior to version 1.3.0 +this is the only flag to set the latency, however +this is effectively equivalent to setting @option{peerlatency}, +when side is sender and @option{rcvlatency} +when side is receiver, and the bidirectional stream +sending is not supported. + @item listen_timeout Set socket listen timeout. @@ -766,6 +777,10 @@ wrapping a live stream in very small frames, then you can use a bigger maximum frame size, though not greater than 1456 bytes. +@item peerlatency +The latency value (as described in @option{rcvlatency}) that is +set by the sender side as a minimum value for the receiver. + @item pbkeylen=@var{bytes} Sender encryption key length, in bytes. Only can be set to 0, 16, 24 and 32. @@ -774,6 +789,18 @@ Not required on receiver (set to 0), key size obtained from sender in HaiCrypt handshake. Default value is 0. +@item rcvlatency +The time that should elapse since the moment when the +packet was sent and the moment when it's delivered to +the receiver application in the receiving function. +This time should be a buffer time large enough to cover +the time spent for sending, unexpectedly extended RTT +time, and the time needed to retransmit the lost UDP +packet. The effective latency value will be the maximum +of this options' value and the value of @option{peerlatency} +set by the peer side. Before version 1.3.0 this option +is only available as @option{latency}. + @item recv_buffer_size=@var{bytes} Set receive buffer size, expressed in bytes. @@ -798,10 +825,6 @@ have no chance of being delivered in time. It was automatically enabled in the sender if the receiver supports it. -@item tsbpddelay -Timestamp-based Packet Delivery Delay. -Used to absorb burst of missed packet retransmission. - @end table For more information see: @url{https://github.com/Haivision/srt}. -- cgit v1.2.3