mediasoup-sys 0.11.0

#define MS_CLASS "RTC::RTP::Packet"
// #define MS_LOG_DEV_LEVEL 3

#include "RTC/RTP/Packet.hpp"
#ifdef MS_RTC_LOGGER_RTP
#include "DepLibUV.hpp"
#endif
#include "Logger.hpp"
#include "MediaSoupErrors.hpp"
#include "RTC/Consts.hpp"
#include <cstring>  // std::memmove(), std::memset()
#include <iterator> // std::ostream_iterator
#include <sstream>  // std::ostringstream

namespace RTC
{
	namespace RTP
	{
		/* Class variables. */

		thread_local uint32_t Packet::nextMediasoupPacketId{ Utils::Crypto::GetRandomUInt<uint32_t>(
			0, std::numeric_limits<uint32_t>::max() / 2) };

		/* Class methods. */

		bool Packet::IsRtp(const uint8_t* buffer, size_t bufferLength)
		{
			MS_TRACE();

			return (
			  bufferLength >= Packet::FixedHeaderMinLength &&
			  // @see RFC 7983.
			  (buffer[0] > 127 && buffer[0] < 192) &&
			  // RTP Version must be 2.
			  (buffer[0] >> 6) == 2);
		}

		Packet* Packet::Parse(const uint8_t* buffer, size_t packetLength, size_t bufferLength)
		{
			MS_TRACE();

			if (packetLength > bufferLength)
			{
				MS_THROW_TYPE_ERROR(
				  "packetLength (%zu bytes) cannot be bigger than bufferLength (%zu bytes)",
				  packetLength,
				  bufferLength);
			}

			if (!Packet::IsRtp(buffer, packetLength))
			{
				MS_WARN_TAG(rtp, "not a RTP Packet");

				return nullptr;
			}

			auto* packet = new Packet(const_cast<uint8_t*>(buffer), bufferLength);

			packet->SetLength(packetLength);

			if (!packet->Validate(/*storeExtensions*/ true))
			{
				delete packet;
				return nullptr;
			}

			return packet;
		}

		Packet* Packet::Parse(const uint8_t* buffer, size_t bufferLength)
		{
			MS_TRACE();

			if (!Packet::IsRtp(buffer, bufferLength))
			{
				MS_WARN_TAG(rtp, "not a RTP Packet");

				return nullptr;
			}

			auto* packet = new Packet(const_cast<uint8_t*>(buffer), bufferLength);

			packet->SetLength(bufferLength);

			if (!packet->Validate(/*storeExtensions*/ true))
			{
				delete packet;
				return nullptr;
			}

			return packet;
		}

		Packet* Packet::Factory(uint8_t* buffer, size_t bufferLength)
		{
			MS_TRACE();

			if (bufferLength < Packet::FixedHeaderMinLength)
			{
				MS_THROW_TYPE_ERROR("no space for fixed header");
			}

			auto* packet      = new Packet(buffer, bufferLength);
			auto* fixedHeader = packet->GetFixedHeaderPointer();

			fixedHeader->version        = 2;
			fixedHeader->padding        = 0;
			fixedHeader->extension      = 0;
			fixedHeader->csrcCount      = 0;
			fixedHeader->marker         = 0;
			fixedHeader->payloadType    = 0;
			fixedHeader->sequenceNumber = 0;
			fixedHeader->timestamp      = 0;
			fixedHeader->ssrc           = 0;

			// No need to invoke SetLength() since constructor invoked it with
			// minimum Packet length.

			return packet;
		}

		uint32_t Packet::GetNextMediasoupPacketId()
		{
			MS_TRACE();

			return Packet::nextMediasoupPacketId++;
		}

		/* Instance methods. */

		Packet::Packet(uint8_t* buffer, size_t bufferLength) : Serializable(buffer, bufferLength)
		{
			MS_TRACE();

			SetLength(Packet::FixedHeaderMinLength);

#ifdef MS_RTC_LOGGER_RTP
			// Initialize logger.
			this->logger.timestamp        = DepLibUV::GetTimeMs();
			this->logger.recvRtpTimestamp = GetTimestamp();
			this->logger.recvSeqNumber    = GetSequenceNumber();
#endif
		}

		Packet::~Packet()
		{
			MS_TRACE();
		}

		void Packet::Dump(int indentation) const
		{
			MS_TRACE();

			MS_DUMP_CLEAN(indentation, "<RTP::Packet>");

			MS_DUMP_CLEAN(indentation, "  length: %zu (buffer length: %zu)", GetLength(), GetBufferLength());
			MS_DUMP_CLEAN(indentation, "  sequence number: %" PRIu16, GetSequenceNumber());
			MS_DUMP_CLEAN(indentation, "  timestamp: %" PRIu32, GetTimestamp());
			MS_DUMP_CLEAN(indentation, "  marker: %s", HasMarker() ? "true" : "false");
			MS_DUMP_CLEAN(indentation, "  payload type: %" PRIu8, GetPayloadType());
			MS_DUMP_CLEAN(indentation, "  ssrc: %" PRIu32, GetSsrc());
			MS_DUMP_CLEAN(indentation, "  csrcs: %s", HasCsrcs() ? "true" : "false");

			if (HasHeaderExtension())
			{
				MS_DUMP_CLEAN(
				  indentation,
				  "  header extension: id:%" PRIu16 ", value length:%zu",
				  GetHeaderExtensionId(),
				  GetHeaderExtensionValueLength());
			}

			if (HasExtensions())
			{
				std::vector<std::string> extIds;
				std::ostringstream extIdsStream;

				if (HasOneByteExtensions())
				{
					for (const auto offset : this->oneByteExtensions)
					{
						if (offset == -1)
						{
							continue;
						}

						auto* extension = reinterpret_cast<OneByteExtension*>(GetHeaderExtensionValue() + offset);

						extIds.push_back(
						  "{id:" + std::to_string(extension->id) +
						  ", len:" + std::to_string(extension->len + 1) + "}");
					}
				}
				else
				{
					extIds.reserve(this->twoBytesExtensions.size());

					for (const auto& kv : this->twoBytesExtensions)
					{
						const auto offset = kv.second;

						if (offset == -1)
						{
							continue;
						}

						auto* extension =
						  reinterpret_cast<TwoBytesExtension*>(GetHeaderExtensionValue() + offset);

						extIds.push_back(
						  "{id:" + std::to_string(extension->id) + ", len:" + std::to_string(extension->len) +
						  "}");
					}
				}

				if (!extIds.empty())
				{
					std::copy(
					  extIds.begin(), extIds.end() - 1, std::ostream_iterator<std::string>(extIdsStream, ", "));
					extIdsStream << extIds.back();

					MS_DUMP_CLEAN(
					  indentation,
					  "  RFC5285 extensions (%s): %s",
					  HasOneByteExtensions() ? "One-Byte" : "Two-Bytes",
					  extIdsStream.str().c_str());
				}

				MS_DUMP_CLEAN(indentation + 1, "<Extensions>");

				{
					std::string mid;

					if (ReadMid(mid))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  mid: id:%" PRIu8 ", value:'%s'",
						  this->headerExtensionIds.mid,
						  mid.c_str());
					}
				}

				{
					std::string rid;

					if (ReadRid(rid))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  rid: id:%" PRIu8 ", value:'%s'",
						  this->headerExtensionIds.rid,
						  rid.c_str());
					}
				}

				{
					std::string rrid;

					if (ReadRid(rrid))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  rrid: id:%" PRIu8 ", value:'%s'",
						  this->headerExtensionIds.rrid,
						  rrid.c_str());
					}
				}

				{
					uint32_t absSendtime;

					if (ReadAbsSendTime(absSendtime))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  absSendTime: id:%" PRIu8 ", value:%" PRIu32,
						  this->headerExtensionIds.absSendTime,
						  absSendtime);
					}
				}

				{
					uint16_t wideSeqNumber{ 0 };

					if (ReadTransportWideCc01(wideSeqNumber))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  transportWideCc01: id:%" PRIu8 ", value:%" PRIu16,
						  this->headerExtensionIds.transportWideCc01,
						  wideSeqNumber);
					}
				}

				{
					uint8_t volume{ 0 };
					bool voice{ false };

					if (ReadSsrcAudioLevel(volume, voice))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  ssrcAudioLevel: id:%" PRIu8 ", volume:%" PRIu8 ", voice:%s",
						  this->headerExtensionIds.ssrcAudioLevel,
						  volume,
						  voice ? "true" : "false");
					}
				}

				{
					uint8_t extenLen;
					const uint8_t* extenValue =
					  GetExtensionValue(this->headerExtensionIds.dependencyDescriptor, extenLen);

					if (extenValue)
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  dependencyDescriptor: id:%" PRIu8 ", length:%" PRIu8,
						  this->headerExtensionIds.dependencyDescriptor,
						  extenLen);
					}
				}

				{
					bool camera{ false };
					bool flip{ false };
					uint16_t rotation{ 0 };

					if (ReadVideoOrientation(camera, flip, rotation))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  videoOrientation: id:%" PRIu8 ", camera:%s, flip:%s, rotation:%" PRIu16,
						  this->headerExtensionIds.videoOrientation,
						  camera ? "true" : "false",
						  flip ? "true" : "false",
						  rotation);
					}
				}

				{
					uint64_t absCaptureTimestamp{ 0 };
					int64_t estimatedCaptureClockOffset{ 0 };

					if (ReadAbsCaptureTime(absCaptureTimestamp, estimatedCaptureClockOffset))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  absCaptureTime: id:%" PRIu8 ", absCaptureTimestamp:%" PRIu64
						  ", estimatedCaptureClockOffset:%" PRId64,
						  this->headerExtensionIds.absCaptureTime,
						  absCaptureTimestamp,
						  estimatedCaptureClockOffset);
					}
				}

				{
					uint16_t minDelay{ 0 };
					uint16_t maxDelay{ 0 };

					if (ReadPlayoutDelay(minDelay, maxDelay))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  playoutDelay: id:%" PRIu8 ", minDelay:%" PRIu16 ", maxDelay:%" PRIu16,
						  this->headerExtensionIds.playoutDelay,
						  minDelay,
						  maxDelay);
					}
				}

				{
					uint32_t mediasoupPacketId{ 0 };

					if (ReadMediasoupPacketId(mediasoupPacketId))
					{
						MS_DUMP_CLEAN(
						  indentation + 1,
						  "  mediasoupPacketId: id:%" PRIu8 ", mediasoupPacketId:%" PRIu32,
						  this->headerExtensionIds.mediasoupPacketId,
						  mediasoupPacketId);
					}
				}

				MS_DUMP_CLEAN(indentation + 1, "</Extensions>");
			}

			MS_DUMP_CLEAN(indentation, "  payload length: %zu", GetPayloadLength());
			MS_DUMP_CLEAN(indentation, "  padding length: %" PRIu8, GetPaddingLength());
			MS_DUMP_CLEAN(indentation, "  padded to 4 bytes: %s", IsPaddedTo4Bytes() ? "yes" : "no");

			if (this->payloadDescriptorHandler)
			{
				MS_DUMP_CLEAN(indentation + 1, "<PayloadDescriptorHandler>");

				MS_DUMP_CLEAN(indentation + 1, "  key frame: %s", IsKeyFrame() ? "true" : "false");
				MS_DUMP_CLEAN(indentation + 1, "  spatial layer: %" PRIu8, GetSpatialLayer());
				MS_DUMP_CLEAN(indentation + 1, "  temporal layer: %" PRIu8, GetTemporalLayer());
#ifdef MS_DUMP_RTP_PAYLOAD_DESCRIPTOR
				this->payloadDescriptorHandler->Dump(indentation + 2);
#endif
				MS_DUMP_CLEAN(indentation + 1, "</PayloadDescriptorHandler>");
			}

			MS_DUMP_CLEAN(indentation, "</RTP::Packet>");
		}

		Packet* Packet::Clone(uint8_t* buffer, size_t bufferLength) const
		{
			MS_TRACE();

			auto* clonedPacket = new Packet(buffer, bufferLength);

			Serializable::CloneInto(clonedPacket);

			// Clone Extension containers.
			clonedPacket->oneByteExtensions  = this->oneByteExtensions;
			clonedPacket->twoBytesExtensions = this->twoBytesExtensions;

			// Clone Extension ids.
			clonedPacket->headerExtensionIds = this->headerExtensionIds;

			// Assign the payload descriptor handler.
			clonedPacket->payloadDescriptorHandler = this->payloadDescriptorHandler;

			if (this->payloadDescriptorHandler)
			{
				clonedPacket->payloadDescriptorHandler->RtpPacketChanged(clonedPacket);
			}

			return clonedPacket;
		}

		flatbuffers::Offset<FBS::RtpPacket::Dump> Packet::FillBuffer(
		  flatbuffers::FlatBufferBuilder& builder) const
		{
			MS_TRACE();

			// Add mid.
			std::string mid;

			ReadMid(mid);

			// Add rid.
			std::string rid;

			ReadRid(rid);

			// Add rrid.
			std::string rrid;

			ReadRid(rrid);

			// Add wideSequenceNumber.
			uint16_t wideSequenceNumber{ 0 };
			bool wideSequenceNumberSet{ false };

			if (ReadTransportWideCc01(wideSequenceNumber))
			{
				wideSequenceNumberSet = true;
			}

			return FBS::RtpPacket::CreateDumpDirect(
			  builder,
			  this->GetPayloadType(),
			  this->GetSequenceNumber(),
			  this->GetTimestamp(),
			  this->HasMarker(),
			  this->GetSsrc(),
			  this->IsKeyFrame(),
			  this->GetLength(),
			  this->GetPayloadLength(),
			  this->GetSpatialLayer(),
			  this->GetTemporalLayer(),
			  mid.empty() ? nullptr : mid.c_str(),
			  rid.empty() ? nullptr : rid.c_str(),
			  rrid.empty() ? nullptr : rrid.c_str(),
			  wideSequenceNumberSet ? flatbuffers::Optional<uint16_t>(wideSequenceNumber)
			                        : flatbuffers::nullopt);
		}

		void Packet::SetPayloadType(uint8_t payloadType)
		{
			MS_TRACE();

			GetFixedHeaderPointer()->payloadType = payloadType;
		}

		void Packet::SetMarker(bool marker)
		{
			MS_TRACE();

			GetFixedHeaderPointer()->marker = marker;
		}

		void Packet::SetSequenceNumber(uint16_t seq)
		{
			MS_TRACE();

			GetFixedHeaderPointer()->sequenceNumber = htons(seq);
		}

		void Packet::SetTimestamp(uint32_t timestamp)
		{
			MS_TRACE();

			GetFixedHeaderPointer()->timestamp = htonl(timestamp);
		}

		void Packet::SetSsrc(uint32_t ssrc)
		{
			MS_TRACE();

			GetFixedHeaderPointer()->ssrc = htonl(ssrc);
		}

		void Packet::RemoveHeaderExtension()
		{
			MS_TRACE();

			if (!HasHeaderExtension())
			{
				return;
			}

			// Clear One-Byte and Two-Bytes Extensions.
			std::fill(std::begin(this->oneByteExtensions), std::end(this->oneByteExtensions), -1);
			this->twoBytesExtensions.clear();

			const auto headerExtensionLength = GetHeaderExtensionLength();

			auto* payload            = GetPayloadPointer();
			const auto payloadLength = GetPayloadLength();
			const auto paddingLength = GetPaddingLength();

			// Update Packet length.
			// NOTE: This throws if given length is higher than buffer length.
			SetLength(GetLength() - headerExtensionLength);

			// Unset the Header Extension flag.
			GetFixedHeaderPointer()->extension = 0;

			// Shift the payload.
			std::memmove(payload - headerExtensionLength, payload, payloadLength + paddingLength);
		}

		void Packet::SetExtensions(ExtensionsType type, const std::vector<Extension>& extensions)
		{
			MS_TRACE();

			// Clear One-Byte and Two-Bytes Extensions.
			std::fill(std::begin(this->oneByteExtensions), std::end(this->oneByteExtensions), -1);
			this->twoBytesExtensions.clear();

			// Reset Extension ids.
			this->headerExtensionIds = {};

			const auto hadHeaderExtension                 = HasHeaderExtension();
			const auto previousHeaderExtensionValueLength = GetHeaderExtensionValueLength();

			// If no explicit ExtensionType is given then select the best one based
			// on given Extensions.
			if (type == ExtensionsType::Auto)
			{
				uint8_t highestId{ 0 };
				uint8_t highestLen{ 0 };

				for (const auto& extension : extensions)
				{
					highestId  = std::max(extension.id, highestId);
					highestLen = std::max(extension.len, highestLen);
				}

				type = highestId <= 14 && highestLen > 0 && highestLen <= 16 ? ExtensionsType::OneByte
				                                                             : ExtensionsType::TwoBytes;

				MS_DEBUG_DEV(
				  "using %" PRIu8 " byte(s) extensions [highestId:%" PRIu8 ", highestLen:%" PRIu8 "]",
				  type,
				  highestId,
				  highestLen);
			}

			// If One-Byte is requested and the Packet already has One-Byte Extensions,
			// keep the Header Extension id.
			if (type == ExtensionsType::OneByte && HasOneByteExtensions())
			{
				// Nothing to do.
			}
			// If Two-Bytes is requested and the Packet already has Two-Bytes Extensions,
			// keep the Header Extension id.
			else if (type == ExtensionsType::TwoBytes && HasTwoBytesExtensions())
			{
				// Nothing to do.
			}
			// Otherwise, if there is Header Extension of non matching type, modify its id.
			else if (hadHeaderExtension)
			{
				if (type == ExtensionsType::OneByte)
				{
					GetHeaderExtensionPointer()->id = htons(0xBEDE);
				}
				else if (type == ExtensionsType::TwoBytes)
				{
					GetHeaderExtensionPointer()->id = htons(0b0001000000000000);
				}
			}

			// Calculate total length required for all Extensions (with padding if needed).
			size_t extensionsLength{ 0 };

			if (type == ExtensionsType::OneByte)
			{
				for (const auto& extension : extensions)
				{
					if (extension.id == 0)
					{
						MS_THROW_TYPE_ERROR("invalid Extension with id 0");
					}
					else if (extension.id > 14)
					{
						MS_THROW_TYPE_ERROR(
						  "invalid Extension with id %" PRIu8 " > 14 when using One-Byte Extensions",
						  extension.id);
					}
					else if (extension.len == 0)
					{
						MS_THROW_TYPE_ERROR(
						  "invalid Extension with id %" PRIu8 " and length 0 when using One-Byte Extensions",
						  extension.id);
					}
					else if (extension.len > 16)
					{
						MS_THROW_TYPE_ERROR(
						  "invalid Extension with id %" PRIu8 " and length %" PRIu8
						  " when using One-Byte Extensions",
						  extension.id,
						  extension.len);
					}

					extensionsLength += (1 + extension.len);
				}
			}
			else if (type == ExtensionsType::TwoBytes)
			{
				for (const auto& extension : extensions)
				{
					if (extension.id == 0)
					{
						MS_THROW_TYPE_ERROR("invalid Extension with id 0");
					}

					extensionsLength += (2 + extension.len);
				}
			}

			auto paddedExtensionsLength          = Utils::Byte::PadTo4Bytes(extensionsLength);
			const size_t extensionsPaddingLength = paddedExtensionsLength - extensionsLength;

			// Calculate the number of bytes to shift (may be negative if the Packet
			// already had Header Extension).
			int16_t shift{ 0 };

			if (hadHeaderExtension)
			{
				shift = static_cast<int16_t>(paddedExtensionsLength - previousHeaderExtensionValueLength);
			}
			else
			{
				shift = 4 + static_cast<int16_t>(paddedExtensionsLength);
			}

			auto* payload            = GetPayloadPointer();
			const auto payloadLength = GetPayloadLength();
			const auto paddingLength = GetPaddingLength();

			if (hadHeaderExtension && shift != 0)
			{
				// Update Packet length.
				// NOTE: This throws if given length is higher than buffer length.
				SetLength(GetLength() + shift);

				// Update the Header Extension length.
				GetHeaderExtensionPointer()->len = htons(paddedExtensionsLength / 4);

				// Shift the payload.
				std::memmove(payload + shift, payload, payloadLength + paddingLength);
			}
			else if (!hadHeaderExtension)
			{
				// Update Packet length.
				// NOTE: This throws if given length is higher than buffer length.
				SetLength(GetLength() + shift);

				// Set the Header Extension flag.
				GetFixedHeaderPointer()->extension = 1;

				auto* headerExtension = GetHeaderExtensionPointer();

				// Shift the payload.
				// NOTE: We need to move payload before code below, otherwise we would
				// override written bytes later.
				std::memmove(payload + shift, payload, payloadLength + paddingLength);

				// Set the Header Extension id.
				if (type == ExtensionsType::OneByte)
				{
					headerExtension->id = htons(0xBEDE);
				}
				else if (type == ExtensionsType::TwoBytes)
				{
					headerExtension->id = htons(0b0001000000000000);
				}

				// Set the Header Extension length.
				headerExtension->len = htons(paddedExtensionsLength / 4);
			}

			const uint8_t* extensionsStart = GetHeaderExtensionValue();
			auto* ptr                      = const_cast<uint8_t*>(extensionsStart);

			if (type == ExtensionsType::OneByte)
			{
				for (const auto& extension : extensions)
				{
					// Store the One-Byte Extension offset in the array.
					// `-1` because we have 14 elements total 0..13 and `id` is in the
					// range 1..14.
					this->oneByteExtensions[extension.id - 1] = ptr - extensionsStart;

					*ptr = (extension.id << 4) | ((extension.len - 1) & 0x0F);
					++ptr;
					std::memmove(ptr, extension.value, extension.len);
					ptr += extension.len;
				}
			}
			else if (type == ExtensionsType::TwoBytes)
			{
				for (const auto& extension : extensions)
				{
					// Store the Two-Bytes Extension offset in the map.
					this->twoBytesExtensions[extension.id] = ptr - extensionsStart;

					*ptr = extension.id;
					++ptr;
					*ptr = extension.len;
					++ptr;
					std::memmove(ptr, extension.value, extension.len);
					ptr += extension.len;
				}
			}

			for (size_t i = 0; i < extensionsPaddingLength; ++i)
			{
				*ptr = 0;
				++ptr;
			}

			// Assign Extension ids.
			for (const auto& extension : extensions)
			{
				switch (extension.type)
				{
					case RTC::RtpHeaderExtensionUri::Type::MID:
					{
						this->headerExtensionIds.mid = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::RTP_STREAM_ID:
					{
						this->headerExtensionIds.rid = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::REPAIRED_RTP_STREAM_ID:
					{
						this->headerExtensionIds.rrid = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::ABS_SEND_TIME:
					{
						this->headerExtensionIds.absSendTime = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::TRANSPORT_WIDE_CC_01:
					{
						this->headerExtensionIds.transportWideCc01 = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::SSRC_AUDIO_LEVEL:
					{
						this->headerExtensionIds.ssrcAudioLevel = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::DEPENDENCY_DESCRIPTOR:
					{
						this->headerExtensionIds.dependencyDescriptor = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::VIDEO_ORIENTATION:
					{
						this->headerExtensionIds.videoOrientation = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::TIME_OFFSET:
					{
						this->headerExtensionIds.timeOffset = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::ABS_CAPTURE_TIME:
					{
						this->headerExtensionIds.absCaptureTime = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::PLAYOUT_DELAY:
					{
						this->headerExtensionIds.playoutDelay = extension.id;
						break;
					}

					case RTC::RtpHeaderExtensionUri::Type::MEDIASOUP_PACKET_ID:
					{
						this->headerExtensionIds.mediasoupPacketId = extension.id;
						break;
					}
				}
			}
		}

		void Packet::AssignExtensionIds(RTP::HeaderExtensionIds& headerExtensionIds)
		{
			MS_TRACE();

			// Reset Extension ids.
			this->headerExtensionIds = headerExtensionIds;
		}

		bool Packet::ReadMid(std::string& mid) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.mid == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue = GetExtensionValue(this->headerExtensionIds.mid, extenLen);

			if (!extenValue || extenLen == 0)
			{
				return false;
			}

			mid.assign(reinterpret_cast<const char*>(extenValue), static_cast<size_t>(extenLen));

			return true;
		}

		bool Packet::UpdateMid(const std::string& mid)
		{
			MS_TRACE();

			uint8_t extenLen;
			uint8_t* extenValue = GetExtensionValue(this->headerExtensionIds.mid, extenLen);

			if (!extenValue)
			{
				return false;
			}

			const size_t midLen = mid.length();

			// Here we assume that there is MidRtpExtensionMaxLength available bytes,
			// even if now they are padding bytes.
			if (midLen > RTC::Consts::MidRtpExtensionMaxLength)
			{
				MS_ERROR(
				  "no enough space for MID value [MidRtpExtensionMaxLength:%" PRIu8 ", mid:'%s']",
				  RTC::Consts::MidRtpExtensionMaxLength,
				  mid.c_str());

				return false;
			}

			std::memcpy(extenValue, mid.c_str(), midLen);

			SetExtensionLength(this->headerExtensionIds.mid, midLen);

			return true;
		}

		bool Packet::ReadRid(std::string& rid) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.rid == 0 && this->headerExtensionIds.rrid == 0)
			{
				return false;
			}

			// First try with the RID id then with the Repaired RID id.
			uint8_t extenLen;
			const uint8_t* extenValue = GetExtensionValue(this->headerExtensionIds.rid, extenLen);

			if (extenValue && extenLen > 0)
			{
				rid.assign(reinterpret_cast<const char*>(extenValue), static_cast<size_t>(extenLen));

				return true;
			}

			extenValue = GetExtensionValue(this->headerExtensionIds.rrid, extenLen);

			if (extenValue && extenLen > 0)
			{
				rid.assign(reinterpret_cast<const char*>(extenValue), static_cast<size_t>(extenLen));

				return true;
			}

			return false;
		}

		bool Packet::ReadAbsSendTime(uint32_t& absSendtime) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.absSendTime == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue = GetExtensionValue(this->headerExtensionIds.absSendTime, extenLen);

			if (!extenValue || extenLen != 3u)
			{
				return false;
			}

			absSendtime = Utils::Byte::Get3Bytes(extenValue, 0);

			return true;
		}

		bool Packet::UpdateAbsSendTime(uint64_t ms) const
		{
			MS_TRACE();

			uint8_t extenLen;
			uint8_t* extenValue = GetExtensionValue(this->headerExtensionIds.absSendTime, extenLen);

			if (!extenValue || extenLen != 3u)
			{
				return false;
			}

			auto absSendTime = Utils::Time::TimeMsToAbsSendTime(ms);

			Utils::Byte::Set3Bytes(extenValue, 0, absSendTime);

			return true;
		}

		bool Packet::ReadTransportWideCc01(uint16_t& wideSeqNumber) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.transportWideCc01 == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue =
			  GetExtensionValue(this->headerExtensionIds.transportWideCc01, extenLen);

			if (!extenValue || extenLen != 2u)
			{
				return false;
			}

			wideSeqNumber = Utils::Byte::Get2Bytes(extenValue, 0);

			return true;
		}

		bool Packet::UpdateTransportWideCc01(uint16_t wideSeqNumber) const
		{
			MS_TRACE();

			uint8_t extenLen;
			uint8_t* extenValue = GetExtensionValue(this->headerExtensionIds.transportWideCc01, extenLen);

			if (!extenValue || extenLen != 2u)
			{
				return false;
			}

			Utils::Byte::Set2Bytes(extenValue, 0, wideSeqNumber);

			return true;
		}

		bool Packet::ReadSsrcAudioLevel(uint8_t& volume, bool& voice) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.ssrcAudioLevel == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue =
			  GetExtensionValue(this->headerExtensionIds.ssrcAudioLevel, extenLen);

			if (!extenValue || extenLen != 1u)
			{
				return false;
			}

			volume = Utils::Byte::Get1Byte(extenValue, 0);
			voice  = (volume & (1 << 7)) != 0;
			volume &= ~(1 << 7);

			return true;
		}

		bool Packet::ReadDependencyDescriptor(
		  std::unique_ptr<Codecs::DependencyDescriptor>& dependencyDescriptor,
		  std::unique_ptr<Codecs::DependencyDescriptor::TemplateDependencyStructure>&
		    templateDependencyStructure) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.dependencyDescriptor == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue =
			  GetExtensionValue(this->headerExtensionIds.dependencyDescriptor, extenLen);

			auto* value = Codecs::DependencyDescriptor::Parse(
			  extenValue, extenLen, const_cast<Packet*>(this), templateDependencyStructure);

			if (!value)
			{
				return false;
			}

			dependencyDescriptor.reset(value);

			return true;
		}

		bool Packet::UpdateDependencyDescriptor(const uint8_t* data, size_t len)
		{
			MS_TRACE();

			uint8_t extenLen;
			uint8_t* extenValue =
			  GetExtensionValue(this->headerExtensionIds.dependencyDescriptor, extenLen);

			if (!extenValue)
			{
				MS_WARN_TAG(rtp, "dependency description not found");

				return false;
			}

			std::memcpy(extenValue, data, len);

			SetExtensionLength(this->headerExtensionIds.dependencyDescriptor, len);

			return true;
		}

		bool Packet::ReadVideoOrientation(bool& camera, bool& flip, uint16_t& rotation) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.videoOrientation == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue =
			  GetExtensionValue(this->headerExtensionIds.videoOrientation, extenLen);

			if (!extenValue || extenLen != 1u)
			{
				return false;
			}

			const uint8_t cvoByte       = Utils::Byte::Get1Byte(extenValue, 0);
			const uint8_t cameraValue   = ((cvoByte & 0b00001000) >> 3);
			const uint8_t flipValue     = ((cvoByte & 0b00000100) >> 2);
			const uint8_t rotationValue = (cvoByte & 0b00000011);

			camera = cameraValue != 0;
			flip   = flipValue != 0;

			// Using counter clockwise values.
			switch (rotationValue)
			{
				case 3:
				{
					rotation = 270;
					break;
				}

				case 2:
				{
					rotation = 180;
					break;
				}

				case 1:
				{
					rotation = 90;
					break;
				}

				default:
				{
					rotation = 0;
				}
			}

			return true;
		}

		bool Packet::ReadAbsCaptureTime(
		  uint64_t& absCaptureTimestamp, int64_t& estimatedCaptureClockOffset) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.absCaptureTime == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue =
			  GetExtensionValue(this->headerExtensionIds.absCaptureTime, extenLen);

			// Extension value can be 8 or 16 bytes depending on whether it contains
			// estimated capture clock offset or not.
			//
			// https://webrtc.googlesource.com/src/+/refs/heads/main/docs/native-code/rtp-hdrext/abs-capture-time
			if (!extenValue || (extenLen != 8u && extenLen != 16u))
			{
				return false;
			}

			absCaptureTimestamp = Utils::Byte::Get8Bytes(extenValue, 0);

			if (extenLen == 16)
			{
				estimatedCaptureClockOffset = static_cast<int64_t>(Utils::Byte::Get8Bytes(extenValue, 8));
			}
			else
			{
				estimatedCaptureClockOffset = 0;
			}

			return true;
		}

		bool Packet::ReadPlayoutDelay(uint16_t& minDelay, uint16_t& maxDelay) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.playoutDelay == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue = GetExtensionValue(this->headerExtensionIds.playoutDelay, extenLen);

			if (extenLen != 3)
			{
				return false;
			}

			const uint32_t v = Utils::Byte::Get3Bytes(extenValue, 0);
			minDelay         = v >> 12u;
			maxDelay         = v & 0xFFFu;

			return true;
		}

		bool Packet::ReadMediasoupPacketId(uint32_t& mediasoupPacketId) const
		{
			MS_TRACE();

			if (this->headerExtensionIds.mediasoupPacketId == 0)
			{
				return false;
			}

			uint8_t extenLen;
			const uint8_t* extenValue =
			  GetExtensionValue(this->headerExtensionIds.mediasoupPacketId, extenLen);

			if (extenLen != 4u)
			{
				return false;
			}

			mediasoupPacketId = Utils::Byte::Get4Bytes(extenValue, 0);

			return true;
		}

		void Packet::SetPayload(const uint8_t* payload, size_t payloadLength)
		{
			MS_TRACE();

			if (!payload && payloadLength > 0)
			{
				MS_THROW_TYPE_ERROR("invalid payloadLength %zu without payload", payloadLength);
			}

			const auto previousLength        = GetLength();
			const auto previousPayloadLength = GetPayloadLength();
			const auto previousPaddingLength = GetPaddingLength();
			const auto newLength =
			  previousLength - previousPayloadLength - previousPaddingLength + payloadLength;

			// Set the new Packet total length.
			// NOTE: This throws if given length is higher than buffer length.
			SetLength(newLength);

			// Unset padding flag.
			GetFixedHeaderPointer()->padding = 0;

			if (payload)
			{
				std::memmove(GetPayloadPointer(), payload, payloadLength);
			}
		}

		void Packet::SetPayloadLength(size_t payloadLength)
		{
			MS_TRACE();

			const auto previousLength        = GetLength();
			const auto previousPayloadLength = GetPayloadLength();
			const auto previousPaddingLength = GetPaddingLength();
			const auto newLength =
			  previousLength - previousPayloadLength - previousPaddingLength + payloadLength;

			// Set the new Packet total length.
			// NOTE: This throws if given length is higher than buffer length.
			SetLength(newLength);

			// Unset padding flag.
			GetFixedHeaderPointer()->padding = 0;
		}

		void Packet::ShiftPayload(size_t payloadOffset, int32_t delta)
		{
			MS_TRACE();

			if (delta == 0)
			{
				return;
			}

			auto* payload            = GetPayloadPointer();
			const auto payloadLength = GetPayloadLength();
			const auto absDelta =
			  delta < 0 ? static_cast<uint32_t>(-(int64_t)delta) : static_cast<uint32_t>(delta);

			if (payloadOffset >= payloadLength)
			{
				MS_THROW_TYPE_ERROR(
				  "payloadOffset (%zu) is bigger than payload length (%zu)", payloadOffset, payloadLength);
			}
			else if (delta < 0 && absDelta > (payloadLength - payloadOffset))
			{
				MS_THROW_TYPE_ERROR("negative delta (%" PRIi32 ") too big", delta);
			}

			// Remove padding (if any).
			if (HasPadding())
			{
				SetPaddingLength(0);
			}

			if (delta > 0)
			{
				// Update Packet length.
				// NOTE: This throws if given length is higher than buffer length.
				SetLength(GetLength() + delta);

				std::memmove(
				  payload + payloadOffset + delta, payload + payloadOffset, payloadLength - payloadOffset);
			}
			else
			{
				// Update Packet length.
				// NOTE: This throws if given length is higher than buffer length.
				SetLength(GetLength() - absDelta);

				std::memmove(
				  payload + payloadOffset,
				  payload + payloadOffset + absDelta,
				  payloadLength - payloadOffset - absDelta);
			}
		}

		void Packet::SetPaddingLength(uint8_t paddingLength)
		{
			MS_TRACE();

			const auto previousLength        = GetLength();
			const auto previousPaddingLength = GetPaddingLength();
			const auto newLength             = previousLength - previousPaddingLength + paddingLength;

			// Set the new Packet total length.
			// NOTE: This throws if given length is higher than buffer length.
			SetLength(newLength);

			if (paddingLength > 0)
			{
				GetFixedHeaderPointer()->padding = 1;

				Utils::Byte::Set1Byte(const_cast<uint8_t*>(GetBuffer()), GetLength() - 1, paddingLength);
			}
			else
			{
				GetFixedHeaderPointer()->padding = 0;
			}
		}

		void Packet::PadTo4Bytes()
		{
			MS_TRACE();

			const auto previousLength        = GetLength();
			const auto previousPaddingLength = GetPaddingLength();
			const auto newNotPaddedLength    = previousLength - previousPaddingLength;
			const auto newPaddedLength       = Utils::Byte::PadTo4Bytes(newNotPaddedLength);

			if (newPaddedLength == previousLength)
			{
				return;
			}

			// Set the new Packet total length.
			// NOTE: This throws if given length is higher than buffer length.
			SetLength(newPaddedLength);

			const auto newPaddingLength = newPaddedLength - newNotPaddedLength;

			if (newPaddingLength > 0)
			{
				GetFixedHeaderPointer()->padding = 1;

				Utils::Byte::Set1Byte(const_cast<uint8_t*>(GetBuffer()), GetLength() - 1, newPaddingLength);
			}
			else
			{
				GetFixedHeaderPointer()->padding = 0;
			}
		}

		void Packet::RtxEncode(uint8_t payloadType, uint32_t ssrc, uint16_t seq)
		{
			MS_TRACE();

			// Remove padding (if any).
			if (HasPadding())
			{
				// NOTE: This must be called before SetLength() method below.
				SetPaddingLength(0);
			}

			// Update Packet length.
			// NOTE: This throws if given length is higher than buffer length.
			SetLength(GetLength() + 2);

			// Rewrite the payload type.
			SetPayloadType(payloadType);

			// Rewrite the SSRC.
			SetSsrc(ssrc);

			auto* payload            = GetPayloadPointer();
			const auto payloadLength = GetPayloadLength();

			// Write the original sequence number at the begining of the payload.
			std::memmove(payload + 2, payload, payloadLength);
			Utils::Byte::Set2Bytes(payload, 0, GetSequenceNumber());

			// Rewrite the sequence number.
			SetSequenceNumber(seq);
		}

		bool Packet::RtxDecode(uint8_t payloadType, uint32_t ssrc)
		{
			MS_TRACE();

			auto* payload            = GetPayloadPointer();
			const auto payloadLength = GetPayloadLength();

			// NOTE: libwebrtc sends some RTX packets with no payload when the stream
			// is started. Just ignore them.
			if (payloadLength < 2)
			{
				return false;
			}

			// Rewrite the payload type.
			SetPayloadType(payloadType);

			// Rewrite the sequence number.
			SetSequenceNumber(Utils::Byte::Get2Bytes(payload, 0));

			// Rewrite the SSRC.
			SetSsrc(ssrc);

			// Shift the payload to its original place.
			std::memmove(payload, payload + 2, payloadLength - 2);

			// Remove padding (if any).
			if (HasPadding())
			{
				// NOTE: This must be called before SetLength() method below.
				SetPaddingLength(0);
			}

			// Update Packet length.
			SetLength(GetLength() - 2);

			return true;
		}

		void Packet::SetPayloadDescriptorHandler(Codecs::PayloadDescriptorHandler* payloadDescriptorHandler)
		{
			MS_TRACE();

			this->payloadDescriptorHandler.reset(payloadDescriptorHandler);
		}

		bool Packet::ProcessPayload(Codecs::EncodingContext* context, bool& marker)
		{
			MS_TRACE();

			if (!this->payloadDescriptorHandler)
			{
				return true;
			}

			return this->payloadDescriptorHandler->Process(context, this, marker);
		}

		std::unique_ptr<Codecs::PayloadDescriptor::Encoder> Packet::GetPayloadEncoder() const
		{
			MS_TRACE();

			if (!this->payloadDescriptorHandler)
			{
				return nullptr;
			}

			return this->payloadDescriptorHandler->GetEncoder();
		}

		void Packet::EncodePayload(Codecs::PayloadDescriptor::Encoder* encoder)
		{
			MS_TRACE();

			if (!this->payloadDescriptorHandler)
			{
				return;
			}

			this->payloadDescriptorHandler->Encode(this, encoder);
		}

		void Packet::RestorePayload()
		{
			MS_TRACE();

			if (!this->payloadDescriptorHandler)
			{
				return;
			}

			this->payloadDescriptorHandler->Restore(this);
		}

		bool Packet::Validate(bool storeExtensions)
		{
			MS_TRACE();

			// Here we are at the beginning of the Packet.
			const auto* ptr = const_cast<uint8_t*>(GetBuffer());

			if (GetVersion() != 2)
			{
				MS_WARN_TAG(rtp, "invalid Packet, version must be 2");

				return false;
			}

			ptr += Packet::FixedHeaderMinLength;

			// Here we are at the beginning of the optional CCRS list.
			if (HasCsrcs())
			{
				auto csrcsLength = GetCsrcCount();

				if (GetLength() < static_cast<size_t>(ptr - GetBuffer()) + csrcsLength)
				{
					MS_WARN_TAG(rtp, "invalid Packet, not enough space for the announced CSRC list");

					return false;
				}

				ptr += csrcsLength;
			}

			// Here we are at the beginning of the optional Header Extension.
			if (HasHeaderExtension())
			{
				// The Header Extension is at least 4 bytes.
				if (GetLength() < static_cast<size_t>(ptr - GetBuffer()) + 4)
				{
					MS_WARN_TAG(rtp, "invalid Packet, not enough space for the announced Header Extension");

					return false;
				}

				const auto headerExtensionLength = GetHeaderExtensionLength();

				if (GetLength() < static_cast<size_t>(ptr - GetBuffer()) + headerExtensionLength)
				{
					MS_WARN_TAG(
					  rtp, "invalid Packet, not enough space for the announced Header Extension value");

					return false;
				}

				if (!ParseExtensions(storeExtensions))
				{
					MS_WARN_TAG(rtp, "invalid Packet, invalid Extensions");

					return false;
				}

				ptr += headerExtensionLength;
			}

			// Here we are at the beginning of the optional payload.
			const auto payloadLength = GetPayloadLength();
			const auto paddingLength = GetPaddingLength();
			const auto availablePayloadAndPaddingLength = GetLength() - (GetPayloadPointer() - GetBuffer());

			if (payloadLength + paddingLength != availablePayloadAndPaddingLength)
			{
				MS_WARN_TAG(rtp, "invalid Packet, not enough space for announced padding");

				return false;
			}

			if (HasPadding() && paddingLength == 0)
			{
				MS_WARN_TAG(rtp, "invalid Packet, padding byte cannot be 0");

				return false;
			}

			ptr += availablePayloadAndPaddingLength;

			// Here we are at the end of the Packet.
			MS_ASSERT(
			  static_cast<size_t>(ptr - GetBuffer()) == GetLength(),
			  "Packet computed length does not match its assigned length");

			return true;
		}

		bool Packet::ParseExtensions(bool storeExtensions)
		{
			MS_TRACE();

			if (HasOneByteExtensions())
			{
				const uint8_t* extensionsStart = GetHeaderExtensionValue();
				const uint8_t* extensionsEnd   = extensionsStart + GetHeaderExtensionValueLength();
				auto* ptr                      = const_cast<uint8_t*>(extensionsStart);

				// One-Byte Extensions cannot have length 0.
				while (ptr < extensionsEnd)
				{
					const auto* extension = reinterpret_cast<OneByteExtension*>(ptr);
					const uint8_t id      = extension->id;
					// NOTE: In One-Byte Extensions, announced value must be incremented
					// by 1.
					const size_t len = extension->len + 1;

					// id=0 means alignment.
					if (id == 0)
					{
						++ptr;
					}
					// id=15 in One-Byte extensions means "stop parsing here".
					else if (id == 15)
					{
						break;
					}
					// Valid Extension id.
					else
					{
						if (ptr + 1 + len > extensionsEnd)
						{
							MS_WARN_TAG(
							  rtp,
							  "not enough space for the announced value of the One-Byte Extension with id %" PRIu8,
							  id);

							return false;
						}

						if (storeExtensions)
						{
							// Store the One-Byte Extension offset in the array.
							// `-1` because we have 14 elements total 0..13 and `id` is in the
							// range 1..14.
							this->oneByteExtensions[id - 1] = ptr - extensionsStart;
						}

						ptr += (1 + len);
					}

					// Counting padding bytes.
					while (ptr < extensionsEnd && *ptr == 0)
					{
						++ptr;
					}
				}

				return true;
			}
			else if (HasTwoBytesExtensions())
			{
				const uint8_t* extensionsStart = GetHeaderExtensionValue();
				const uint8_t* extensionsEnd   = extensionsStart + GetHeaderExtensionValueLength();
				// ptr points to the Extension id field (1 byte).
				// ptr+1 points to the length field (1 byte, can have value 0).
				auto* ptr = const_cast<uint8_t*>(extensionsStart);

				// Two-Byte Extensions can have length 0.
				while (ptr + 1 < extensionsEnd)
				{
					const auto* extension = reinterpret_cast<TwoBytesExtension*>(ptr);
					const uint8_t id      = extension->id;
					const size_t len      = extension->len;

					// id=0 means alignment.
					if (id == 0)
					{
						++ptr;
					}
					// Valid Extension id.
					else
					{
						if (ptr + 2 + len > extensionsEnd)
						{
							MS_WARN_TAG(
							  rtp,
							  "not enough space for the announced value of the Two-Bytes Extension with id %" PRIu8,
							  id);

							return false;
						}

						if (storeExtensions)
						{
							// Store the Two-Bytes Extension offset in the map.
							this->twoBytesExtensions[id] = ptr - extensionsStart;
						}

						ptr += (2 + len);
					}

					// Counting padding bytes.
					while (ptr < extensionsEnd && *ptr == 0)
					{
						++ptr;
					}
				}

				return true;
			}
			// If there is no Header Extension of if there is but it doesn't conform
			// to RFC 8285 Extensions, then this is ok.
			else
			{
				return true;
			}
		}

		void Packet::SetExtensionLength(uint8_t id, uint8_t len)
		{
			MS_TRACE();

			MS_ASSERT(id > 0, "id cannot be 0");

			if (HasOneByteExtensions())
			{
				// `-1` because we have 14 elements total 0..13 and `id` is in the
				// range 1..14.
				const auto offset = this->oneByteExtensions[id - 1];

				MS_ASSERT(offset != -1, "extension with id %" PRIu8 " not found", id);

				auto* extension = reinterpret_cast<OneByteExtension*>(GetHeaderExtensionValue() + offset);

				// In One-Byte Extensions value length 0 means 1.
				const auto currentLen = extension->len + 1;

				// Fill with 0's if new length is minor.
				if (len < currentLen)
				{
					std::memset(extension->value + len, 0, currentLen - len);
				}

				extension->len = len - 1;
			}
			else if (HasTwoBytesExtensions())
			{
				const auto it = this->twoBytesExtensions.find(id);

				MS_ASSERT(it != this->twoBytesExtensions.end(), "extension with id %" PRIu8 " not found", id);

				const auto offset = it->second;

				auto* extension = reinterpret_cast<TwoBytesExtension*>(GetHeaderExtensionValue() + offset);

				const auto currentLen = extension->len;

				// Fill with 0's if new length is minor.
				if (len < currentLen)
				{
					std::memset(extension->value + len, 0, currentLen - len);
				}

				extension->len = len;
			}
		}

		void Packet::OnDependencyDescriptorUpdated(const uint8_t* data, size_t len)
		{
			MS_TRACE();

			UpdateDependencyDescriptor(data, len);
		}
	} // namespace RTP
} // namespace RTC