1 /*
2  *  Copyright (c) 2013 The WebRTC project authors. All Rights Reserved.
3  *
4  *  Use of this source code is governed by a BSD-style license
5  *  that can be found in the LICENSE file in the root of the source
6  *  tree. An additional intellectual property rights grant can be found
7  *  in the file PATENTS.  All contributing project authors may
8  *  be found in the AUTHORS file in the root of the source tree.
9  */
10 
11 #ifndef WEBRTC_MODULES_RTP_RTCP_SOURCE_RTP_RECEIVER_IMPL_H_
12 #define WEBRTC_MODULES_RTP_RTCP_SOURCE_RTP_RECEIVER_IMPL_H_
13 
14 #include "webrtc/base/scoped_ptr.h"
15 #include "webrtc/modules/rtp_rtcp/include/rtp_receiver.h"
16 #include "webrtc/modules/rtp_rtcp/include/rtp_rtcp_defines.h"
17 #include "webrtc/modules/rtp_rtcp/source/rtp_receiver_strategy.h"
18 #include "webrtc/system_wrappers/include/critical_section_wrapper.h"
19 #include "webrtc/typedefs.h"
20 
21 namespace webrtc {
22 
23 class RtpReceiverImpl : public RtpReceiver {
24  public:
25   // Callbacks passed in here may not be NULL (use Null Object callbacks if you
26   // want callbacks to do nothing). This class takes ownership of the media
27   // receiver but nothing else.
28   RtpReceiverImpl(Clock* clock,
29                   RtpAudioFeedback* incoming_audio_messages_callback,
30                   RtpFeedback* incoming_messages_callback,
31                   RTPPayloadRegistry* rtp_payload_registry,
32                   RTPReceiverStrategy* rtp_media_receiver);
33 
34   virtual ~RtpReceiverImpl();
35 
36   int32_t RegisterReceivePayload(const char payload_name[RTP_PAYLOAD_NAME_SIZE],
37                                  const int8_t payload_type,
38                                  const uint32_t frequency,
39                                  const size_t channels,
40                                  const uint32_t rate) override;
41 
42   int32_t DeRegisterReceivePayload(const int8_t payload_type) override;
43 
44   bool IncomingRtpPacket(const RTPHeader& rtp_header,
45                          const uint8_t* payload,
46                          size_t payload_length,
47                          PayloadUnion payload_specific,
48                          bool in_order) override;
49 
50   NACKMethod NACK() const override;
51 
52   // Turn negative acknowledgement requests on/off.
53   void SetNACKStatus(const NACKMethod method) override;
54 
55   // Returns the last received timestamp.
56   bool Timestamp(uint32_t* timestamp) const override;
57   bool LastReceivedTimeMs(int64_t* receive_time_ms) const override;
58 
59   uint32_t SSRC() const override;
60 
61   int32_t CSRCs(uint32_t array_of_csrc[kRtpCsrcSize]) const override;
62 
63   int32_t Energy(uint8_t array_of_energy[kRtpCsrcSize]) const override;
64 
65   TelephoneEventHandler* GetTelephoneEventHandler() override;
66 
67  private:
68   bool HaveReceivedFrame() const;
69 
70   void CheckSSRCChanged(const RTPHeader& rtp_header);
71   void CheckCSRC(const WebRtcRTPHeader& rtp_header);
72   int32_t CheckPayloadChanged(const RTPHeader& rtp_header,
73                               const int8_t first_payload_byte,
74                               bool* is_red,
75                               PayloadUnion* payload);
76 
77   Clock* clock_;
78   RTPPayloadRegistry* rtp_payload_registry_;
79   rtc::scoped_ptr<RTPReceiverStrategy> rtp_media_receiver_;
80 
81   RtpFeedback* cb_rtp_feedback_;
82 
83   rtc::scoped_ptr<CriticalSectionWrapper> critical_section_rtp_receiver_;
84   int64_t last_receive_time_;
85   size_t last_received_payload_length_;
86 
87   // SSRCs.
88   uint32_t ssrc_;
89   uint8_t num_csrcs_;
90   uint32_t current_remote_csrc_[kRtpCsrcSize];
91 
92   uint32_t last_received_timestamp_;
93   int64_t last_received_frame_time_ms_;
94   uint16_t last_received_sequence_number_;
95 
96   NACKMethod nack_method_;
97 };
98 }  // namespace webrtc
99 #endif  // WEBRTC_MODULES_RTP_RTCP_SOURCE_RTP_RECEIVER_IMPL_H_
100