agora-python-server-sdk 2.3.4__tar.gz → 2.4.1__tar.gz

{agora_python_server_sdk-2.3.4 → agora_python_server_sdk-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agora_python_server_sdk
-Version: 2.3.4
+Version: 2.4.1
 Summary: A Python SDK for Agora Server
 Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
 Classifier: Intended Audience :: Developers
@@ -38,7 +38,7 @@ Description-Content-Type: text/markdown
 # Required Operating Systems and Python Versions
 - Supported Linux versions:
   - Ubuntu 18.04 LTS and above
-  - CentOS 7.0 and above
+  - CentOS 8.0 and above
   
 - Supported Mac versions:
   - MacOS 13 and above(only for coding and testing)
@@ -57,21 +57,55 @@ pip install agora_python_server_sdk
 - Download and unzip [test_data.zip](https://download.agora.io/demo/test/test_data_202408221437.zip) to the Agora-Python-Server-SDK directory.
 
 ## Executing Test Script
-or linux os, should set env to ：/site_packages/agora/agora_sdk/, like:
+for linux os, should set env to ：/site_packages/agora/agora_sdk/, like:
 export LD_LIBRARY_PATH=/site_packages/agora/agora_sdk/
 ```
 python agora_rtc/examples/example_audio_pcm_send.py --appId=xxx --channelId=xxx --userId=xxx --audioFile=./test_data/demo.pcm --sampleRate=16000 --numOfChannels=1
 ```
 
 # Change log
+## 2025.12.17 Release 2.4.1
+
+- Updated RTC SDK to version 154.
+- Added support for VAD (Voice Activity Detection) for external audio sources, including:
+  - **Background voice removal**
+  - **Noise suppression**
+  - **Echo cancellation**
+  - **Automatic gain control**
+  - **Other 3A algorithms**  
+  All supported via the `external_Audio_Processor`.
+- Modified LocalUser return values for clearer SDK error code distinction.
+- Added `example_external_Audio_Processor.py` to demonstrate external audio data processing.
+
+---
+
+## 2025.11.18 Release 2.4.0
+
+- Updated SDK to APM version: `4.4.32/1025`
+- Added configuration support to enable/disable APM.
+- Updated methods in `setup.py` and `__init__.py`, including version/URL and MD5 processing.
+- Completed main code pipeline (**further testing recommended**).
+- Added RTM support: one SDK now supports both RTC and RTM.
+
+**To-Do Items:**
+- [x] Add VAD algorithm update
+- [x] Add vad_dump modifications
+- [x] Add APM algorithm VAD switch support
+- [x] Add VAD configuration parameter setting
+- [x] Download and check for MD5 mismatch on every download
+
+**Notes:**
+- **APM features** include server-side echo cancellation, noise suppression, automatic gain control, background voice removal, and more.
+- Typically, AEC/AINS/AGC, etc., are handled on the client; server-side activation is only necessary for specific requirements.
+- If you need to enable APM, please contact Agora technical support.
+
+**Usage Examples:**  
+- [RTC usage example](https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK/tree/main/agora_rtc/examples)  
+- [RTM usage example](https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK/tree/main/agora_rtc/rtm_examples)
 # 2025.11.07 release 2.3.3
 -- update: to support rtm
 -- adjust sdk's directory structure
 -- change requests to urllib
-# 2025.10.23 release 2.3.2: support rtc and rtm in one package
--- update: to support rtm.can support both rtc and rtm in one package.
--- adjust sdk's directory structure
--- update rtc sdk
 # 2025.10.09  release 2.3.1
 -- update arm64 rtc sdk:Fixed a JNI referencing issue in the previous arm64 build. This issue only outputs logs to the console and does not affect functionality.
 

{agora_python_server_sdk-2.3.4 → agora_python_server_sdk-2.4.1}/README.md

@@ -23,7 +23,7 @@
 # Required Operating Systems and Python Versions
 - Supported Linux versions:
   - Ubuntu 18.04 LTS and above
-  - CentOS 7.0 and above
+  - CentOS 8.0 and above
   
 - Supported Mac versions:
   - MacOS 13 and above(only for coding and testing)
@@ -42,21 +42,55 @@ pip install agora_python_server_sdk
 - Download and unzip [test_data.zip](https://download.agora.io/demo/test/test_data_202408221437.zip) to the Agora-Python-Server-SDK directory.
 
 ## Executing Test Script
-or linux os, should set env to ：/site_packages/agora/agora_sdk/, like:
+for linux os, should set env to ：/site_packages/agora/agora_sdk/, like:
 export LD_LIBRARY_PATH=/site_packages/agora/agora_sdk/
 ```
 python agora_rtc/examples/example_audio_pcm_send.py --appId=xxx --channelId=xxx --userId=xxx --audioFile=./test_data/demo.pcm --sampleRate=16000 --numOfChannels=1
 ```
 
 # Change log
+## 2025.12.17 Release 2.4.1
+
+- Updated RTC SDK to version 154.
+- Added support for VAD (Voice Activity Detection) for external audio sources, including:
+  - **Background voice removal**
+  - **Noise suppression**
+  - **Echo cancellation**
+  - **Automatic gain control**
+  - **Other 3A algorithms**  
+  All supported via the `external_Audio_Processor`.
+- Modified LocalUser return values for clearer SDK error code distinction.
+- Added `example_external_Audio_Processor.py` to demonstrate external audio data processing.
+
+---
+
+## 2025.11.18 Release 2.4.0
+
+- Updated SDK to APM version: `4.4.32/1025`
+- Added configuration support to enable/disable APM.
+- Updated methods in `setup.py` and `__init__.py`, including version/URL and MD5 processing.
+- Completed main code pipeline (**further testing recommended**).
+- Added RTM support: one SDK now supports both RTC and RTM.
+
+**To-Do Items:**
+- [x] Add VAD algorithm update
+- [x] Add vad_dump modifications
+- [x] Add APM algorithm VAD switch support
+- [x] Add VAD configuration parameter setting
+- [x] Download and check for MD5 mismatch on every download
+
+**Notes:**
+- **APM features** include server-side echo cancellation, noise suppression, automatic gain control, background voice removal, and more.
+- Typically, AEC/AINS/AGC, etc., are handled on the client; server-side activation is only necessary for specific requirements.
+- If you need to enable APM, please contact Agora technical support.
+
+**Usage Examples:**  
+- [RTC usage example](https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK/tree/main/agora_rtc/examples)  
+- [RTM usage example](https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK/tree/main/agora_rtc/rtm_examples)
 # 2025.11.07 release 2.3.3
 -- update: to support rtm
 -- adjust sdk's directory structure
 -- change requests to urllib
-# 2025.10.23 release 2.3.2: support rtc and rtm in one package
--- update: to support rtm.can support both rtc and rtm in one package.
--- adjust sdk's directory structure
--- update rtc sdk
 # 2025.10.09  release 2.3.1
 -- update arm64 rtc sdk:Fixed a JNI referencing issue in the previous arm64 build. This issue only outputs logs to the console and does not affect functionality.
 

{agora_python_server_sdk-2.3.4 → agora_python_server_sdk-2.4.1}/agora/__init__.py

@@ -95,7 +95,16 @@ def report_progress(blocknum, blocksize, totalsize):
         downloaded = blocknum * blocksize
         print(f"\rDownloading: ----{downloaded} bytes-----", end='', flush=True)
 
-
+def _get_url_from_version_file(path: str):
+    if not os.path.exists(path):
+        return ""
+    try:
+        with open(path, 'r') as f:
+            lines = f.readline()
+            return lines
+    except Exception as e:
+        logger.error(f"Failed to read version file: {e}")
+        return ""
 def _check_download_and_extract_sdk():
     agora_service_path = os.path.dirname(os.path.abspath(__file__))
     # change from dir like: /home/xxx/agora_rtc/agora/rtc/agora_sdk to
@@ -122,11 +131,28 @@ def _check_download_and_extract_sdk():
     #fusion version: 20251023
 
     url = "https://download.agora.io/sdk/release/agora_rtc_sdk-x86_64-linux-gnu-v4.4.32-20250829_160340-860733-aed_20251107_1642.zip"
+    #20251110 Fusion version: with apm filter
+    mac_sdk="https://download.agora.io/sdk/release/agora_sdk_mac_v4.4.30_25869_FULL_20251030_1836_953684-aed.zip"
+    linux_sdk = "https://download.agora.io/sdk/release/agora_rtc_sdk_x86_64-linux-gnu-v4.4.32.150_26715_SERVER_20251030_1807-aed.zip"
+
+    linux_sdk = "https://download.agora.io/sdk/release/agora_rtc_sdk_x86_64-linux-gnu-Agora_Native_SDK_for_Linux_x64_zhourui_26895_SERVER_20251121_1628_987405_20251021_1427-3a.zip"
+    mac_sdk="https://download.agora.io/sdk/release/agora_sdk_mac_Agora_Native_SDK_for_Mac_zhourui_26101_FULL_20251121_2135_987705_20251021_1427-3a.zip"
+
+    linux_sdk="https://download.agora.io/sdk/release/agora_rtc_sdk_x86_64-linux-gnu-v4.4.32.154_26982_SERVER_20251210_1745_994155_20251021_1427-3a.zip"
+    mac_sdk="https://download.agora.io/sdk/release/agora_sdk_mac_v4.4.32.154_26308_FULL_20251210_1756_994156_20251021_1427-3a.zip"
+
 
+    
           
-    rtc_libfile_path = os.path.join(sdk_library_dir, "libagora_rtc_sdk.so")
+    linux_libfile_path = os.path.join(sdk_library_dir, "libagora_rtc_sdk.so")
+    mac_libfile_path = os.path.join(sdk_library_dir, "libAgoraRtcKit.dylib")
+    linux_md5 = "e89043f0db667c207d9308d3515a67ed"
+    mac_md5 = "f63e8af2047a53643a1ceb0a4b24b802"
+
     #rtc_md5 = "7031dd10d1681cd88fd89d68c5b54282"
-    rtc_md5 = "7eb8042e43246f95f188549d8711d1bf"
+    url = linux_sdk
+    rtc_md5 = linux_md5
+    rtc_libfile_path = linux_libfile_path
     if sys.platform == 'darwin':
         #url = "https://download.agora.io/sdk/release/agora_rtc_sdk_mac_rel.v4.4.30_22472_FULL_20241024_1224_398653.zip"
         # version   2.2.0 for mac
@@ -134,13 +160,12 @@ def _check_download_and_extract_sdk():
         #url = "https://download.agora.io/sdk/release/agora_sdk_mac_v4.4.32_24915_FULL_20250715_1710_791284.zip"
         #url = "https://download.agora.io/sdk/release/agora_sdk_mac_v4.4.32_25418_FULL_20250829_1647_860754.zip"
         #20251023 Fusion version: one sdk package include rtc and rtm
-        url = "https://download.agora.io/sdk/release/agora_sdk_mac_v4.4.32_25418_FULL_20250829_1647_860754-aed_20251107_1639.zip"
-
-        
+        #url = "https://download.agora.io/sdk/release/agora_sdk_mac_v4.4.32_25418_FULL_20250829_1647_860754-aed_20251107_1639.zip"
+        url = mac_sdk
 
-        rtc_libfile_path = os.path.join(sdk_library_dir, "libAgoraRtcKit.dylib")
+        rtc_libfile_path = mac_libfile_path
         #rtc_md5 = "ca3ca14f9e2b7d97eb2594d1f32dab9f"
-        rtc_md5 = "df0ec3b5073d17dee76cc4d97c13699a"
+        rtc_md5 = mac_md5
     if arch == "aarch64" and sys.platform == 'linux':
         #url = "https://download.agora.io/sdk/release/Agora-RTC-aarch64-linux-gnu-v4.4.31-20250307_175457-603878.zip"
         #url = "https://download.agora.io/sdk/release/Agora-RTC-aarch64-linux-gnu-v4.4.32-20250425_150503-675674.zip"
@@ -148,6 +173,7 @@ def _check_download_and_extract_sdk():
         url = "https://download.agora.io/sdk/release/Agora-RTC-aarch64-linux-gnu-v4.4.32-20251009_145437-921455_20251023_1538.zip"
         rtc_md5 = "5c002f25d2b381e353082da4f835b4f2"
 
+    '''
     is_file_exist = os.path.exists(rtc_libfile_path)
     if is_file_exist:
         md5_value = get_file_md5(rtc_libfile_path)
@@ -155,8 +181,15 @@ def _check_download_and_extract_sdk():
         md5_value = ""
     if md5_value == rtc_md5:
         return
+    '''
+    is_file_exist = os.path.exists(rtc_libfile_path)
+    version_url = _get_url_from_version_file(os.path.join(sdk_root_dir, "version.txt"))
+    if version_url == url and is_file_exist:
+        return
+        
+    #change from md5 check to url check
 
-    logger.error(f"missing agora sdk, now download it, please wait for a while...: {rtc_libfile_path} {md5_value} {rtc_md5} {is_file_exist}")
+    logger.error(f"missing agora sdk, now download it, please wait for a while...: {rtc_libfile_path} {version_url} {url} {is_file_exist}")
     if os.path.exists(sdk_library_dir):
         os.system(f"rm -rf {sdk_library_dir}")
     os.makedirs(sdk_library_dir, exist_ok=True)
@@ -176,6 +209,9 @@ def _check_download_and_extract_sdk():
 
     if os.path.exists(zip_path):
         os.remove(zip_path)
+    #write version url to version.txt
+    with open(os.path.join(sdk_root_dir, "version.txt"), "w") as f:
+        f.write(url)
     logger.error("download done, continue...")
 
 
@@ -198,5 +234,6 @@ else:
 if not os.path.exists(rtc_libfile_path):
     logger.error(f"library {rtc_libfile_path} not found")
     sys.exit(1)
-# import these variables to the sub modules
-__all__ = ['sdk_library_dir', 'sdk_rtc_dir', 'sdk_rtm_dir', 'sdk_root_dir']
+
+# Explicitly export these variables to ensure that submodules can import them
+__all__ = ['sdk_library_dir', 'sdk_rtc_dir', 'sdk_rtm_dir', 'sdk_root_dir']

{agora_python_server_sdk-2.3.4 → agora_python_server_sdk-2.4.1}/agora/rtc/__init__.py

@@ -22,11 +22,17 @@ try:
     if sys.platform == 'darwin':
         lib_agora_rtc_path = os.path.join(lib_dir, 'libAgoraRtcKit.dylib')
         agora_lib = ctypes.CDLL(lib_agora_rtc_path)
+        ctypes.CDLL(os.path.join(lib_dir, 'libAgoraAiNoiseSuppressionExtension.dylib'))
 
     elif sys.platform == 'linux':
         lib_agora_rtc_path = os.path.join(lib_dir, 'libagora_rtc_sdk.so')
         ctypes.CDLL(os.path.join(lib_dir, 'libagora-fdkaac.so'))
+        #ctypes.CDLL(os.path.join(lib_dir, 'libagora_ai_noise_suppression_extension.so'))
+        ctypes.CDLL(os.path.join(lib_dir, 'libagora-ffmpeg.so'))
+        ctypes.CDLL(os.path.join(lib_dir, 'libagora-soundtouch.so'))
         agora_lib = ctypes.CDLL(lib_agora_rtc_path)
+        # should load it or the ains can not work
+        ctypes.CDLL(os.path.join(lib_dir, 'libagora_ai_noise_suppression_extension.so'))
 except OSError as e:
     logger.error(f"Error loading the library: {e}")
     logger.error(f"Attempted to load from: {lib_agora_rtc_path}")

{agora_python_server_sdk-2.3.4 → agora_python_server_sdk-2.4.1}/agora/rtc/_ctypes_handle/_ctypes_data.py

@@ -1368,4 +1368,49 @@ class CapabilitiesItemMapInner(ctypes.Structure):
         return CapabilitiesItemMap(
             item=self.item,
             size=self.size
-        )
+        )
+
+class AudioSinkWantesInner(ctypes.Structure):
+    _fields_ = [
+        ("samples_per_sec", ctypes.c_int),
+        ("channels", ctypes.c_uint32),
+    ]
+    pass
+class AudioLabelInner(ctypes.Structure):
+    _fields_ = [
+        ("far_filed_flag", ctypes.c_int),
+        ("rms", ctypes.c_int),
+        ("voice_prob", ctypes.c_int),
+        ("music_prob", ctypes.c_int),
+        ("pitch", ctypes.c_int),
+    ]
+class AudioPcmFrameInner(ctypes.Structure):
+    _fields_ = [
+        ("capture_timestamp", ctypes.c_uint32),
+        ("samples_per_channel", ctypes.c_uint32),
+        ("sample_rate_hz", ctypes.c_int),
+        ("num_channels", ctypes.c_uint32),
+        ("bytes_per_sample", ctypes.c_uint32),
+        ("data", ctypes.c_int16*3840),
+        ("audio_label", AudioLabelInner),
+    ]
+    def get(self):
+        return AudioFrame(
+            type=0,
+            samples_per_channel=self.samples_per_channel,
+            bytes_per_sample=self.bytes_per_sample,
+            channels=self.num_channels,
+            samples_per_sec=self.sample_rate_hz,
+            buffer=bytearray(ctypes.string_at(self.data, self.samples_per_channel * self.bytes_per_sample * self.num_channels)),
+            render_time_ms=self.capture_timestamp,
+            avsync_type=0,
+            presentation_ms=0,
+            audio_track_number=0,
+            rtp_timestamp=0,
+            far_field_flag=self.audio_label.far_filed_flag,
+            rms=self.audio_label.rms,
+            voice_prob=self.audio_label.voice_prob,
+            music_prob=self.audio_label.music_prob,
+            pitch=self.audio_label.pitch
+        )
+    pass

{agora_python_server_sdk-2.3.4 → agora_python_server_sdk-2.4.1}/agora/rtc/_ctypes_handle/_local_user_observer.py

@@ -186,6 +186,8 @@ class RTCLocalUserObserverInner(ctypes.Structure):
     def _on_user_audio_track_subscribed(self, local_user_handle, user_id, remote_audio_track_handle):
         logger.debug(f"LocalUserCB _on_user_audio_track_subscribed: {local_user_handle}, {user_id}, {remote_audio_track_handle}")
         user_id_str = user_id.decode('utf-8') if user_id else ""
+        #add apm filter for remote audio track
+        self.local_user._set_apm_filter_properties(remote_audio_track_handle,user_id_str)
         # note: this is a pointer to agora::rtc::IRemoteAudioTrack
         remote_audio_track = RemoteAudioTrack(remote_audio_track_handle, user_id_str)
         # map to localuser to save reference

{agora_python_server_sdk-2.3.4 → agora_python_server_sdk-2.4.1}/agora/rtc/agora_base.py

@@ -297,6 +297,63 @@ class VideoFrame():
     alpha_buffer: bytearray = None
     alpha_mode: int = 0
 
+@dataclass(kw_only=True)
+class AiNsConfig:
+	ns_enabled: bool = True
+	ai_ns_enabled: bool = True
+	ai_ns_model_pref: int = 10
+	nsng_alg_route: int = 12
+	nsng_predef_agg: int = 11
+@dataclass(kw_only=True)
+class AiAecConfig:
+	enabled: bool = False
+	split_srate_for_48k: int = 16000
+
+@dataclass(kw_only=True)
+class BghvsCConfig:
+	enabled: bool = True
+	vad_thr: float = 0.8
+
+@dataclass(kw_only=True)
+class AgcConfig:
+	enabled: bool = False
+
+@dataclass(kw_only=True)
+class APMConfig:
+    ai_ns_config: AiNsConfig = field(default_factory=AiNsConfig)
+    ai_aec_config: AiAecConfig = field(default_factory=AiAecConfig)
+    bghvs_c_config: BghvsCConfig = field(default_factory=BghvsCConfig)
+    agc_config: AgcConfig = field(default_factory=AgcConfig)
+    enable_dump: bool = False
+    
+    def _to_json_string(self):
+        import json
+        config_dict = {
+            "aec": {
+                "enabled": self.ai_aec_config.enabled,
+                "split_srate_for_48k": self.ai_aec_config.split_srate_for_48k
+            },
+            "bghvs": {
+                "enabled": self.bghvs_c_config.enabled,
+                "vadThr": self.bghvs_c_config.vad_thr
+            },
+            "agc": {
+                "enabled": self.agc_config.enabled
+            },
+            "ans": {
+                "enabled": self.ai_ns_config.ns_enabled
+            },
+            "sf_st_cfg": {
+                "enabled": self.ai_ns_config.ai_ns_enabled,
+                "ainsModelPref": self.ai_ns_config.ai_ns_model_pref
+            },
+            "sf_ext_cfg": {
+                "nsngAlgRoute": self.ai_ns_config.nsng_alg_route,
+                "nsngPredefAgg": self.ai_ns_config.nsng_predef_agg
+            }
+        }
+        return json.dumps(config_dict, separators=(',', ':'))
+    
 
 @dataclass(kw_only=True)
 class AgoraServiceConfig:
@@ -324,6 +381,11 @@ class AgoraServiceConfig:
     log_file_size_kb: int = 5*1024
     data_dir: str = ""
     config_dir: str = "" #format like: "./agora_rtc_log"
+    #20251110 Fusion version: with apm filter
+    enable_apm: bool = False
+    apm_config: APMConfig = None
+
+
 
 
 @dataclass(kw_only=True)
@@ -566,4 +628,4 @@ class CapabilityItemMap:
 @dataclass(kw_only=True)
 class Capabilities:
     item_map: CapabilityItemMap = None
-    capability_type: int = 0
+    capability_type: int = 0

{agora_python_server_sdk-2.3.4 → agora_python_server_sdk-2.4.1}/agora/rtc/agora_service.py

@@ -65,6 +65,14 @@ agora_service_set_log_filter = agora_lib.agora_service_set_log_filter
 agora_service_set_log_filter.restype = AGORA_API_C_INT
 agora_service_set_log_filter.argtypes = [AGORA_HANDLE, ctypes.c_uint]
 
+agora_audio_track_enable_audio_filter = agora_lib.agora_audio_track_enable_audio_filter
+agora_audio_track_enable_audio_filter.restype = ctypes.c_int
+agora_audio_track_enable_audio_filter.argtypes = [AGORA_HANDLE, ctypes.c_char_p, ctypes.c_int, ctypes.c_int]
+
+agora_audio_track_set_filter_property = agora_lib.agora_audio_track_set_filter_property
+agora_audio_track_set_filter_property.restype = ctypes.c_int
+agora_audio_track_set_filter_property.argtypes = [AGORA_HANDLE, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_int]
+
 
 class AgoraService:
     def __init__(self) -> None:
@@ -74,6 +82,8 @@ class AgoraService:
         self.inited = False
         #default to None, and never create it manually by developer from ver2.3.0
         self.media_node_factory = None
+        self.enable_apm = False
+        self.apm_config = None
 
     def initialize(self, config: AgoraServiceConfig):
         if self.inited == True:
@@ -101,7 +111,20 @@ class AgoraService:
 
         # force audio vad v2 to be enabled
         agora_parameter.set_parameters("{\"che.audio.label.enable\": true}")
-
+        # for apm filter: to enable apm filter
+        generator = "audio_processing_remote_playback"
+        cgenerator = generator.encode('utf-8')
+        ctrak = ctypes.c_char_p(None)
+        result = agora_service_enable_extension(self.service_handle, cprovider, cgenerator, ctrak, 1)
+        if result != 0:
+            logger.error(f"Failed to enable audio processing remote playback filter. Error code: {result}")
+        if config.enable_apm:
+            generator = "audio_processing_pcm_source"
+            cgenerator = generator.encode('utf-8')
+            result = agora_service_enable_extension(self.service_handle, cprovider, cgenerator, ctrak, 1)
+            if result != 0:
+                logger.error(f"Failed to enable audio processing pcm source filter. Error code: {result}")
+       
         #versio 2.2.0 for callback when muted
         if config.should_callbck_when_muted > 0:
             agora_parameter.set_parameters("{\"rtc.audio.enable_user_silence_packet\": true}")
@@ -112,6 +135,17 @@ class AgoraService:
         '''
         agora_parameter.set_parameters("{\"che.video.min_enc_level\": 0}")
 
+        #keep & save apm config
+        self.enable_apm = config.enable_apm
+        if self.enable_apm:
+            if config.apm_config is None:
+                self.apm_config = APMConfig()
+            else:
+                self.apm_config = config.apm_config
+        else:
+            self.apm_config = None
+        
+
         return result
 
     def release(self):
@@ -210,3 +244,27 @@ class AgoraService:
         else:
             logger.error(f"Failed to set log file. Error code: {result}")
         return result
+    #apm related:
+#apm related api
+def _get_audio_filter_position(is_local_track: bool = False) -> int:
+    if is_local_track:
+        return 3
+    return 2
+
+def _enable_audio_filter_by_track(track: any, name: str, enable: bool, is_local_track: bool) -> int:
+    if track is None:
+        return -1000
+    c_name = ctypes.c_char_p(name.encode('utf-8'))
+    c_enable = ctypes.c_int(0)
+    if enable:
+        c_enable = ctypes.c_int(1)
+    position = _get_audio_filter_position(is_local_track)
+    return int(agora_audio_track_enable_audio_filter(track, c_name, c_enable, ctypes.c_int(position)))
+def _set_filter_property_by_track(track: any, name: str, key: str, value: str, is_local_track: bool) -> int:
+    if track is None:
+        return -1000
+    c_name = ctypes.c_char_p(name.encode('utf-8'))
+    c_key = ctypes.c_char_p(key.encode('utf-8'))
+    c_value = ctypes.c_char_p(value.encode('utf-8'))
+    position = _get_audio_filter_position(is_local_track)
+    return int(agora_audio_track_set_filter_property(track, c_name, c_key, c_value, ctypes.c_int(position)))