The GstRTPBuffer helper functions makes it easy to parse and create regular GstBuffer objects that contain RTP payloads. These buffers are typically of 'application/x-rtp' GstCaps.

enum GstRTPPayload

typedef enum
{
  /* Audio: */
  GST_RTP_PAYLOAD_PCMU = 0,
  GST_RTP_PAYLOAD_1016 = 1, /* RFC 3551 says reserved */
  GST_RTP_PAYLOAD_G721 = 2, /* RFC 3551 says reserved */
  GST_RTP_PAYLOAD_GSM = 3,
  GST_RTP_PAYLOAD_G723 = 4,
  GST_RTP_PAYLOAD_DVI4_8000 = 5,
  GST_RTP_PAYLOAD_DVI4_16000 = 6,
  GST_RTP_PAYLOAD_LPC = 7,
  GST_RTP_PAYLOAD_PCMA = 8,
  GST_RTP_PAYLOAD_G722 = 9,
  GST_RTP_PAYLOAD_L16_STEREO = 10,
  GST_RTP_PAYLOAD_L16_MONO = 11,
  GST_RTP_PAYLOAD_QCELP = 12,
  GST_RTP_PAYLOAD_CN = 13,
  GST_RTP_PAYLOAD_MPA = 14,
  GST_RTP_PAYLOAD_G728 = 15,
  GST_RTP_PAYLOAD_DVI4_11025 = 16,
  GST_RTP_PAYLOAD_DVI4_22050 = 17,
  GST_RTP_PAYLOAD_G729 = 18,   

  /* Video: */

  GST_RTP_PAYLOAD_CELLB = 25,
  GST_RTP_PAYLOAD_JPEG = 26,
  GST_RTP_PAYLOAD_NV = 28,
  GST_RTP_PAYLOAD_H261 = 31,
  GST_RTP_PAYLOAD_MPV = 32,
  GST_RTP_PAYLOAD_MP2T = 33,
  GST_RTP_PAYLOAD_H263 = 34,

  /* BOTH */
} GstRTPPayload;

Standard predefined fixed payload types.

The official list is at: http://www.iana.org/assignments/rtp-parameters

Audio: reserved: 19 unassigned: 20-23,

Video: unassigned: 24, 27, 29, 30, 35-71, 77-95 Reserved for RTCP conflict avoidance: 72-76

GST_RTP_VERSION

#define GST_RTP_VERSION 2

The supported RTP version 2.

gst_rtp_buffer_allocate_data ()

void                gst_rtp_buffer_allocate_data        (GstBuffer *buffer,
                                                         guint payload_len,
                                                         guint8 pad_len,
                                                         guint8 csrc_count);

Allocate enough data in buffer to hold an RTP packet with csrc_count CSRCs, a payload length of payload_len and padding of pad_len. MALLOCDATA of buffer will be overwritten and will not be freed. All other RTP header fields will be set to 0/FALSE.

gst_rtp_buffer_calc_header_len ()

guint               gst_rtp_buffer_calc_header_len      (guint8 csrc_count);

Calculate the header length of an RTP packet with csrc_count CSRC entries. An RTP packet can have at most 15 CSRC entries.

gst_rtp_buffer_calc_packet_len ()

guint               gst_rtp_buffer_calc_packet_len      (guint payload_len,
                                                         guint8 pad_len,
                                                         guint8 csrc_count);

Calculate the total length of an RTP packet with a payload size of payload_len, a padding of pad_len and a csrc_count CSRC entries.

gst_rtp_buffer_calc_payload_len ()

guint               gst_rtp_buffer_calc_payload_len     (guint packet_len,
                                                         guint8 pad_len,
                                                         guint8 csrc_count);

Calculate the length of the payload of an RTP packet with size packet_len, a padding of pad_len and a csrc_count CSRC entries.

gst_rtp_buffer_default_clock_rate ()

guint32             gst_rtp_buffer_default_clock_rate   (guint8 payload_type);

Get the default clock-rate for the static payload type payload_type.

Since 0.10.13

gst_rtp_buffer_get_csrc ()

guint32             gst_rtp_buffer_get_csrc             (GstBuffer *buffer,
                                                         guint8 idx);

Get the CSRC at index idx in buffer.

gst_rtp_buffer_get_csrc_count ()

guint8              gst_rtp_buffer_get_csrc_count       (GstBuffer *buffer);

Get the CSRC count of the RTP packet in buffer.

gst_rtp_buffer_get_extension ()

gboolean            gst_rtp_buffer_get_extension        (GstBuffer *buffer);

Check if the extension bit is set on the RTP packet in buffer.

gst_rtp_buffer_get_marker ()

gboolean            gst_rtp_buffer_get_marker           (GstBuffer *buffer);

Check if the marker bit is set on the RTP packet in buffer.

gst_rtp_buffer_get_packet_len ()

guint               gst_rtp_buffer_get_packet_len       (GstBuffer *buffer);

Return the total length of the packet in buffer.

gst_rtp_buffer_get_padding ()

gboolean            gst_rtp_buffer_get_padding          (GstBuffer *buffer);

Check if the padding bit is set on the RTP packet in buffer.

gst_rtp_buffer_get_payload ()

gpointer            gst_rtp_buffer_get_payload          (GstBuffer *buffer);

Get a pointer to the payload data in buffer. This pointer is valid as long as a reference to buffer is held.

gst_rtp_buffer_get_payload_buffer ()

GstBuffer*          gst_rtp_buffer_get_payload_buffer   (GstBuffer *buffer);

Create a buffer of the payload of the RTP packet in buffer. This function will internally create a subbuffer of buffer so that a memcpy can be avoided.

gst_rtp_buffer_get_payload_subbuffer ()

GstBuffer*          gst_rtp_buffer_get_payload_subbuffer
                                                        (GstBuffer *buffer,
                                                         guint offset,
                                                         guint len);

Create a subbuffer of the payload of the RTP packet in buffer. offset bytes are skipped in the payload and the subbuffer will be of size len. If len is -1 the total payload starting from offset if subbuffered.

Since 0.10.10

gst_rtp_buffer_get_payload_len ()

guint               gst_rtp_buffer_get_payload_len      (GstBuffer *buffer);

Get the length of the payload of the RTP packet in buffer.

gst_rtp_buffer_get_payload_type ()

guint8              gst_rtp_buffer_get_payload_type     (GstBuffer *buffer);

Get the payload type of the RTP packet in buffer.

gst_rtp_buffer_get_seq ()

guint16             gst_rtp_buffer_get_seq              (GstBuffer *buffer);

Get the sequence number of the RTP packet in buffer.

gst_rtp_buffer_get_ssrc ()

guint32             gst_rtp_buffer_get_ssrc             (GstBuffer *buffer);

Get the SSRC of the RTP packet in buffer.

gst_rtp_buffer_get_timestamp ()

guint32             gst_rtp_buffer_get_timestamp        (GstBuffer *buffer);

Get the timestamp of the RTP packet in buffer.

gst_rtp_buffer_get_version ()

guint8              gst_rtp_buffer_get_version          (GstBuffer *buffer);

Get the version number of the RTP packet in buffer.

gst_rtp_buffer_new_allocate ()

GstBuffer*          gst_rtp_buffer_new_allocate         (guint payload_len,
                                                         guint8 pad_len,
                                                         guint8 csrc_count);

Allocate a new Gstbuffer with enough data to hold an RTP packet with csrc_count CSRCs, a payload length of payload_len and padding of pad_len. All other RTP header fields will be set to 0/FALSE.

gst_rtp_buffer_new_allocate_len ()

GstBuffer*          gst_rtp_buffer_new_allocate_len     (guint packet_len,
                                                         guint8 pad_len,
                                                         guint8 csrc_count);

Create a new GstBuffer that can hold an RTP packet that is exactly packet_len long. The length of the payload depends on pad_len and csrc_count and can be calculated with gst_rtp_buffer_calc_payload_len(). All RTP header fields will be set to 0/FALSE.

gst_rtp_buffer_new_copy_data ()

GstBuffer*          gst_rtp_buffer_new_copy_data        (gpointer data,
                                                         guint len);

Create a new buffer and set the data to a copy of len bytes of data and the size to len. The data will be freed when the buffer is freed.

gst_rtp_buffer_new_take_data ()

GstBuffer*          gst_rtp_buffer_new_take_data        (gpointer data,
                                                         guint len);

Create a new buffer and set the data and size of the buffer to data and len respectively. data will be freed when the buffer is unreffed, so this function transfers ownership of data to the new buffer.

gst_rtp_buffer_pad_to ()

void                gst_rtp_buffer_pad_to               (GstBuffer *buffer,
                                                         guint len);

Set the amount of padding in the RTP packing in buffer to len. If len is 0, the padding is removed.

NOTE: This function does not work correctly.

gst_rtp_buffer_set_csrc ()

void                gst_rtp_buffer_set_csrc             (GstBuffer *buffer,
                                                         guint8 idx,
                                                         guint32 csrc);

Modify the CSRC at index idx in buffer to csrc.

gst_rtp_buffer_set_extension ()

void                gst_rtp_buffer_set_extension        (GstBuffer *buffer,
                                                         gboolean extension);

Set the extension bit on the RTP packet in buffer to extension.

gst_rtp_buffer_set_marker ()

void                gst_rtp_buffer_set_marker           (GstBuffer *buffer,
                                                         gboolean marker);

Set the marker bit on the RTP packet in buffer to marker.

gst_rtp_buffer_set_packet_len ()

void                gst_rtp_buffer_set_packet_len       (GstBuffer *buffer,
                                                         guint len);

Set the total buffer size to len. The data in the buffer will be made larger if needed. Any padding will be removed from the packet.

gst_rtp_buffer_set_padding ()

void                gst_rtp_buffer_set_padding          (GstBuffer *buffer,
                                                         gboolean padding);

Set the padding bit on the RTP packet in buffer to padding.

gst_rtp_buffer_set_payload_type ()

void                gst_rtp_buffer_set_payload_type     (GstBuffer *buffer,
                                                         guint8 payload_type);

Set the payload type of the RTP packet in buffer to payload_type.

gst_rtp_buffer_set_seq ()

void                gst_rtp_buffer_set_seq              (GstBuffer *buffer,
                                                         guint16 seq);

Set the sequence number of the RTP packet in buffer to seq.

gst_rtp_buffer_set_ssrc ()

void                gst_rtp_buffer_set_ssrc             (GstBuffer *buffer,
                                                         guint32 ssrc);

Set the SSRC on the RTP packet in buffer to ssrc.

gst_rtp_buffer_set_timestamp ()

void                gst_rtp_buffer_set_timestamp        (GstBuffer *buffer,
                                                         guint32 timestamp);

Set the timestamp of the RTP packet in buffer to timestamp.

gst_rtp_buffer_set_version ()

void                gst_rtp_buffer_set_version          (GstBuffer *buffer,
                                                         guint8 version);

Set the version of the RTP packet in buffer to version.

gst_rtp_buffer_validate ()

gboolean            gst_rtp_buffer_validate             (GstBuffer *buffer);

Check if the data pointed to by buffer is a valid RTP packet using gst_rtp_buffer_validate_data().

gst_rtp_buffer_validate_data ()

gboolean            gst_rtp_buffer_validate_data        (guint8 *data,
                                                         guint len);

Check if the data and size point to the data of a valid RTP packet. This function checks the length, version and padding of the packet data. Use this function to validate a packet before using the other functions in this module.