OLD | NEW |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // This class maintains a send transport for audio and video in a Cast | 5 // This class maintains a send transport for audio and video in a Cast |
6 // Streaming session. | 6 // Streaming session. |
7 // Audio, video frames and RTCP messages are submitted to this object | 7 // Audio, video frames and RTCP messages are submitted to this object |
8 // and then packetized and paced to the underlying UDP socket. | 8 // and then packetized and paced to the underlying UDP socket. |
9 // | 9 // |
10 // The hierarchy of send transport in a Cast Streaming session: | 10 // The hierarchy of send transport in a Cast Streaming session: |
11 // | 11 // |
12 // CastTransportSender RTP RTCP | 12 // CastTransportSender RTP RTCP |
13 // ------------------------------------------------------------------ | 13 // ------------------------------------------------------------------ |
14 // TransportEncryptionHandler (A/V) | 14 // TransportEncryptionHandler (A/V) |
15 // RtpSender (A/V) Rtcp (A/V) | 15 // RtpSender (A/V) Rtcp (A/V) |
16 // PacedSender (Shared) | 16 // PacedSender (Shared) |
17 // UdpTransport (Shared) | 17 // UdpTransport (Shared) |
18 // | 18 // |
19 // There are objects of TransportEncryptionHandler, RtpSender and Rtcp | 19 // There are objects of TransportEncryptionHandler, RtpSender and Rtcp |
20 // for each audio and video stream. | 20 // for each audio and video stream. |
21 // PacedSender and UdpTransport are shared between all RTP and RTCP | 21 // PacedSender and UdpTransport are shared between all RTP and RTCP |
22 // streams. | 22 // streams. |
23 | 23 |
24 #ifndef MEDIA_CAST_NET_CAST_TRANSPORT_SENDER_IMPL_H_ | 24 #ifndef MEDIA_CAST_NET_CAST_TRANSPORT_SENDER_IMPL_H_ |
25 #define MEDIA_CAST_NET_CAST_TRANSPORT_SENDER_IMPL_H_ | 25 #define MEDIA_CAST_NET_CAST_TRANSPORT_SENDER_IMPL_H_ |
26 | 26 |
| 27 #include <set> |
| 28 |
27 #include "base/callback.h" | 29 #include "base/callback.h" |
28 #include "base/gtest_prod_util.h" | 30 #include "base/gtest_prod_util.h" |
29 #include "base/memory/ref_counted.h" | 31 #include "base/memory/ref_counted.h" |
30 #include "base/memory/scoped_ptr.h" | 32 #include "base/memory/scoped_ptr.h" |
31 #include "base/memory/weak_ptr.h" | 33 #include "base/memory/weak_ptr.h" |
32 #include "base/time/tick_clock.h" | 34 #include "base/time/tick_clock.h" |
33 #include "base/time/time.h" | 35 #include "base/time/time.h" |
34 #include "media/cast/common/transport_encryption_handler.h" | 36 #include "media/cast/common/transport_encryption_handler.h" |
35 #include "media/cast/logging/logging_defines.h" | 37 #include "media/cast/logging/logging_defines.h" |
36 #include "media/cast/logging/simple_event_subscriber.h" | 38 #include "media/cast/logging/simple_event_subscriber.h" |
37 #include "media/cast/net/cast_transport_config.h" | 39 #include "media/cast/net/cast_transport_config.h" |
38 #include "media/cast/net/cast_transport_sender.h" | 40 #include "media/cast/net/cast_transport_sender.h" |
39 #include "media/cast/net/pacing/paced_sender.h" | 41 #include "media/cast/net/pacing/paced_sender.h" |
40 #include "media/cast/net/rtcp/rtcp.h" | 42 #include "media/cast/net/rtcp/rtcp.h" |
| 43 #include "media/cast/net/rtp/rtp_parser.h" |
41 #include "media/cast/net/rtp/rtp_sender.h" | 44 #include "media/cast/net/rtp/rtp_sender.h" |
42 | 45 |
43 namespace media { | 46 namespace media { |
44 namespace cast { | 47 namespace cast { |
45 | 48 |
46 class UdpTransport; | 49 class UdpTransport; |
47 | 50 |
48 class CastTransportSenderImpl : public CastTransportSender { | 51 class CastTransportSenderImpl : public CastTransportSender { |
49 public: | 52 public: |
50 // |external_transport| is only used for testing. | 53 // |external_transport| is only used for testing. |
51 // |raw_events_callback|: Raw events will be returned on this callback | 54 // |raw_events_callback|: Raw events will be returned on this callback |
52 // which will be invoked every |raw_events_callback_interval|. | 55 // which will be invoked every |raw_events_callback_interval|. |
53 // This can be a null callback, i.e. if user is not interested in raw events. | 56 // This can be a null callback, i.e. if user is not interested in raw events. |
54 // |raw_events_callback_interval|: This can be |base::TimeDelta()| if | 57 // |raw_events_callback_interval|: This can be |base::TimeDelta()| if |
55 // |raw_events_callback| is a null callback. | 58 // |raw_events_callback| is a null callback. |
56 // |options| contains optional settings for the transport, possible | 59 // |options| contains optional settings for the transport, possible |
57 // keys are: | 60 // keys are: |
58 // "DSCP" (value ignored) - turns DSCP on | 61 // "DSCP" (value ignored) - turns DSCP on |
59 // "pacer_target_burst_size": int - specifies how many packets to send | 62 // "pacer_target_burst_size": int - specifies how many packets to send |
60 // per 10 ms ideally. | 63 // per 10 ms ideally. |
61 // "pacer_max_burst_size": int - specifies how many pakcets to send | 64 // "pacer_max_burst_size": int - specifies how many pakcets to send |
62 // per 10 ms, max | 65 // per 10 ms, max |
63 // "send_buffer_min_size": int - specifies the minimum socket send buffer | 66 // "send_buffer_min_size": int - specifies the minimum socket send buffer |
64 // size | 67 // size |
65 // "disable_wifi_scan" (value ignored) - disable wifi scans while streaming | 68 // "disable_wifi_scan" (value ignored) - disable wifi scans while streaming |
66 // "media_streaming_mode" (value ignored) - turn media streaming mode on | 69 // "media_streaming_mode" (value ignored) - turn media streaming mode on |
67 // Note, these options may be ignored on some platforms. | 70 // Note, these options may be ignored on some platforms. |
| 71 // TODO(hubbe): Too many callbacks, replace with an interface. |
68 CastTransportSenderImpl( | 72 CastTransportSenderImpl( |
69 net::NetLog* net_log, | 73 net::NetLog* net_log, |
70 base::TickClock* clock, | 74 base::TickClock* clock, |
| 75 const net::IPEndPoint& local_end_point, |
71 const net::IPEndPoint& remote_end_point, | 76 const net::IPEndPoint& remote_end_point, |
72 scoped_ptr<base::DictionaryValue> options, | 77 scoped_ptr<base::DictionaryValue> options, |
73 const CastTransportStatusCallback& status_callback, | 78 const CastTransportStatusCallback& status_callback, |
74 const BulkRawEventsCallback& raw_events_callback, | 79 const BulkRawEventsCallback& raw_events_callback, |
75 base::TimeDelta raw_events_callback_interval, | 80 base::TimeDelta raw_events_callback_interval, |
76 const scoped_refptr<base::SingleThreadTaskRunner>& transport_task_runner, | 81 const scoped_refptr<base::SingleThreadTaskRunner>& transport_task_runner, |
| 82 const PacketReceiverCallback& packet_callback, |
77 PacketSender* external_transport); | 83 PacketSender* external_transport); |
78 | 84 |
79 ~CastTransportSenderImpl() override; | 85 ~CastTransportSenderImpl() override; |
80 | 86 |
| 87 // CastTransportSender implementation. |
81 void InitializeAudio(const CastTransportRtpConfig& config, | 88 void InitializeAudio(const CastTransportRtpConfig& config, |
82 const RtcpCastMessageCallback& cast_message_cb, | 89 const RtcpCastMessageCallback& cast_message_cb, |
83 const RtcpRttCallback& rtt_cb) override; | 90 const RtcpRttCallback& rtt_cb) override; |
84 void InitializeVideo(const CastTransportRtpConfig& config, | 91 void InitializeVideo(const CastTransportRtpConfig& config, |
85 const RtcpCastMessageCallback& cast_message_cb, | 92 const RtcpCastMessageCallback& cast_message_cb, |
86 const RtcpRttCallback& rtt_cb) override; | 93 const RtcpRttCallback& rtt_cb) override; |
87 void InsertFrame(uint32 ssrc, const EncodedFrame& frame) override; | 94 void InsertFrame(uint32 ssrc, const EncodedFrame& frame) override; |
88 | 95 |
89 void SendSenderReport(uint32 ssrc, | 96 void SendSenderReport(uint32 ssrc, |
90 base::TimeTicks current_time, | 97 base::TimeTicks current_time, |
91 uint32 current_time_as_rtp_timestamp) override; | 98 uint32 current_time_as_rtp_timestamp) override; |
92 | 99 |
93 void CancelSendingFrames(uint32 ssrc, | 100 void CancelSendingFrames(uint32 ssrc, |
94 const std::vector<uint32>& frame_ids) override; | 101 const std::vector<uint32>& frame_ids) override; |
95 | 102 |
96 void ResendFrameForKickstart(uint32 ssrc, uint32 frame_id) override; | 103 void ResendFrameForKickstart(uint32 ssrc, uint32 frame_id) override; |
97 | 104 |
98 PacketReceiverCallback PacketReceiverForTesting() override; | 105 PacketReceiverCallback PacketReceiverForTesting() override; |
99 | 106 |
| 107 // CastTransportReceiver implementation. |
| 108 void AddValidSsrc(uint32 ssrc) override; |
| 109 |
| 110 void SendRtcpFromRtpReceiver( |
| 111 uint32 ssrc, |
| 112 uint32 sender_ssrc, |
| 113 const RtcpTimeData& time_data, |
| 114 const RtcpCastMessage* cast_message, |
| 115 base::TimeDelta target_delay, |
| 116 const ReceiverRtcpEventSubscriber::RtcpEvents* rtcp_events, |
| 117 const RtpReceiverStatistics* rtp_receiver_statistics) override; |
| 118 |
100 private: | 119 private: |
101 FRIEND_TEST_ALL_PREFIXES(CastTransportSenderImplTest, NacksCancelRetransmits); | 120 FRIEND_TEST_ALL_PREFIXES(CastTransportSenderImplTest, NacksCancelRetransmits); |
102 FRIEND_TEST_ALL_PREFIXES(CastTransportSenderImplTest, CancelRetransmits); | 121 FRIEND_TEST_ALL_PREFIXES(CastTransportSenderImplTest, CancelRetransmits); |
103 FRIEND_TEST_ALL_PREFIXES(CastTransportSenderImplTest, Kickstart); | 122 FRIEND_TEST_ALL_PREFIXES(CastTransportSenderImplTest, Kickstart); |
104 FRIEND_TEST_ALL_PREFIXES(CastTransportSenderImplTest, | 123 FRIEND_TEST_ALL_PREFIXES(CastTransportSenderImplTest, |
105 DedupRetransmissionWithAudio); | 124 DedupRetransmissionWithAudio); |
106 | 125 |
107 // Resend packets for the stream identified by |ssrc|. | 126 // Resend packets for the stream identified by |ssrc|. |
108 // If |cancel_rtx_if_not_in_list| is true then transmission of packets for the | 127 // If |cancel_rtx_if_not_in_list| is true then transmission of packets for the |
109 // frames but not in the list will be dropped. | 128 // frames but not in the list will be dropped. |
110 // See PacedSender::ResendPackets() to see how |dedup_info| works. | 129 // See PacedSender::ResendPackets() to see how |dedup_info| works. |
111 void ResendPackets(uint32 ssrc, | 130 void ResendPackets(uint32 ssrc, |
112 const MissingFramesAndPacketsMap& missing_packets, | 131 const MissingFramesAndPacketsMap& missing_packets, |
113 bool cancel_rtx_if_not_in_list, | 132 bool cancel_rtx_if_not_in_list, |
114 const DedupInfo& dedup_info); | 133 const DedupInfo& dedup_info); |
115 | 134 |
116 // If |raw_events_callback_| is non-null, calls it with events collected | 135 // If |raw_events_callback_| is non-null, calls it with events collected |
117 // by |event_subscriber_| since last call. | 136 // by |event_subscriber_| since last call. |
118 void SendRawEvents(); | 137 void SendRawEvents(); |
119 | 138 |
120 // Called when a packet is received. | 139 // Called when a packet is received. |
121 void OnReceivedPacket(scoped_ptr<Packet> packet); | 140 bool OnReceivedPacket(scoped_ptr<Packet> packet); |
122 | 141 |
123 // Called when a log message is received. | 142 // Called when a log message is received. |
124 void OnReceivedLogMessage(EventMediaType media_type, | 143 void OnReceivedLogMessage(EventMediaType media_type, |
125 const RtcpReceiverLogMessage& log); | 144 const RtcpReceiverLogMessage& log); |
126 | 145 |
127 // Called when a RTCP Cast message is received. | 146 // Called when a RTCP Cast message is received. |
128 void OnReceivedCastMessage(uint32 ssrc, | 147 void OnReceivedCastMessage(uint32 ssrc, |
129 const RtcpCastMessageCallback& cast_message_cb, | 148 const RtcpCastMessageCallback& cast_message_cb, |
130 const RtcpCastMessage& cast_message); | 149 const RtcpCastMessage& cast_message); |
131 | 150 |
(...skipping 28 matching lines...) Expand all Loading... |
160 scoped_ptr<SimpleEventSubscriber> event_subscriber_; | 179 scoped_ptr<SimpleEventSubscriber> event_subscriber_; |
161 | 180 |
162 BulkRawEventsCallback raw_events_callback_; | 181 BulkRawEventsCallback raw_events_callback_; |
163 base::TimeDelta raw_events_callback_interval_; | 182 base::TimeDelta raw_events_callback_interval_; |
164 | 183 |
165 // Right after a frame is sent we record the number of bytes sent to the | 184 // Right after a frame is sent we record the number of bytes sent to the |
166 // socket. We record the corresponding bytes sent for the most recent ACKed | 185 // socket. We record the corresponding bytes sent for the most recent ACKed |
167 // audio packet. | 186 // audio packet. |
168 int64 last_byte_acked_for_audio_; | 187 int64 last_byte_acked_for_audio_; |
169 | 188 |
| 189 // Packets that don't match these ssrcs are ignored. |
| 190 std::set<uint32> valid_ssrcs_; |
| 191 |
| 192 // Called with incoming packets. (Unless they match the |
| 193 // channels created by Initialize{Audio,Video}. |
| 194 PacketReceiverCallback packet_callback_; |
| 195 |
170 scoped_ptr<net::ScopedWifiOptions> wifi_options_autoreset_; | 196 scoped_ptr<net::ScopedWifiOptions> wifi_options_autoreset_; |
171 | 197 |
172 base::WeakPtrFactory<CastTransportSenderImpl> weak_factory_; | 198 base::WeakPtrFactory<CastTransportSenderImpl> weak_factory_; |
173 | 199 |
174 DISALLOW_COPY_AND_ASSIGN(CastTransportSenderImpl); | 200 DISALLOW_COPY_AND_ASSIGN(CastTransportSenderImpl); |
175 }; | 201 }; |
176 | 202 |
177 } // namespace cast | 203 } // namespace cast |
178 } // namespace media | 204 } // namespace media |
179 | 205 |
180 #endif // MEDIA_CAST_NET_CAST_TRANSPORT_SENDER_IMPL_H_ | 206 #endif // MEDIA_CAST_NET_CAST_TRANSPORT_SENDER_IMPL_H_ |
OLD | NEW |