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

src/Rtsp/RtspMediaSource.h

@@ -28,6 +28,12 @@ namespace mediakit {
  * rtsp有关键的两要素，分别是sdp、rtp包
  * 只要生成了这两要素，那么要实现rtsp推流、rtsp服务器就很简单了
  * rtsp推拉流协议中，先传递sdp，然后再协商传输方式(tcp/udp/组播)，最后一直传递rtp
+ * Data abstraction of rtsp media source
+ * Rtsp has two key elements, sdp and rtp packets
+ * As long as these two elements are generated, it is very simple to implement rtsp push stream and rtsp server
+ * In the rtsp push and pull stream protocol, sdp is transmitted first, then the transmission method (tcp/udp/multicast) is negotiated, and finally rtp is continuously transmitted
+ 
+ * [AUTO-TRANSLATED:e04eee56]
  */
 class RtspMediaSource : public MediaSource, public toolkit::RingDelegate<RtpPacket::Ptr>, private PacketCache<RtpPacket> {
 public:
@@ -41,6 +47,13 @@ public:
      * @param app 应用名
      * @param stream_id 流id
      * @param ring_size 可以设置固定的环形缓冲大小，0则自适应
+     * Constructor
+     * @param vhost Virtual host name
+     * @param app Application name
+     * @param stream_id Stream id
+     * @param ring_size You can set a fixed ring buffer size, 0 is adaptive
+     
+     * [AUTO-TRANSLATED:5dd23423]
      */
     RtspMediaSource(const MediaTuple& tuple, int ring_size = RTP_GOP_SIZE): MediaSource(RTSP_SCHEMA, tuple), _ring_size(ring_size) {}
 
@@ -54,6 +67,9 @@ public:
 
     /**
      * 获取媒体源的环形缓冲
+     * Get the ring buffer of the media source
+     
+     * [AUTO-TRANSLATED:91a762bc]
      */
     const RingType::Ptr &getRing() const {
         return _ring;
@@ -73,6 +89,9 @@ public:
 
     /**
      * 获取播放器个数
+     * Get the number of players
+     
+     * [AUTO-TRANSLATED:a451c846]
      */
     int readerCount() override {
         return _ring ? _ring->readerCount() : 0;
@@ -80,6 +99,9 @@ public:
 
     /**
      * 获取该源的sdp
+     * Get the sdp of this source
+     
+     * [AUTO-TRANSLATED:ebc43430]
      */
     const std::string &getSdp() const {
         return _sdp;
@@ -91,6 +113,9 @@ public:
 
     /**
      * 获取相应轨道的ssrc
+     * Get the ssrc of the corresponding track
+     
+     * [AUTO-TRANSLATED:d26d7f76]
      */
     virtual uint32_t getSsrc(TrackType trackType) {
         assert(trackType >= 0 && trackType < TrackMax);
@@ -103,6 +128,9 @@ public:
 
     /**
      * 获取相应轨道的seqence
+     * Get the sequence of the corresponding track
+     
+     * [AUTO-TRANSLATED:24b0ee74]
      */
     virtual uint16_t getSeqence(TrackType trackType) {
         assert(trackType >= 0 && trackType < TrackMax);
@@ -115,16 +143,25 @@ public:
 
     /**
      * 获取相应轨道的时间戳，单位毫秒
+     * Get the timestamp of the corresponding track, in milliseconds
+     
+     * [AUTO-TRANSLATED:564a0794]
      */
     uint32_t getTimeStamp(TrackType trackType) override;
 
     /**
      * 更新时间戳
+     * Update timestamp
+     
+     * [AUTO-TRANSLATED:8defe253]
      */
     void setTimeStamp(uint32_t stamp) override;
 
     /**
      * 设置sdp
+     * Set sdp
+     
+     * [AUTO-TRANSLATED:76a533c4]
      */
     virtual void setSdp(const std::string &sdp);
 
@@ -132,6 +169,11 @@ public:
      * 输入rtp
      * @param rtp rtp包
      * @param keyPos 该包是否为关键帧的第一个包
+     * Input rtp
+     * @param rtp rtp packet
+     * @param keyPos Whether this packet is the first packet of a key frame
+     
+     * [AUTO-TRANSLATED:fe55afe8]
      */
     void onWrite(RtpPacket::Ptr rtp, bool keyPos) override;
 
@@ -145,9 +187,15 @@ private:
      * 批量flush rtp包时触发该函数
      * @param rtp_list rtp包列表
      * @param key_pos 是否包含关键帧
+     * Trigger this function when flushing rtp packets in batches
+     * @param rtp_list rtp packet list
+     * @param key_pos Whether it contains a key frame
+     
+     * [AUTO-TRANSLATED:612c574b]
      */
     void onFlush(std::shared_ptr<toolkit::List<RtpPacket::Ptr> > rtp_list, bool key_pos) override {
-        //如果不存在视频，那么就没有存在GOP缓存的意义，所以is_key一直为true确保一直清空GOP缓存
+        // 如果不存在视频，那么就没有存在GOP缓存的意义，所以is_key一直为true确保一直清空GOP缓存  [AUTO-TRANSLATED:5818a8d8]
+        // If there is no video, then there is no point in having a GOP cache, so is_key is always true to ensure that the GOP cache is always cleared
         _ring->write(std::move(rtp_list), _have_video ? key_pos : true);
     }