Mirror/ZLMediaKit
1
0
Fork 0
mirror of https://github.com/ZLMediaKit/ZLMediaKit.git synced 2026-07-04 01:37:33 +08:00
Code Issues Packages Projects Releases Wiki Activity

AI automatically translates all comments in the code into English (#3917)

Browse Source
This commit is contained in:
alex
2024-09-19 14:53:50 +08:00
committed by GitHub
parent 046de691cb
commit 4152dcd409
279 changed files with 10602 additions and 3038 deletions
Download Patch File Download Diff File Expand all files Collapse all files

103
src/Rtsp/RtpReceiver.h
View File

@@ -34,6 +34,9 @@ public:
/**
* 清空状态
* Clear the state
* [AUTO-TRANSLATED:6aadbd77]
*/
void clear() {
_started = false;
@@ -43,6 +46,9 @@ public:
/**
* 获取排序缓存长度
* Get the length of the sorting cache
* [AUTO-TRANSLATED:8e05a703]
*/
size_t getJitterSize() const { return _pkt_sort_cache_map.size(); }
@@ -50,31 +56,42 @@ public:
* 输入并排序
* @param seq 序列号
* @param packet 包负载
* Input and sort
* @param seq Sequence number
* @param packet Packet payload
* [AUTO-TRANSLATED:0fbf096e]
*/
void sortPacket(SEQ seq, T packet) {
_latest_seq = seq;
if (!_started) {
// 记录第一个seq
// 记录第一个seq [AUTO-TRANSLATED:410c831f]
// Record the first seq
_started = true;
_last_seq_out = seq - 1;
}
auto next_seq = static_cast<SEQ>(_last_seq_out + 1);
if (seq == next_seq) {
// 收到下一个seq
// 收到下一个seq [AUTO-TRANSLATED:44960fea]
// Receive the next seq
output(seq, std::move(packet));
// 清空连续包列表
// 清空连续包列表 [AUTO-TRANSLATED:fdaafd3b]
// Clear the continuous packet list
flushPacket();
_pkt_drop_cache_map.clear();
return;
}
if (seq < next_seq && !mayLooped(next_seq, seq)) {
// 无回环风险, 缓存seq回退包
// 无回环风险, 缓存seq回退包 [AUTO-TRANSLATED:4200dd1b]
// No loop risk, cache seq rollback packets
_pkt_drop_cache_map.emplace(seq, std::move(packet));
if (_pkt_drop_cache_map.size() > _max_distance || _ticker.elapsedTime() > _max_buffer_ms) {
// seq回退包太多，可能源端重置seq计数器，这部分数据需要输出
// seq回退包太多，可能源端重置seq计数器，这部分数据需要输出 [AUTO-TRANSLATED:d31aead7]
// Too many seq rollback packets, the source may reset the seq counter, this part of data needs to be output
forceFlush(next_seq);
// 旧的seq计数器的数据清空后把新seq计数器的数据赋值给排序列队
// 旧的seq计数器的数据清空后把新seq计数器的数据赋值给排序列队 [AUTO-TRANSLATED:f69f864c]
// After clearing the data of the old seq counter, assign the data of the new seq counter to the sorting queue
_pkt_sort_cache_map = std::move(_pkt_drop_cache_map);
popIterator(_pkt_sort_cache_map.begin());
}
@@ -123,17 +140,22 @@ private:
if (_pkt_sort_cache_map.empty()) {
return;
}
// 寻找距离比next_seq大的最近的seq
// 寻找距离比next_seq大的最近的seq [AUTO-TRANSLATED:d2de6f5b]
// Find the nearest seq that is greater than next_seq
auto it = _pkt_sort_cache_map.lower_bound(next_seq);
if (it == _pkt_sort_cache_map.end()) {
// 没有比next_seq更大的seq，应该是回环时丢包导致
// 没有比next_seq更大的seq，应该是回环时丢包导致 [AUTO-TRANSLATED:d0d6970b]
// There is no seq greater than next_seq, it should be caused by packet loss during loopback
it = _pkt_sort_cache_map.begin();
}
// 丢包无法恢复，把这个包当做next_seq
// 丢包无法恢复，把这个包当做next_seq [AUTO-TRANSLATED:2d8c0b9e]
// Packet loss cannot be recovered, treat this packet as next_seq
popIterator(it);
// 清空连续包列表
// 清空连续包列表 [AUTO-TRANSLATED:fdaafd3b]
// Clear the continuous packet list
flushPacket();
// 删除距离next_seq太大的包
// 删除距离next_seq太大的包 [AUTO-TRANSLATED:9e774c5e]
// Delete packets that are too far away from next_seq
for (auto it = _pkt_sort_cache_map.begin(); it != _pkt_sort_cache_map.end();) {
if (distance(it->first) > _max_distance) {
it = _pkt_sort_cache_map.erase(it);
@@ -152,12 +174,14 @@ private:
auto next_seq = static_cast<SEQ>(_last_seq_out + 1);
auto it = _pkt_sort_cache_map.lower_bound(next_seq);
if (!mayLooped(next_seq, next_seq)) {
// 无回环风险, 清空 < next_seq的值
// 无回环风险, 清空 < next_seq的值 [AUTO-TRANSLATED:10c77bf9]
// No loop risk, clear values less than next_seq
it = _pkt_sort_cache_map.erase(_pkt_sort_cache_map.begin(), it);
}
while (it != _pkt_sort_cache_map.end()) {
// 找到下一个包
// 找到下一个包 [AUTO-TRANSLATED:8e20ab9f]
// Find the next packet
if (it->first == static_cast<SEQ>(_last_seq_out + 1)) {
it = popIterator(it);
continue;
@@ -186,23 +210,32 @@ private:
private:
bool _started = false;
// 排序缓存最大保存数据长度，单位毫秒
// 排序缓存最大保存数据长度，单位毫秒 [AUTO-TRANSLATED:ed217b1c]
// Maximum data length of sorting cache, unit: milliseconds
size_t _max_buffer_ms = 1000;
// 排序缓存最大保存数据个数
// 排序缓存最大保存数据个数 [AUTO-TRANSLATED:9cfa91b4]
// Maximum number of data in sorting cache
size_t _max_buffer_size = 1024;
// seq最大跳跃距离
// seq最大跳跃距离 [AUTO-TRANSLATED:bb663e41]
// Maximum seq jump distance
size_t _max_distance = 256;
// 记录上次output至今的时间
// 记录上次output至今的时间 [AUTO-TRANSLATED:83e53e42]
// Record the time since the last output
toolkit::Ticker _ticker;
// 最近输入的seq
// 最近输入的seq [AUTO-TRANSLATED:24ca96ee]
// The most recently input seq
SEQ _latest_seq = 0;
// 下次应该输出的SEQ
// 下次应该输出的SEQ [AUTO-TRANSLATED:e757a4fa]
// The next SEQ to be output
SEQ _last_seq_out = 0;
// pkt排序缓存，根据seq排序
// pkt排序缓存，根据seq排序 [AUTO-TRANSLATED:3787f9a6]
// pkt sorting cache, sorted by seq
std::map<SEQ, T> _pkt_sort_cache_map;
// 预丢弃包列表
// 预丢弃包列表 [AUTO-TRANSLATED:67e57ebc]
// Pre-discard packet list
std::map<SEQ, T> _pkt_drop_cache_map;
// 回调
// 回调 [AUTO-TRANSLATED:03bad27d]
// Callback
std::function<void(SEQ seq, T packet)> _cb;
};
@@ -277,6 +310,15 @@ public:
* @param ptr rtp数据指针
* @param len rtp数据指针长度
* @return 解析成功返回true
* Generate and sort rtp packets from input data pointer
* @param index Track index
* @param type Track type
* @param samplerate RTP timestamp base clock, 90000 for video, sample rate for audio
* @param ptr RTP data pointer
* @param len RTP data pointer length
* @return Return true if parsing is successful
* [AUTO-TRANSLATED:4ec12e4a]
*/
bool handleOneRtp(int index, TrackType type, int sample_rate, uint8_t *ptr, size_t len) {
assert(index < kCount && index >= 0);
@@ -289,6 +331,13 @@ public:
* @param index track下标索引
* @param rtp_stamp rtp时间戳
* @param ntp_stamp_ms ntp时间戳
* Set ntp timestamp, set when receiving rtcp sender report
* If rtp_stamp/sample_rate/ntp_stamp_ms are all 0, then use rtp timestamp as ntp timestamp
* @param index Track index
* @param rtp_stamp RTP timestamp
* @param ntp_stamp_ms NTP timestamp
* [AUTO-TRANSLATED:1e50904e]
*/
void setNtpStamp(int index, uint32_t rtp_stamp, uint64_t ntp_stamp_ms) {
assert(index < kCount && index >= 0);
@@ -321,6 +370,11 @@ protected:
* rtp数据包排序后输出
* @param rtp rtp数据包
* @param track_index track索引
* Output rtp data packets after sorting
* @param rtp RTP data packet
* @param track_index Track index
* [AUTO-TRANSLATED:55022da9]
*/
virtual void onRtpSorted(RtpPacket::Ptr rtp, int index) {}
@@ -328,6 +382,11 @@ protected:
* 解析出rtp但还未排序
* @param rtp rtp数据包
* @param track_index track索引
* RTP data packet parsed but not yet sorted
* @param rtp RTP data packet
* @param track_index Track index
* [AUTO-TRANSLATED:c1636911]
*/
virtual void onBeforeRtpSorted(const RtpPacket::Ptr &rtp, int index) {}