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
21namespace webrtc {
22
23class 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