feat: add WebRTC publisher Pacer to improve playback quality

Author: getroot

src/projects/config/items/virtual_hosts/applications/publishers/webrtc_publisher.h

@@ -36,6 +36,30 @@ namespace cfg
 					}
 				};
 
+				struct Pacer : public Item
+				{
+				protected:
+					bool _enable = false;
+					int _min_ms	 = 20;
+					int _max_ms	 = 500;
+
+				public:
+					CFG_DECLARE_CONST_REF_GETTER_OF(IsEnabled, _enable)
+					CFG_DECLARE_CONST_REF_GETTER_OF(GetMinMs, _min_ms)
+					CFG_DECLARE_CONST_REF_GETTER_OF(GetMaxMs, _max_ms)
+
+					// Used by deprecated <JitterBuffer>true</JitterBuffer> migration.
+					void SetEnable(bool enable) { _enable = enable; }
+
+				protected:
+					void MakeList() override
+					{
+						Register<Optional>("Enable", &_enable);
+						Register<Optional>("Min", &_min_ms);
+						Register<Optional>("Max", &_max_ms);
+					}
+				};
+
 				struct WebrtcPublisher : public Publisher
 				{
 					PublisherType GetType() const override
@@ -46,7 +70,7 @@ namespace cfg
 					CFG_DECLARE_CONST_REF_GETTER_OF(GetTimeout, _timeout)
 					CFG_DECLARE_CONST_REF_GETTER_OF(IsRtxEnabled, _rtx)
 					CFG_DECLARE_CONST_REF_GETTER_OF(IsUlpfecEnalbed, _ulpfec)
-					CFG_DECLARE_CONST_REF_GETTER_OF(IsJitterBufferEnabled, _jitter_buffer)
+					CFG_DECLARE_CONST_REF_GETTER_OF(GetPacer, _pacer)
 					CFG_DECLARE_CONST_REF_GETTER_OF(GetPlayoutDelay, _playout_delay)
 					CFG_DECLARE_CONST_REF_GETTER_OF(GetBandwidthEstimationType, _bandwidth_estimation_type)
 					CFG_DECLARE_CONST_REF_GETTER_OF(ShouldCreateDefaultPlaylist, _create_default_playlist)
@@ -57,10 +81,23 @@ namespace cfg
 						Publisher::MakeList();
 
 						Register<Optional>("Timeout", &_timeout);
-						Register<Optional>("JitterBuffer", &_jitter_buffer);
 						Register<Optional>("Rtx", &_rtx);
 						Register<Optional>("Ulpfec", &_ulpfec);
 						Register<Optional>("PlayoutDelay", &_playout_delay);
+						Register<Optional>("Pacer", &_pacer);
+						// Deprecated: replaced by <Pacer>. Accepted as a boolean for
+						// backward compatibility — when set to true, Pacer is enabled
+						// with default Min/Max values and a deprecation warning is logged.
+						Register<Optional>("JitterBuffer", &_deprecated_jitter_buffer,
+										   nullptr,
+										   [=]() -> std::shared_ptr<ConfigError> {
+											   logw("Config", "<JitterBuffer> is deprecated. Please use <Pacer> instead.");
+											   if (_deprecated_jitter_buffer)
+											   {
+												   _pacer.SetEnable(true);
+											   }
+											   return nullptr;
+										   });
 						Register<Optional>("CreateDefaultPlaylist", &_create_default_playlist);
 						Register<Optional>("BandwidthEstimation", &_bwe, [=]() -> std::shared_ptr<ConfigError> { return nullptr; }, [=]() -> std::shared_ptr<ConfigError> {
 								if (_bwe.UpperCaseString() == "REMB")
@@ -83,15 +120,16 @@ namespace cfg
 								return nullptr; });
 					}
 
-					int _timeout		= 30000;
-					bool _rtx			= false;
-					bool _ulpfec		= false;
-					bool _jitter_buffer = false;
+					int _timeout = 30000;
+					bool _rtx	 = false;
+					bool _ulpfec = false;
 					ov::String _bwe;
 
 					RtcBWEType _bandwidth_estimation_type = RtcBWEType::All;
 					PlayoutDelay _playout_delay;
-					bool _create_default_playlist = true;
+					Pacer _pacer;
+					bool _deprecated_jitter_buffer = false;
+					bool _create_default_playlist  = true;
 				};
 			}  // namespace pub
 		}  // namespace app

src/projects/modules/CMakeLists.txt

@@ -14,7 +14,7 @@ add_subdirectory(containers)
 add_subdirectory(origin_map_client)
 add_subdirectory(cpix_client)
 add_subdirectory(transcode_webhook)
-add_subdirectory(jitter_buffer)
+add_subdirectory(pacer)
 add_subdirectory(rtsp)
 add_subdirectory(sdp)
 add_subdirectory(rtp_rtcp)

src/projects/modules/jitter_buffer/CMakeLists.txt

@@ -0,0 +1 @@
+ome_add_static_library(pacer)