mediasoup-sys 0.5.3

FFI bindings to C++ libmediasoup-worker
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

#ifndef MS_RTC_RTP_STREAM_SEND_HPP
#define MS_RTC_RTP_STREAM_SEND_HPP

#include "RTC/RateCalculator.hpp"
#include "RTC/RtpStream.hpp"
#include <deque>

namespace RTC
{
	class RtpStreamSend : public RTC::RtpStream
	{
	public:
		// Minimum retransmission buffer size (ms).
		const static uint32_t MinRetransmissionDelay;
		// Maximum retransmission buffer size (ms).
		const static uint32_t MaxRetransmissionDelay;

	public:
		class Listener : public RTC::RtpStream::Listener
		{
		public:
			virtual void OnRtpStreamRetransmitRtpPacket(
			  RTC::RtpStreamSend* rtpStream, RTC::RtpPacket* packet) = 0;
		};

	public:
		struct StorageItem
		{
			void Reset();

			// Original packet.
			std::shared_ptr<RTC::RtpPacket> packet{ nullptr };
			// Correct SSRC since original packet may not have the same.
			uint32_t ssrc{ 0 };
			// Correct sequence number since original packet may not have the same.
			uint16_t sequenceNumber{ 0 };
			// Correct timestamp since original packet may not have the same.
			uint32_t timestamp{ 0 };
			// Last time this packet was resent.
			uint64_t resentAtMs{ 0u };
			// Number of times this packet was resent.
			uint8_t sentTimes{ 0u };
		};

	private:
		// Special container that stores `StorageItem*` elements addressable by
		// their `uint16_t` sequence number, while only taking as little memory as
		// necessary to store the range covering a maximum of
		// `MaxRetransmissionDelay` milliseconds.
		class StorageItemBuffer
		{
		public:
			~StorageItemBuffer();

			StorageItem* GetFirst() const;
			StorageItem* Get(uint16_t seq) const;
			size_t GetBufferSize() const;
			void Insert(uint16_t seq, StorageItem* storageItem);
			void RemoveFirst();
			void Clear();

		private:
			uint16_t startSeq{ 0 };
			std::deque<StorageItem*> buffer;
		};

	public:
		RtpStreamSend(
		  RTC::RtpStreamSend::Listener* listener, RTC::RtpStream::Params& params, std::string& mid);
		~RtpStreamSend() override;

		void FillJsonStats(json& jsonObject) override;
		void SetRtx(uint8_t payloadType, uint32_t ssrc) override;
		bool ReceivePacket(RTC::RtpPacket* packet, std::shared_ptr<RTC::RtpPacket>& sharedPacket);
		void ReceiveNack(RTC::RTCP::FeedbackRtpNackPacket* nackPacket);
		void ReceiveKeyFrameRequest(RTC::RTCP::FeedbackPs::MessageType messageType);
		void ReceiveRtcpReceiverReport(RTC::RTCP::ReceiverReport* report);
		void ReceiveRtcpXrReceiverReferenceTime(RTC::RTCP::ReceiverReferenceTime* report);
		RTC::RTCP::SenderReport* GetRtcpSenderReport(uint64_t nowMs);
		RTC::RTCP::DelaySinceLastRr::SsrcInfo* GetRtcpXrDelaySinceLastRr(uint64_t nowMs);
		RTC::RTCP::SdesChunk* GetRtcpSdesChunk();
		void Pause() override;
		void Resume() override;
		uint32_t GetBitrate(uint64_t nowMs) override
		{
			return this->transmissionCounter.GetBitrate(nowMs);
		}
		uint32_t GetBitrate(uint64_t nowMs, uint8_t spatialLayer, uint8_t temporalLayer) override;
		uint32_t GetSpatialLayerBitrate(uint64_t nowMs, uint8_t spatialLayer) override;
		uint32_t GetLayerBitrate(uint64_t nowMs, uint8_t spatialLayer, uint8_t temporalLayer) override;

	private:
		void StorePacket(RTC::RtpPacket* packet, std::shared_ptr<RTC::RtpPacket>& sharedPacket);
		void ClearOldPackets(const RtpPacket* packet);
		void ClearBuffer();
		void FillRetransmissionContainer(uint16_t seq, uint16_t bitmask);
		void UpdateScore(RTC::RTCP::ReceiverReport* report);

	private:
		uint32_t lostPriorScore{ 0u }; // Packets lost at last interval for score calculation.
		uint32_t sentPriorScore{ 0u }; // Packets sent at last interval for score calculation.
		StorageItemBuffer storageItemBuffer;
		std::string mid;
		uint32_t retransmissionBufferSize;
		uint16_t rtxSeq{ 0u };
		RTC::RtpDataCounter transmissionCounter;
		uint32_t lastRrTimestamp{ 0u };  // The middle 32 bits out of 64 in the NTP
		                                 // timestamp received in the most recent
		                                 // receiver reference timestamp.
		uint64_t lastRrReceivedMs{ 0u }; // Wallclock time representing the most recent
		                                 // receiver reference timestamp arrival.
	};
} // namespace RTC

#endif