Index: webrtc/video_engine/vie_channel.h |
diff --git a/webrtc/video_engine/vie_channel.h b/webrtc/video_engine/vie_channel.h |
deleted file mode 100644 |
index 00c953201b529c67f8727b6a21a1fb3cb6d59c22..0000000000000000000000000000000000000000 |
--- a/webrtc/video_engine/vie_channel.h |
+++ /dev/null |
@@ -1,457 +0,0 @@ |
-/* |
- * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. |
- * |
- * Use of this source code is governed by a BSD-style license |
- * that can be found in the LICENSE file in the root of the source |
- * tree. An additional intellectual property rights grant can be found |
- * in the file PATENTS. All contributing project authors may |
- * be found in the AUTHORS file in the root of the source tree. |
- */ |
- |
-#ifndef WEBRTC_VIDEO_ENGINE_VIE_CHANNEL_H_ |
-#define WEBRTC_VIDEO_ENGINE_VIE_CHANNEL_H_ |
- |
-#include <list> |
-#include <map> |
-#include <vector> |
- |
-#include "webrtc/base/platform_thread.h" |
-#include "webrtc/base/scoped_ptr.h" |
-#include "webrtc/base/scoped_ref_ptr.h" |
-#include "webrtc/modules/remote_bitrate_estimator/include/remote_bitrate_estimator.h" |
-#include "webrtc/modules/rtp_rtcp/include/rtp_rtcp.h" |
-#include "webrtc/modules/rtp_rtcp/include/rtp_rtcp_defines.h" |
-#include "webrtc/modules/video_coding/include/video_coding_defines.h" |
-#include "webrtc/system_wrappers/include/critical_section_wrapper.h" |
-#include "webrtc/system_wrappers/include/tick_util.h" |
-#include "webrtc/typedefs.h" |
-#include "webrtc/video_engine/vie_receiver.h" |
-#include "webrtc/video_engine/vie_sync_module.h" |
- |
-namespace webrtc { |
- |
-class CallStatsObserver; |
-class ChannelStatsObserver; |
-class Config; |
-class CriticalSectionWrapper; |
-class EncodedImageCallback; |
-class I420FrameCallback; |
-class IncomingVideoStream; |
-class PacedSender; |
-class PacketRouter; |
-class PayloadRouter; |
-class ProcessThread; |
-class ReceiveStatisticsProxy; |
-class ReportBlockStats; |
-class RtcpRttStats; |
-class ViEChannelProtectionCallback; |
-class ViERTPObserver; |
-class VideoCodingModule; |
-class VideoDecoder; |
-class VideoRenderCallback; |
-class VoEVideoSync; |
- |
-enum StreamType { |
- kViEStreamTypeNormal = 0, // Normal media stream |
- kViEStreamTypeRtx = 1 // Retransmission media stream |
-}; |
- |
-class ViEChannel : public VCMFrameTypeCallback, |
- public VCMReceiveCallback, |
- public VCMReceiveStatisticsCallback, |
- public VCMDecoderTimingCallback, |
- public VCMPacketRequestCallback, |
- public RtpFeedback { |
- public: |
- friend class ChannelStatsObserver; |
- friend class ViEChannelProtectionCallback; |
- |
- ViEChannel(uint32_t number_of_cores, |
- Transport* transport, |
- ProcessThread* module_process_thread, |
- RtcpIntraFrameObserver* intra_frame_observer, |
- RtcpBandwidthObserver* bandwidth_observer, |
- TransportFeedbackObserver* transport_feedback_observer, |
- RemoteBitrateEstimator* remote_bitrate_estimator, |
- RtcpRttStats* rtt_stats, |
- PacedSender* paced_sender, |
- PacketRouter* packet_router, |
- size_t max_rtp_streams, |
- bool sender); |
- ~ViEChannel(); |
- |
- int32_t Init(); |
- |
- // Sets the encoder to use for the channel. |new_stream| indicates the encoder |
- // type has changed and we should start a new RTP stream. |
- int32_t SetSendCodec(const VideoCodec& video_codec, bool new_stream = true); |
- int32_t SetReceiveCodec(const VideoCodec& video_codec); |
- // Registers an external decoder. |buffered_rendering| means that the decoder |
- // will render frames after decoding according to the render timestamp |
- // provided by the video coding module. |render_delay| indicates the time |
- // needed to decode and render a frame. |
- int32_t RegisterExternalDecoder(const uint8_t pl_type, |
- VideoDecoder* decoder, |
- bool buffered_rendering, |
- int32_t render_delay); |
- int32_t ReceiveCodecStatistics(uint32_t* num_key_frames, |
- uint32_t* num_delta_frames); |
- uint32_t DiscardedPackets() const; |
- |
- // Returns the estimated delay in milliseconds. |
- int ReceiveDelay() const; |
- |
- void SetRTCPMode(const RtcpMode rtcp_mode); |
- void SetProtectionMode(bool enable_nack, |
- bool enable_fec, |
- int payload_type_red, |
- int payload_type_fec); |
- bool IsSendingFecEnabled(); |
- int SetSenderBufferingMode(int target_delay_ms); |
- int SetSendTimestampOffsetStatus(bool enable, int id); |
- int SetReceiveTimestampOffsetStatus(bool enable, int id); |
- int SetSendAbsoluteSendTimeStatus(bool enable, int id); |
- int SetReceiveAbsoluteSendTimeStatus(bool enable, int id); |
- int SetSendVideoRotationStatus(bool enable, int id); |
- int SetReceiveVideoRotationStatus(bool enable, int id); |
- int SetSendTransportSequenceNumber(bool enable, int id); |
- int SetReceiveTransportSequenceNumber(bool enable, int id); |
- void SetRtcpXrRrtrStatus(bool enable); |
- void EnableTMMBR(bool enable); |
- |
- // Sets SSRC for outgoing stream. |
- int32_t SetSSRC(const uint32_t SSRC, |
- const StreamType usage, |
- const unsigned char simulcast_idx); |
- |
- // Gets SSRC for outgoing stream number |idx|. |
- int32_t GetLocalSSRC(uint8_t idx, unsigned int* ssrc); |
- |
- // Gets SSRC for the incoming stream. |
- uint32_t GetRemoteSSRC(); |
- |
- int SetRtxSendPayloadType(int payload_type, int associated_payload_type); |
- void SetRtxReceivePayloadType(int payload_type, int associated_payload_type); |
- // If set to true, the RTX payload type mapping supplied in |
- // |SetRtxReceivePayloadType| will be used when restoring RTX packets. Without |
- // it, RTX packets will always be restored to the last non-RTX packet payload |
- // type received. |
- void SetUseRtxPayloadMappingOnRestore(bool val); |
- |
- void SetRtpStateForSsrc(uint32_t ssrc, const RtpState& rtp_state); |
- RtpState GetRtpStateForSsrc(uint32_t ssrc); |
- |
- // Sets the CName for the outgoing stream on the channel. |
- int32_t SetRTCPCName(const char* rtcp_cname); |
- |
- // Gets the CName of the incoming stream. |
- int32_t GetRemoteRTCPCName(char rtcp_cname[]); |
- |
- // Returns statistics reported by the remote client in an RTCP packet. |
- // TODO(pbos): Remove this along with VideoSendStream::GetRtt(). |
- int32_t GetSendRtcpStatistics(uint16_t* fraction_lost, |
- uint32_t* cumulative_lost, |
- uint32_t* extended_max, |
- uint32_t* jitter_samples, |
- int64_t* rtt_ms); |
- |
- // Called on receipt of RTCP report block from remote side. |
- void RegisterSendChannelRtcpStatisticsCallback( |
- RtcpStatisticsCallback* callback); |
- |
- // Called on generation of RTCP stats |
- void RegisterReceiveChannelRtcpStatisticsCallback( |
- RtcpStatisticsCallback* callback); |
- |
- // Gets send statistics for the rtp and rtx stream. |
- void GetSendStreamDataCounters(StreamDataCounters* rtp_counters, |
- StreamDataCounters* rtx_counters) const; |
- |
- // Gets received stream data counters. |
- void GetReceiveStreamDataCounters(StreamDataCounters* rtp_counters, |
- StreamDataCounters* rtx_counters) const; |
- |
- // Called on update of RTP statistics. |
- void RegisterSendChannelRtpStatisticsCallback( |
- StreamDataCountersCallback* callback); |
- |
- // Called on update of RTP statistics. |
- void RegisterReceiveChannelRtpStatisticsCallback( |
- StreamDataCountersCallback* callback); |
- |
- void GetSendRtcpPacketTypeCounter( |
- RtcpPacketTypeCounter* packet_counter) const; |
- |
- void GetReceiveRtcpPacketTypeCounter( |
- RtcpPacketTypeCounter* packet_counter) const; |
- |
- void RegisterSendSideDelayObserver(SendSideDelayObserver* observer); |
- |
- // Called on any new send bitrate estimate. |
- void RegisterSendBitrateObserver(BitrateStatisticsObserver* observer); |
- |
- // Implements RtpFeedback. |
- int32_t OnInitializeDecoder(const int8_t payload_type, |
- const char payload_name[RTP_PAYLOAD_NAME_SIZE], |
- const int frequency, |
- const uint8_t channels, |
- const uint32_t rate) override; |
- void OnIncomingSSRCChanged(const uint32_t ssrc) override; |
- void OnIncomingCSRCChanged(const uint32_t CSRC, const bool added) override; |
- |
- int32_t SetRemoteSSRCType(const StreamType usage, const uint32_t SSRC); |
- |
- int32_t StartSend(); |
- int32_t StopSend(); |
- bool Sending(); |
- void StartReceive(); |
- void StopReceive(); |
- |
- int32_t ReceivedRTPPacket(const void* rtp_packet, |
- const size_t rtp_packet_length, |
- const PacketTime& packet_time); |
- int32_t ReceivedRTCPPacket(const void* rtcp_packet, |
- const size_t rtcp_packet_length); |
- |
- // Sets the maximum transfer unit size for the network link, i.e. including |
- // IP, UDP and RTP headers. |
- int32_t SetMTU(uint16_t mtu); |
- |
- // Gets the modules used by the channel. |
- RtpRtcp* rtp_rtcp(); |
- rtc::scoped_refptr<PayloadRouter> send_payload_router(); |
- VCMProtectionCallback* vcm_protection_callback(); |
- |
- |
- CallStatsObserver* GetStatsObserver(); |
- |
- // Implements VCMReceiveCallback. |
- virtual int32_t FrameToRender(VideoFrame& video_frame); // NOLINT |
- |
- // Implements VCMReceiveCallback. |
- virtual int32_t ReceivedDecodedReferenceFrame( |
- const uint64_t picture_id); |
- |
- // Implements VCMReceiveCallback. |
- void OnIncomingPayloadType(int payload_type) override; |
- |
- // Implements VCMReceiveStatisticsCallback. |
- void OnReceiveRatesUpdated(uint32_t bit_rate, uint32_t frame_rate) override; |
- void OnDiscardedPacketsUpdated(int discarded_packets) override; |
- void OnFrameCountsUpdated(const FrameCounts& frame_counts) override; |
- |
- // Implements VCMDecoderTimingCallback. |
- virtual void OnDecoderTiming(int decode_ms, |
- int max_decode_ms, |
- int current_delay_ms, |
- int target_delay_ms, |
- int jitter_buffer_ms, |
- int min_playout_delay_ms, |
- int render_delay_ms); |
- |
- // Implements FrameTypeCallback. |
- virtual int32_t RequestKeyFrame(); |
- |
- // Implements FrameTypeCallback. |
- virtual int32_t SliceLossIndicationRequest( |
- const uint64_t picture_id); |
- |
- // Implements VideoPacketRequestCallback. |
- int32_t ResendPackets(const uint16_t* sequence_numbers, |
- uint16_t length) override; |
- |
- int32_t SetVoiceChannel(int32_t ve_channel_id, |
- VoEVideoSync* ve_sync_interface); |
- int32_t VoiceChannel(); |
- |
- // New-style callbacks, used by VideoReceiveStream. |
- void RegisterPreRenderCallback(I420FrameCallback* pre_render_callback); |
- void RegisterPreDecodeImageCallback( |
- EncodedImageCallback* pre_decode_callback); |
- |
- void RegisterSendFrameCountObserver(FrameCountObserver* observer); |
- void RegisterRtcpPacketTypeCounterObserver( |
- RtcpPacketTypeCounterObserver* observer); |
- void RegisterReceiveStatisticsProxy( |
- ReceiveStatisticsProxy* receive_statistics_proxy); |
- void SetIncomingVideoStream(IncomingVideoStream* incoming_video_stream); |
- |
- protected: |
- static bool ChannelDecodeThreadFunction(void* obj); |
- bool ChannelDecodeProcess(); |
- |
- void OnRttUpdate(int64_t avg_rtt_ms, int64_t max_rtt_ms); |
- |
- int ProtectionRequest(const FecProtectionParams* delta_fec_params, |
- const FecProtectionParams* key_fec_params, |
- uint32_t* sent_video_rate_bps, |
- uint32_t* sent_nack_rate_bps, |
- uint32_t* sent_fec_rate_bps); |
- |
- private: |
- static std::vector<RtpRtcp*> CreateRtpRtcpModules( |
- bool receiver_only, |
- ReceiveStatistics* receive_statistics, |
- Transport* outgoing_transport, |
- RtcpIntraFrameObserver* intra_frame_callback, |
- RtcpBandwidthObserver* bandwidth_callback, |
- TransportFeedbackObserver* transport_feedback_callback, |
- RtcpRttStats* rtt_stats, |
- RtcpPacketTypeCounterObserver* rtcp_packet_type_counter_observer, |
- RemoteBitrateEstimator* remote_bitrate_estimator, |
- RtpPacketSender* paced_sender, |
- TransportSequenceNumberAllocator* transport_sequence_number_allocator, |
- BitrateStatisticsObserver* send_bitrate_observer, |
- FrameCountObserver* send_frame_count_observer, |
- SendSideDelayObserver* send_side_delay_observer, |
- size_t num_modules); |
- |
- // Assumed to be protected. |
- void StartDecodeThread(); |
- void StopDecodeThread(); |
- |
- void ProcessNACKRequest(const bool enable); |
- // Compute NACK list parameters for the buffering mode. |
- int GetRequiredNackListSize(int target_delay_ms); |
- void SetRtxSendStatus(bool enable); |
- |
- void UpdateHistograms(); |
- |
- // ViEChannel exposes methods that allow to modify observers and callbacks |
- // to be modified. Such an API-style is cumbersome to implement and maintain |
- // at all the levels when comparing to only setting them at construction. As |
- // so this class instantiates its children with a wrapper that can be modified |
- // at a later time. |
- template <class T> |
- class RegisterableCallback : public T { |
- public: |
- RegisterableCallback() |
- : critsect_(CriticalSectionWrapper::CreateCriticalSection()), |
- callback_(NULL) {} |
- |
- void Set(T* callback) { |
- CriticalSectionScoped cs(critsect_.get()); |
- callback_ = callback; |
- } |
- |
- protected: |
- // Note: this should be implemented with a RW-lock to allow simultaneous |
- // calls into the callback. However that doesn't seem to be needed for the |
- // current type of callbacks covered by this class. |
- rtc::scoped_ptr<CriticalSectionWrapper> critsect_; |
- T* callback_ GUARDED_BY(critsect_); |
- |
- private: |
- RTC_DISALLOW_COPY_AND_ASSIGN(RegisterableCallback); |
- }; |
- |
- class RegisterableBitrateStatisticsObserver: |
- public RegisterableCallback<BitrateStatisticsObserver> { |
- virtual void Notify(const BitrateStatistics& total_stats, |
- const BitrateStatistics& retransmit_stats, |
- uint32_t ssrc) { |
- CriticalSectionScoped cs(critsect_.get()); |
- if (callback_) |
- callback_->Notify(total_stats, retransmit_stats, ssrc); |
- } |
- } send_bitrate_observer_; |
- |
- class RegisterableFrameCountObserver |
- : public RegisterableCallback<FrameCountObserver> { |
- public: |
- virtual void FrameCountUpdated(const FrameCounts& frame_counts, |
- uint32_t ssrc) { |
- CriticalSectionScoped cs(critsect_.get()); |
- if (callback_) |
- callback_->FrameCountUpdated(frame_counts, ssrc); |
- } |
- |
- private: |
- } send_frame_count_observer_; |
- |
- class RegisterableSendSideDelayObserver : |
- public RegisterableCallback<SendSideDelayObserver> { |
- void SendSideDelayUpdated(int avg_delay_ms, |
- int max_delay_ms, |
- uint32_t ssrc) override { |
- CriticalSectionScoped cs(critsect_.get()); |
- if (callback_) |
- callback_->SendSideDelayUpdated(avg_delay_ms, max_delay_ms, ssrc); |
- } |
- } send_side_delay_observer_; |
- |
- class RegisterableRtcpPacketTypeCounterObserver |
- : public RegisterableCallback<RtcpPacketTypeCounterObserver> { |
- public: |
- void RtcpPacketTypesCounterUpdated( |
- uint32_t ssrc, |
- const RtcpPacketTypeCounter& packet_counter) override { |
- CriticalSectionScoped cs(critsect_.get()); |
- if (callback_) |
- callback_->RtcpPacketTypesCounterUpdated(ssrc, packet_counter); |
- counter_map_[ssrc] = packet_counter; |
- } |
- |
- virtual std::map<uint32_t, RtcpPacketTypeCounter> GetPacketTypeCounterMap() |
- const { |
- CriticalSectionScoped cs(critsect_.get()); |
- return counter_map_; |
- } |
- |
- private: |
- std::map<uint32_t, RtcpPacketTypeCounter> counter_map_ |
- GUARDED_BY(critsect_); |
- } rtcp_packet_type_counter_observer_; |
- |
- const uint32_t number_of_cores_; |
- const bool sender_; |
- |
- ProcessThread* const module_process_thread_; |
- |
- // Used for all registered callbacks except rendering. |
- rtc::scoped_ptr<CriticalSectionWrapper> crit_; |
- |
- // Owned modules/classes. |
- rtc::scoped_refptr<PayloadRouter> send_payload_router_; |
- rtc::scoped_ptr<ViEChannelProtectionCallback> vcm_protection_callback_; |
- |
- VideoCodingModule* const vcm_; |
- ViEReceiver vie_receiver_; |
- ViESyncModule vie_sync_; |
- |
- // Helper to report call statistics. |
- rtc::scoped_ptr<ChannelStatsObserver> stats_observer_; |
- |
- // Not owned. |
- ReceiveStatisticsProxy* receive_stats_callback_ GUARDED_BY(crit_); |
- FrameCounts receive_frame_counts_ GUARDED_BY(crit_); |
- IncomingVideoStream* incoming_video_stream_ GUARDED_BY(crit_); |
- RtcpIntraFrameObserver* const intra_frame_observer_; |
- RtcpRttStats* const rtt_stats_; |
- PacedSender* const paced_sender_; |
- PacketRouter* const packet_router_; |
- |
- const rtc::scoped_ptr<RtcpBandwidthObserver> bandwidth_observer_; |
- TransportFeedbackObserver* const transport_feedback_observer_; |
- |
- rtc::PlatformThread decode_thread_; |
- |
- int nack_history_size_sender_; |
- int max_nack_reordering_threshold_; |
- I420FrameCallback* pre_render_callback_ GUARDED_BY(crit_); |
- |
- const rtc::scoped_ptr<ReportBlockStats> report_block_stats_sender_; |
- |
- int64_t time_of_first_rtt_ms_ GUARDED_BY(crit_); |
- int64_t rtt_sum_ms_ GUARDED_BY(crit_); |
- int64_t last_rtt_ms_ GUARDED_BY(crit_); |
- size_t num_rtts_ GUARDED_BY(crit_); |
- |
- // RtpRtcp modules, declared last as they use other members on construction. |
- const std::vector<RtpRtcp*> rtp_rtcp_modules_; |
- size_t num_active_rtp_rtcp_modules_ GUARDED_BY(crit_); |
-}; |
- |
-} // namespace webrtc |
- |
-#endif // WEBRTC_VIDEO_ENGINE_VIE_CHANNEL_H_ |