/*
|
* Copyright (c) 2011 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_MODULES_VIDEO_CODING_RECEIVER_H_
|
#define WEBRTC_MODULES_VIDEO_CODING_RECEIVER_H_
|
|
#include <vector>
|
|
#include "webrtc/modules/video_coding/jitter_buffer.h"
|
#include "webrtc/modules/video_coding/packet.h"
|
#include "webrtc/modules/video_coding/timing.h"
|
#include "webrtc/system_wrappers/include/critical_section_wrapper.h"
|
#include "webrtc/modules/video_coding/include/video_coding.h"
|
#include "webrtc/modules/video_coding/include/video_coding_defines.h"
|
|
namespace webrtc {
|
|
class Clock;
|
class VCMEncodedFrame;
|
|
class VCMReceiver {
|
public:
|
VCMReceiver(VCMTiming* timing, Clock* clock, EventFactory* event_factory);
|
|
// Using this constructor, you can specify a different event factory for the
|
// jitter buffer. Useful for unit tests when you want to simulate incoming
|
// packets, in which case the jitter buffer's wait event is different from
|
// that of VCMReceiver itself.
|
VCMReceiver(VCMTiming* timing,
|
Clock* clock,
|
rtc::scoped_ptr<EventWrapper> receiver_event,
|
rtc::scoped_ptr<EventWrapper> jitter_buffer_event);
|
|
~VCMReceiver();
|
|
void Reset();
|
void UpdateRtt(int64_t rtt);
|
int32_t InsertPacket(const VCMPacket& packet,
|
uint16_t frame_width,
|
uint16_t frame_height);
|
VCMEncodedFrame* FrameForDecoding(uint16_t max_wait_time_ms,
|
int64_t* next_render_time_ms,
|
bool prefer_late_decoding);
|
void ReleaseFrame(VCMEncodedFrame* frame);
|
void ReceiveStatistics(uint32_t* bitrate, uint32_t* framerate);
|
uint32_t DiscardedPackets() const;
|
|
// NACK.
|
void SetNackMode(VCMNackMode nackMode,
|
int64_t low_rtt_nack_threshold_ms,
|
int64_t high_rtt_nack_threshold_ms);
|
void SetNackSettings(size_t max_nack_list_size,
|
int max_packet_age_to_nack,
|
int max_incomplete_time_ms);
|
VCMNackMode NackMode() const;
|
std::vector<uint16_t> NackList(bool* request_key_frame);
|
|
// Receiver video delay.
|
int SetMinReceiverDelay(int desired_delay_ms);
|
|
// Decoding with errors.
|
void SetDecodeErrorMode(VCMDecodeErrorMode decode_error_mode);
|
VCMDecodeErrorMode DecodeErrorMode() const;
|
|
// Returns size in time (milliseconds) of complete continuous frames in the
|
// jitter buffer. The render time is estimated based on the render delay at
|
// the time this function is called.
|
int RenderBufferSizeMs();
|
|
void RegisterStatsCallback(VCMReceiveStatisticsCallback* callback);
|
|
void TriggerDecoderShutdown();
|
|
private:
|
CriticalSectionWrapper* crit_sect_;
|
Clock* const clock_;
|
VCMJitterBuffer jitter_buffer_;
|
VCMTiming* timing_;
|
rtc::scoped_ptr<EventWrapper> render_wait_event_;
|
int max_video_delay_ms_;
|
};
|
|
} // namespace webrtc
|
|
#endif // WEBRTC_MODULES_VIDEO_CODING_RECEIVER_H_
|
