Johannes Kron 73ff1ffd0f Move spec of experimental RTP header extensions to source repository
The specification of experiemental RTP header extensions have previously
been located at Github. Move the specs here and folloup with redirection
of the new website to this place to make sure that the existing URLs on
the format webrtc.org/experiements/rtp_hdrext continue to work.

Bug: webrtc:11335
Change-Id: I7735e259a7dd6cd2fa7bbc09fa3c0ff460057e52
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/168126
Commit-Queue: Johannes Kron <kron@webrtc.org>
Reviewed-by: Mirko Bonadei <mbonadei@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#30447}
2020-02-03 13:57:17 +00:00

1.6 KiB

The Video Timing extension is used to communicate a timing information on per-frame basis to receiver of rtp video stream. Contact ilnik@google.com for more info. It may be generalized to audio frames as well in the future.

Name: "Video Timing" ; "RTP Header Extension for Video timing"

Formal name: http://www.webrtc.org/experiments/rtp-hdrext/video-timing

SDP "a= name": "video-timing" ; this is also used in client/cloud signaling.

Wire format: 1-byte extension, 13 bytes of data. Total 14 bytes extra per packet (plus 1-3 padding byte in some cases, plus shared 4 bytes for all extensions present: 2 byte magic word 0xBEDE, 2 byte # of extensions).

First byte is a flags field. Defined flags:

  • 0x01 - extension is set due to timer.
  • 0x02 - extension is set because the frame is larger than usual.

Both flags may be set at the same time. All remaining 6 bits are reserved and should be ignored.

Next, 6 timestamps are stored as 16-bit values in big-endian order, representing delta from the capture time of a packet in ms. Timestamps are, in order:

  • Encode start.
  • Encode finish.
  • Packetization complete.
  • Last packet left the pacer.
  • Reserved for network.
  • Reserved for network (2).

Pacer timestamp should be updated inside the RTP packet by pacer component when the last packet (containing the extension) is sent to the network. Last two, reserved timstamps, are not set by the sender but are reserved in packet for any in-network RTP stream processor to modify.

Notes: Extension shoud be present only in the last packet of video frames. If attached to other packets it should be ignored.