package webrtc.rtclog

Get desktop application:
View/edit binary Protocol Buffers messages

Used in: Event

• optional uint32 local_ssrc = 2

  required - The SSRC of the audio stream associated with the playout event.

Used in: Event

• optional uint32 remote_ssrc = 1

  required - Synchronization source (stream identifier) to be received.

• optional uint32 local_ssrc = 2

  required - Sender SSRC used for sending RTCP (such as receiver reports).

• repeated RtpHeaderExtension header_extensions = 3

  RTP header extensions used for the received audio stream.

Used in: Event

• optional uint32 ssrc = 1

  required - Synchronization source (stream identifier) for outgoing stream.

• repeated RtpHeaderExtension header_extensions = 2

  RTP header extensions used for the outgoing audio stream.

Used in: Event

• optional int32 bitrate = 1

  required - Bandwidth estimate (in bps) after the update.

• optional uint32 fraction_loss = 2

  required - Fraction of lost packets since last receiver report computed as floor( 256 * (#lost_packets / #total_packets) ). The possible values range from 0 to 255.

• optional int32 total_packets = 3

  TODO(terelius): Is this really needed? Remove or make optional? required - Total number of packets that the BWE update is based on.

Maps decoder names to payload types.

Used in: VideoReceiveConfig

• optional string name = 1

  required

• optional int32 payload_type = 2

  required

Maps encoder names to payload types.

Used in: VideoSendConfig

• optional string name = 1

  required

• optional int32 payload_type = 2

  required

Used in: EventStream

• optional int64 timestamp_us = 1

  required - Elapsed wallclock time in us since the start of the log.

• optional Event.EventType type = 2

  required - Indicates the type of this event

• optional RtpPacket rtp_packet = 3

  optional - but required if type == RTP_EVENT

• optional RtcpPacket rtcp_packet = 4

  optional - but required if type == RTCP_EVENT

• optional AudioPlayoutEvent audio_playout_event = 5

  optional - but required if type == AUDIO_PLAYOUT_EVENT

• optional BwePacketLossEvent bwe_packet_loss_event = 6

  optional - but required if type == BWE_PACKET_LOSS_EVENT

• optional VideoReceiveConfig video_receiver_config = 8

  optional - but required if type == VIDEO_RECEIVER_CONFIG_EVENT

• optional VideoSendConfig video_sender_config = 9

  optional - but required if type == VIDEO_SENDER_CONFIG_EVENT

• optional AudioReceiveConfig audio_receiver_config = 10

  optional - but required if type == AUDIO_RECEIVER_CONFIG_EVENT

• optional AudioSendConfig audio_sender_config = 11

  optional - but required if type == AUDIO_SENDER_CONFIG_EVENT

The different types of events that can occur, the UNKNOWN_EVENT entry is added in case future EventTypes are added, in that case old code will receive the new events as UNKNOWN_EVENT.

Used in: Event

• UNKNOWN_EVENT = 0

• LOG_START = 1

• LOG_END = 2

• RTP_EVENT = 3

• RTCP_EVENT = 4

• AUDIO_PLAYOUT_EVENT = 5

• BWE_PACKET_LOSS_EVENT = 6

• BWE_PACKET_DELAY_EVENT = 7

• VIDEO_RECEIVER_CONFIG_EVENT = 8

• VIDEO_SENDER_CONFIG_EVENT = 9

• AUDIO_RECEIVER_CONFIG_EVENT = 10

• AUDIO_SENDER_CONFIG_EVENT = 11

This is the main message to dump to a file, it can contain multiple event messages, but it is possible to append multiple EventStreams (each with a single event) to a file. This has the benefit that there's no need to keep all data in memory.

• repeated Event stream = 1

Used in: RtcpPacket, RtpPacket

• ANY = 0

• AUDIO = 1

• VIDEO = 2

• DATA = 3

Used in: Event

• optional bool incoming = 1

  required - True if the packet is incoming w.r.t. the user logging the data

• optional MediaType type = 2

  required

• optional bytes packet_data = 3

  required - The whole packet including both payload and header.

Maps RTP header extension names to numerical IDs.

Used in: AudioReceiveConfig, AudioSendConfig, VideoReceiveConfig, VideoSendConfig

• optional string name = 1

  required

• optional int32 id = 2

  required

Used in: Event

• optional bool incoming = 1

  required - True if the packet is incoming w.r.t. the user logging the data

• optional MediaType type = 2

  required

• optional uint32 packet_length = 3

  required - The size of the packet including both payload and header.

• optional bytes header = 4

  required - The RTP header only.

RTX settings for incoming video payloads that may be received. RTX is disabled if there's no config present.

Used in: RtxMap

• optional uint32 rtx_ssrc = 1

  required - SSRC to use for the RTX stream.

• optional int32 rtx_payload_type = 2

  required - Payload type to use for the RTX stream.

Used in: VideoReceiveConfig

• optional int32 payload_type = 1

  required

• optional RtxConfig config = 2

  required

TODO(terelius): Video and audio streams could in principle share SSRC, so identifying a stream based only on SSRC might not work. It might be better to use a combination of SSRC and media type or SSRC and port number, but for now we will rely on SSRC only.

Used in: Event

• optional uint32 remote_ssrc = 1

  required - Synchronization source (stream identifier) to be received.

• optional uint32 local_ssrc = 2

  required - Sender SSRC used for sending RTCP (such as receiver reports).

• optional VideoReceiveConfig.RtcpMode rtcp_mode = 3

  required - RTCP mode to use.

• optional bool remb = 4

  required - Receiver estimated maximum bandwidth.

• repeated RtxMap rtx_map = 5

  Map from video RTP payload type -> RTX config.

• repeated RtpHeaderExtension header_extensions = 6

  RTP header extensions used for the received stream.

• repeated DecoderConfig decoders = 7

  List of decoders associated with the stream.

Compound mode is described by RFC 4585 and reduced-size RTCP mode is described by RFC 5506.

Used in: VideoReceiveConfig

• RTCP_COMPOUND = 1

• RTCP_REDUCEDSIZE = 2

Used in: Event

• repeated uint32 ssrcs = 1

  Synchronization source (stream identifier) for outgoing stream. One stream can have several ssrcs for e.g. simulcast. At least one ssrc is required.

• repeated RtpHeaderExtension header_extensions = 2

  RTP header extensions used for the outgoing stream.

• repeated uint32 rtx_ssrcs = 3

  List of SSRCs for retransmitted packets.

• optional int32 rtx_payload_type = 4

  required if rtx_ssrcs is used - Payload type for retransmitted packets.

• optional EncoderConfig encoder = 5

  required - Encoder associated with the stream.