media/cast/logging/proto/raw_events.proto

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // Protocol for audio messages.
   6
   7 syntax = "proto2";
   8
   9 option optimize_for = LITE_RUNTIME;
  10
  11 package media.cast.proto;
  12
  13 // Keep in sync with media/cast/logging/logging_defines.h.
  14 // For compatibility reasons, existing values in this enum must not be changed.
  15 enum EventType {
  16   UNKNOWN = 0;
  17
  18   // Note: 1-28 are deprecated in favor of unified event types. Do not use.
  19   // Generic events. No longer used.
  20   RTT_MS = 1;
  21   PACKET_LOSS = 2;
  22   JITTER_MS = 3;
  23   VIDEO_ACK_RECEIVED = 4;  // Sender side frame event.
  24   REMB_BITRATE = 5;        // Generic event. No longer used.
  25   // Audio receiver.
  26   AUDIO_ACK_SENT = 6;
  27   // Video receiver.
  28   VIDEO_ACK_SENT = 7;
  29   // Audio sender.
  30   AUDIO_FRAME_CAPTURE_END = 8;
  31   AUDIO_FRAME_CAPTURE_BEGIN = 9;
  32   AUDIO_FRAME_ENCODED = 10;
  33   // Audio receiver.
  34   AUDIO_PLAYOUT_DELAY = 11;
  35   AUDIO_FRAME_DECODED = 12;
  36   // Video sender.
  37   VIDEO_FRAME_CAPTURE_BEGIN = 13;
  38   VIDEO_FRAME_CAPTURE_END = 14;
  39   VIDEO_FRAME_SENT_TO_ENCODER = 15;  // Deprecated
  40   VIDEO_FRAME_ENCODED = 16;
  41   // Video receiver.
  42   VIDEO_FRAME_DECODED = 17;
  43   VIDEO_RENDER_DELAY = 18;
  44   // Send-side packet events.
  45   // AUDIO_PACKET_SENT_TO_PACER = 19;  // Deprecated
  46   // VIDEO_PACKET_SENT_TO_PACER = 20;  // Deprecated
  47   AUDIO_PACKET_SENT_TO_NETWORK = 21;
  48   VIDEO_PACKET_SENT_TO_NETWORK = 22;
  49   AUDIO_PACKET_RETRANSMITTED = 23;
  50   VIDEO_PACKET_RETRANSMITTED = 24;
  51   // Receiver-side packet events.
  52   AUDIO_PACKET_RECEIVED = 25;
  53   VIDEO_PACKET_RECEIVED = 26;
  54   DUPLICATE_AUDIO_PACKET_RECEIVED = 27;
  55   DUPLICATE_VIDEO_PACKET_RECEIVED = 28;
  56
  57
  58   // New, unified event types.
  59   FRAME_CAPTURE_BEGIN = 29;
  60   FRAME_CAPTURE_END = 30;
  61   FRAME_ENCODED = 31;
  62   FRAME_ACK_RECEIVED = 32;
  63   FRAME_ACK_SENT = 33;
  64   FRAME_DECODED = 34;
  65   FRAME_PLAYOUT = 35;
  66   PACKET_SENT_TO_NETWORK = 36;
  67   PACKET_RETRANSMITTED = 37;
  68   PACKET_RECEIVED = 38;
  69 }
  70
  71 // Each log will contain one |LogMetadata|.
  72 message LogMetadata {
  73   // |true| if the events are related to audio. |false| if they are related to
  74   // video.
  75   optional bool is_audio = 1;
  76
  77   // Used as a reference for all event entries.
  78   // i.e. the original RTP timestamp for each event will be
  79   // |first_rtp_timestamp| + |relative_rtp_timestamp|.
  80   optional uint32 first_rtp_timestamp = 2;
  81
  82   // Number of AggregatedFrameEvent's.
  83   optional int32 num_frame_events = 3;
  84
  85   // Number of AggregatedPacketEvent's.
  86   optional int32 num_packet_events = 4;
  87
  88   // The internal timestamp value in milliseconds that represents the time
  89   // of the Unix epoch. This is used for relating the timestamps in the events
  90   // to a real time and date.
  91   optional int64 reference_timestamp_ms_at_unix_epoch = 5;
  92 }
  93
  94 message AggregatedFrameEvent {
  95   optional uint32 relative_rtp_timestamp = 1;
  96
  97   repeated EventType event_type = 2 [packed = true];
  98
  99   // The internal timestamp value in milliseconds. Use
 100   // LogMetadata.reference_timestamp_ms_at_unix_epoch to relate to a real time
 101   // and date.
 102   repeated int64 event_timestamp_ms = 3 [packed = true];
 103
 104   // Only set if there is a frame encoded event.
 105   optional int32 encoded_frame_size = 4;
 106
 107   // Only set if there is a frame playout event.
 108   optional int32 delay_millis = 5;
 109
 110   // Only set if there is a video frame encoded event.
 111   optional bool key_frame = 6;
 112
 113   // Only set if there is a video frame encoded event.
 114   optional int32 target_bitrate = 7;
 115 };
 116
 117 message BasePacketEvent {
 118   optional int32 packet_id = 1;
 119   repeated EventType event_type = 2 [packed = true];
 120
 121   // The internal timestamp value in milliseconds. Use
 122   // LogMetadata.reference_timestamp_ms_at_unix_epoch to relate to a real time
 123   // and date.
 124   repeated int64 event_timestamp_ms = 3 [packed = true];
 125
 126   // Size of the packet.
 127   optional int32 size = 4;
 128 }
 129
 130 message AggregatedPacketEvent {
 131   optional uint32 relative_rtp_timestamp = 1;
 132   repeated BasePacketEvent base_packet_event = 2;
 133 };
 134