agora-python-server-sdk 2.1.7__tar.gz → 2.2.1__tar.gz

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: agora_python_server_sdk
-Version: 2.1.7
+Version: 2.2.1
 Summary: A Python SDK for Agora Server
 Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
 Classifier: Intended Audience :: Developers
@@ -12,6 +12,12 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-python
+Dynamic: summary
 
 # Note
 - This is a Python SDK wrapper for the Agora RTC SDK.
@@ -50,6 +56,26 @@ python agora_rtc/examples/example_audio_pcm_send.py --appId=xxx --channelId=xxx
 ```
 
 # Change log
+2025.02.26 Release 2.2.1
+--Update：
+  ​- Reduced buffer size from ​180ms​ to ​100ms​ to minimize latency.
+-- Added：
+  - AudioConsumer::is_push_to_rtc_completed： Add audio consumer support for playback state notifications.
+-- ​Bug fix:
+  - Fixed incorrect _samples_per_channel calculation in stereo mode.
+
+2025.01.08 Release 2.2.0
+-- Updates:
+  - Update the SDK version from 4.4.30 to 4.4.31. Done.
+-- FEAT:
+  - Add serviceconfigure.
+    - Add domain_limit. Done.
+    - Add should_callback_when_muted. Done.
+    - Add colorspacetype to ExternalVideoFrame to support the encoding of solid-color backgrounds in virtual human scenarios. Done.
+-- FEAT:
+  - Add the AudioMetaData interface: localuser::send_audio_meta_data. Done.
+  - Add the OnAudioMetaDataReceived callback to localuserObserver::on_audio_meta_data_received. Done.
+-- Sample modifications.
 
 2024.12.17 Release 2.1.7
 --Changes:

agora_python_server_sdk-2.1.7/agora_python_server_sdk.egg-info/PKG-INFO → agora_python_server_sdk-2.2.1/README.md

@@ -1,18 +1,3 @@
-Metadata-Version: 2.1
-Name: agora_python_server_sdk
-Version: 2.1.7
-Summary: A Python SDK for Agora Server
-Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Topic :: Multimedia :: Sound/Audio
-Classifier: Topic :: Multimedia :: Video
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-
 # Note
 - This is a Python SDK wrapper for the Agora RTC SDK.
 - It supports Linux and Mac platforms.
@@ -50,6 +35,26 @@ python agora_rtc/examples/example_audio_pcm_send.py --appId=xxx --channelId=xxx
 ```
 
 # Change log
+2025.02.26 Release 2.2.1
+--Update：
+  ​- Reduced buffer size from ​180ms​ to ​100ms​ to minimize latency.
+-- Added：
+  - AudioConsumer::is_push_to_rtc_completed： Add audio consumer support for playback state notifications.
+-- ​Bug fix:
+  - Fixed incorrect _samples_per_channel calculation in stereo mode.
+
+2025.01.08 Release 2.2.0
+-- Updates:
+  - Update the SDK version from 4.4.30 to 4.4.31. Done.
+-- FEAT:
+  - Add serviceconfigure.
+    - Add domain_limit. Done.
+    - Add should_callback_when_muted. Done.
+    - Add colorspacetype to ExternalVideoFrame to support the encoding of solid-color backgrounds in virtual human scenarios. Done.
+-- FEAT:
+  - Add the AudioMetaData interface: localuser::send_audio_meta_data. Done.
+  - Add the OnAudioMetaDataReceived callback to localuserObserver::on_audio_meta_data_received. Done.
+-- Sample modifications.
 
 2024.12.17 Release 2.1.7
 --Changes:
@@ -322,4 +327,4 @@ VAD: Good afternoon, what are some fun places to visit in Beijing?
 
 
 
-If latency is a concern, you can lower this value, or consult with the development team to determine how to manage latency while ensuring semantic continuity in speech recognition. This will help avoid the AI being interrupted too sensitively.
+If latency is a concern, you can lower this value, or consult with the development team to determine how to manage latency while ensuring semantic continuity in speech recognition. This will help avoid the AI being interrupted too sensitively.

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/agora/rtc/__init__.py

@@ -26,13 +26,23 @@ def _check_download_and_extract_sdk():
     sdk_dir = os.path.join(agora_service_path, "agora_sdk")
     zip_path = os.path.join(agora_service_path, "agora_rtc_sdk.zip")
 
-    url = "https://download.agora.io/sdk/release/agora_rtc_sdk-x86_64-linux-gnu-v4.4.30-20241024_101940-398537.zip"
+    #url = "https://download.agora.io/sdk/release/agora_rtc_sdk-x86_64-linux-gnu-v4.4.30-20241024_101940-398537.zip"
+    # version 2.2.0 for linux
+    url = "https://download.agora.io/sdk/release/agora_rtc_sdk-x86_64-linux-gnu-v4.4.31-20241223_111509-491956.zip"
+        
+           
     libagora_rtc_sdk_path = os.path.join(sdk_dir, "libagora_rtc_sdk.so")
-    rtc_md5 = "7031dd10d1681cd88fd89d68c5b54282"
+    #rtc_md5 = "7031dd10d1681cd88fd89d68c5b54282"
+    rtc_md5 = "f2a9e3ed15f872cb7e3b62d1528ac5cb"
     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"
+        #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
+        url = "https://download.agora.io/sdk/release/agora_sdk_mac_v4.4.31_23136_FULL_20241223_1245_492039.zip"
+
         libagora_rtc_sdk_path = os.path.join(sdk_dir, "libAgoraRtcKit.dylib")
-        rtc_md5 = "ca3ca14f9e2b7d97eb2594d1f32dab9f"
+        #rtc_md5 = "ca3ca14f9e2b7d97eb2594d1f32dab9f"
+        rtc_md5 = "6821cae218c8f31f8d720ac0c77edab0"
+
 
     if os.path.exists(libagora_rtc_sdk_path) and get_file_md5(libagora_rtc_sdk_path) == rtc_md5:
         return

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/agora/rtc/_ctypes_handle/_ctypes_data.py

@@ -718,6 +718,29 @@ class RemoteVideoTrackStatsInner(ctypes.Structure):
             stats.total_active_time,
             stats.publish_duration
         )
+    
+class ColorSpaceTypeInner(ctypes.Structure):
+    _fields_ = [
+        ("primaries_id", ctypes.c_int),
+        ("transfer_id", ctypes.c_int),
+        ("matrix_id", ctypes.c_int),
+        ("range_id", ctypes.c_int)
+    ]
+    def get(self):
+        return ColorSpaceType(
+            primaries_id=self.primaries_id,
+            transfer_id=self.transfer_id,
+            matrix_id=self.matrix_id,
+            range_id=self.range_id
+        )
+    @staticmethod
+    def create(colorspace:ColorSpaceType) -> 'ColorSpaceTypeInner':
+        return ColorSpaceTypeInner(
+            primaries_id=colorspace.primaries_id,
+            transfer_id=colorspace.transfer_id,
+            matrix_id=colorspace.matrix_id,
+            range_id=colorspace.range_id
+        )
 
 
 class ExternalVideoFrameInner(ctypes.Structure):
@@ -741,7 +764,8 @@ class ExternalVideoFrameInner(ctypes.Structure):
         ("metadata_size", ctypes.c_int),
         ("alpha_buffer", ctypes.c_void_p),
         ("fill_alpha_buffer", ctypes.c_uint8),
-        ("alpha_mode", ctypes.c_int)
+        ("alpha_mode", ctypes.c_int),
+        ("color_space", ColorSpaceTypeInner)
     ]
 
     def get(self):
@@ -765,7 +789,8 @@ class ExternalVideoFrameInner(ctypes.Structure):
             metadata_size=self.metadata_size,
             alpha_buffer=self.alpha_buffer,
             fill_alpha_buffer=self.fill_alpha_buffer,
-            alpha_mode=self.alpha_mode
+            alpha_mode=self.alpha_mode,
+            color_space=self.color_space.get()
         )
 
     @staticmethod
@@ -784,12 +809,13 @@ class ExternalVideoFrameInner(ctypes.Structure):
         else:
             c_alpha_buffer_ptr = ctypes.c_void_p(0)
 
-        c_metadata_size = len (frame.metadata)
+        c_metadata_size = len (frame.metadata) if frame.metadata is not None else 0
         if frame.metadata is not None and c_metadata_size > 0:
             c_metadata_ptr = (ctypes.c_uint8 * len(frame.metadata)).from_buffer(frame.metadata)
             c_metadata_size = len(frame.metadata)
         else:
-            c_metadata_ptr = ctypes.c_void_p(0)
+            #c_metadata_ptr = ctypes.c_void_p(0)
+            c_metadata_ptr  = ctypes.POINTER(ctypes.c_uint8)()
             c_metadata_size = 0
        
         
@@ -815,7 +841,8 @@ class ExternalVideoFrameInner(ctypes.Structure):
             c_metadata_size,
             c_alpha_buffer_ptr,
             frame.fill_alpha_buffer,
-            frame.alpha_mode
+            frame.alpha_mode,
+            ColorSpaceTypeInner.create(frame.color_space)
         )
 
 
@@ -1105,6 +1132,7 @@ class AgoraServiceConfigInner(ctypes.Structure):
         ('audio_scenario', ctypes.c_int),
 
         ('use_string_uid', ctypes.c_int),
+        ('domain_limit', ctypes.c_int),
     ]
 
     def get(self):
@@ -1117,7 +1145,8 @@ class AgoraServiceConfigInner(ctypes.Structure):
             area_code=self.area_code,
             channel_profile=self.channel_profile,
             audio_scenario=self.audio_scenario,
-            use_string_uid=self.use_string_uid
+            use_string_uid=self.use_string_uid,
+            domain_limit=self.domain_limit
         )
 
     @staticmethod
@@ -1131,7 +1160,8 @@ class AgoraServiceConfigInner(ctypes.Structure):
             config.area_code,
             config.channel_profile,
             config.audio_scenario,
-            config.use_string_uid
+            config.use_string_uid,
+            config.domain_limit
         )
 
 

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/agora/rtc/_ctypes_handle/_local_user_observer.py

@@ -44,6 +44,7 @@ ON_INTRA_REQUEST_RECEIVED_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE)
 ON_REMOTE_SUBSCRIBE_FALLBACK_TO_AUDIO_ONLY_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE, user_id_t, ctypes.c_int)
 ON_STREAM_MESSAGE_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE, user_id_t, ctypes.c_int, ctypes.c_char_p, ctypes.c_size_t)
 ON_USER_STATE_CHANGED_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE, user_id_t, ctypes.c_uint32)
+ON_AUDIO_META_DATA_RECEIVED_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE, user_id_t, ctypes.c_char_p, ctypes.c_size_t)
 
 
 class RTCLocalUserObserverInner(ctypes.Structure):
@@ -85,7 +86,8 @@ class RTCLocalUserObserverInner(ctypes.Structure):
         ("on_intra_request_received", ON_INTRA_REQUEST_RECEIVED_CALLBACK),
         ("on_remote_subscribe_fallback_to_audio_only", ON_REMOTE_SUBSCRIBE_FALLBACK_TO_AUDIO_ONLY_CALLBACK),
         ("on_stream_message", ON_STREAM_MESSAGE_CALLBACK),
-        ("on_user_state_changed", ON_USER_STATE_CHANGED_CALLBACK)
+        ("on_user_state_changed", ON_USER_STATE_CHANGED_CALLBACK),
+        ("on_audio_meta_data_received", ON_AUDIO_META_DATA_RECEIVED_CALLBACK)
     ]
 
     def __init__(self, local_user_observer: IRTCLocalUserObserver, local_user: 'LocalUser') -> None:
@@ -128,6 +130,7 @@ class RTCLocalUserObserverInner(ctypes.Structure):
         self.on_remote_subscribe_fallback_to_audio_only = ON_REMOTE_SUBSCRIBE_FALLBACK_TO_AUDIO_ONLY_CALLBACK(self._on_remote_subscribe_fallback_to_audio_only)
         self.on_stream_message = ON_STREAM_MESSAGE_CALLBACK(self._on_stream_message)
         self.on_user_state_changed = ON_USER_STATE_CHANGED_CALLBACK(self._on_user_state_changed)
+        self.on_audio_meta_data_received = ON_AUDIO_META_DATA_RECEIVED_CALLBACK(self._on_audio_meta_data_received)
 
     """
     it seems that this interface does not provide much value to the user's business, 
@@ -348,3 +351,8 @@ class RTCLocalUserObserverInner(ctypes.Structure):
         logger.debug(f"LocalUserCB _on_user_state_changed: {local_user_handle}, {user_id}, {state}")
         user_id_str = user_id.decode('utf-8') if user_id else ""
         self.local_user_observer.on_user_state_changed(self.local_user, user_id_str, state)
+    def _on_audio_meta_data_received(self, local_user_handle, user_id, audio_meta_data, size):
+        user_id_str = user_id.decode('utf-8') if user_id else ""
+        bytes_from_c = bytearray(ctypes.string_at(audio_meta_data, size))
+        
+        self.local_user_observer.on_audio_meta_data_received(self.local_user, user_id_str, bytes_from_c)

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/agora/rtc/agora_base.py

@@ -307,6 +307,15 @@ class AgoraServiceConfig:
     channel_profile: ChannelProfileType = ChannelProfileType.CHANNEL_PROFILE_LIVE_BROADCASTING
     audio_scenario: AudioScenarioType = AudioScenarioType.AUDIO_SCENARIO_CHORUS
     use_string_uid: int = 0
+    #version 2.2.0
+    # default to 0
+    domain_limit: int = 0
+    '''
+    // if >0, when remote user muted itself, the onplaybackbeforemixing will be still called badk with active pacakage
+	// if <=0, when remote user muted itself, the onplaybackbeforemixing will be no longer called back
+	// default to 0, i.e when muted, no callback will be triggered
+    '''
+    should_callbck_when_muted: int = 0
 
 
 @dataclass(kw_only=True)
@@ -423,6 +432,13 @@ class VideoEncoderConfiguration:
     mirror_mode: int = 0
     encode_alpha: int = 0
 
+@dataclass(kw_only=True)
+class ColorSpaceType:
+    primaries_id: int = 0
+    transfer_id: int = 0
+    matrix_id: int = 0
+    range_id: int = 0
+
 
 @dataclass(kw_only=True)
 class ExternalVideoFrame:
@@ -445,6 +461,7 @@ class ExternalVideoFrame:
     alpha_buffer: bytearray = None
     fill_alpha_buffer: int = 0
     alpha_mode: int = 0
+    color_space: ColorSpaceType = field(default_factory=ColorSpaceType)
 
 
 @dataclass(kw_only=True)

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/agora/rtc/agora_service.py

@@ -92,6 +92,10 @@ class AgoraService:
         # force audio vad v2 to be enabled
         agora_parameter.set_parameters("{\"che.audio.label.enable\": true}")
 
+        #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}")
+
         if config.log_path:
             log_size = 512 * 1024
             if config.log_size > 0:

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/agora/rtc/local_user.py

@@ -223,6 +223,15 @@ agora_local_user_set_audio_scenario = agora_lib.agora_local_user_set_audio_scena
 agora_local_user_set_audio_scenario.restype = AGORA_API_C_INT
 agora_local_user_set_audio_scenario.argtypes = [AGORA_HANDLE, ctypes.c_int]
 
+#verison 2.2.0
+
+#AGORA_API_C_INT agora_local_user_send_audio_meta_data(AGORA_HANDLE agora_local_user, const char* meta_data, size_t length);
+agora_local_user_send_aduio_meta_data = agora_lib.agora_local_user_send_audio_meta_data
+agora_local_user_send_aduio_meta_data.restype = AGORA_API_C_INT
+agora_local_user_send_aduio_meta_data.argtypes = [AGORA_HANDLE, ctypes.c_char_p, ctypes.c_size_t]
+
+
+
 
 class LocalUser:
     def __init__(self, local_user_handle, connection):
@@ -594,3 +603,12 @@ class LocalUser:
     def set_audio_scenario(self, scenario_type: AudioScenarioType):
         ret = agora_local_user_set_audio_scenario(self.user_handle, scenario_type.value)
         return ret
+    # data can be str or bytes/bytearray object,is diff to send_sream_message which is a str object
+    def send_audio_meta_data(self, data):
+        # chang to ctypes.c_char_p
+        if isinstance(data, str):
+            data = data.encode('utf-8')
+        c_data = ctypes.create_string_buffer(bytes(data))
+        size = len(data)
+        ret = agora_local_user_send_aduio_meta_data(self.user_handle, c_data, ctypes.c_size_t(size))
+        return ret

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/agora/rtc/local_user_observer.py

@@ -117,3 +117,6 @@ class IRTCLocalUserObserver():
 
     def on_user_state_changed(self, agora_local_user, user_id, state):
         pass
+    # data is bytearray object, is diff to on_stream_msg which is str object
+    def on_audio_meta_data_received(self, agora_local_user, user_id, data):
+        pass

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/agora/rtc/utils/audio_consumer.py

@@ -31,6 +31,8 @@ AudioConsumer调用方式：
     E 退出的时候，调用release()方法，释放资源
 """
 class AudioConsumer:
+    MIN_BUFFER_SIZE = 10
+    RTC_E2E_DELAY = 200 # e2e delay 90ms for iphone, 120ms for android;150ms for web. so we use 200ms here
     def __init__(self, pcm_sender: AudioPcmDataSender, sample_rate: int, channels: int) -> None:
         self._lock = threading.Lock()
         self._start_time = 0
@@ -45,11 +47,12 @@ class AudioConsumer:
         #audio parame
         self._frame.bytes_per_sample = 2
         self._bytes_per_frame = sample_rate // 100 * channels * 2
-        self._samples_per_channel = sample_rate // 100* channels
+        self._samples_per_channel = sample_rate // 100
         #init pcmaudioframe
         self._frame.timestamp = 0
 
         self._init = True
+        self._last_consume_time = 0
         
         pass
     def push_pcm_data(self, data) ->None:
@@ -64,6 +67,7 @@ class AudioConsumer:
             return
         self._start_time = time.time()*1000
         self._consumed_packages = 0
+        self._last_consume_time = self._start_time
         pass
  
     def consume(self):
@@ -75,13 +79,16 @@ class AudioConsumer:
         expected_total_packages = int(elapsed_time//10)
         besent_packages = expected_total_packages - self._consumed_packages
         data_len = len(self._data)
+        #if data is not empty, to update last consume time
+        if data_len > 0:
+            self._last_consume_time = now
 
-        if besent_packages > 18 and data_len //self._bytes_per_frame < 18: #for fist time, if data_len is not enough, just return and wait for next time
+        if besent_packages > AudioConsumer.MIN_BUFFER_SIZE and data_len //self._bytes_per_frame < AudioConsumer.MIN_BUFFER_SIZE: #for fist time, if data_len is not enough, just return and wait for next time
             #print("-----underflow data")
             return -2
-        if besent_packages > 18: #rest to start state, push 18 packs in Start_STATE
+        if besent_packages > AudioConsumer.MIN_BUFFER_SIZE: #rest to start state, push 18 packs in Start_STATE
             self._reset()
-            besent_packages = min(18, data_len//self._bytes_per_frame)
+            besent_packages = min(AudioConsumer.MIN_BUFFER_SIZE, data_len//self._bytes_per_frame)
             self._consumed_packages = -besent_packages
             
 
@@ -113,6 +120,25 @@ class AudioConsumer:
             return 0
         with self._lock:
             return len(self._data)
+
+    #判断AudioConsumer中的数据是否已经完全推送给了RTC 频道
+    #因为audioconsumer内部有一定的缓存机制，所以当get_remaining_data_size 返回是0的时候，还有数据没有推送给
+    #rtc 频道。如果要判断数据是否完全推送给了rtc 频道，需要调用这个api来做判断。
+    #return value：1--push to rtc completed, 0--push to rtc not completed   -1--error
+    def is_push_to_rtc_completed(self)->int:
+        if self._init == False:
+            return -1
+        with self._lock:
+            remain_size = len(self._data)
+            if remain_size == 0:
+                now = time.time()*1000
+                diff = now - self._last_consume_time
+
+                if diff > AudioConsumer.MIN_BUFFER_SIZE*10 + AudioConsumer.RTC_E2E_DELAY:
+                    return 1
+            
+            return 0
+        pass
     def clear(self):
         if self._init == False:
             return

agora_python_server_sdk-2.1.7/README.md → agora_python_server_sdk-2.2.1/agora_python_server_sdk.egg-info/PKG-INFO

@@ -1,3 +1,24 @@
+Metadata-Version: 2.2
+Name: agora_python_server_sdk
+Version: 2.2.1
+Summary: A Python SDK for Agora Server
+Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-python
+Dynamic: summary
+
 # Note
 - This is a Python SDK wrapper for the Agora RTC SDK.
 - It supports Linux and Mac platforms.
@@ -35,6 +56,26 @@ python agora_rtc/examples/example_audio_pcm_send.py --appId=xxx --channelId=xxx
 ```
 
 # Change log
+2025.02.26 Release 2.2.1
+--Update：
+  ​- Reduced buffer size from ​180ms​ to ​100ms​ to minimize latency.
+-- Added：
+  - AudioConsumer::is_push_to_rtc_completed： Add audio consumer support for playback state notifications.
+-- ​Bug fix:
+  - Fixed incorrect _samples_per_channel calculation in stereo mode.
+
+2025.01.08 Release 2.2.0
+-- Updates:
+  - Update the SDK version from 4.4.30 to 4.4.31. Done.
+-- FEAT:
+  - Add serviceconfigure.
+    - Add domain_limit. Done.
+    - Add should_callback_when_muted. Done.
+    - Add colorspacetype to ExternalVideoFrame to support the encoding of solid-color backgrounds in virtual human scenarios. Done.
+-- FEAT:
+  - Add the AudioMetaData interface: localuser::send_audio_meta_data. Done.
+  - Add the OnAudioMetaDataReceived callback to localuserObserver::on_audio_meta_data_received. Done.
+-- Sample modifications.
 
 2024.12.17 Release 2.1.7
 --Changes:
@@ -307,4 +348,4 @@ VAD: Good afternoon, what are some fun places to visit in Beijing?
 
 
 
-If latency is a concern, you can lower this value, or consult with the development team to determine how to manage latency while ensuring semantic continuity in speech recognition. This will help avoid the AI being interrupted too sensitively.
+If latency is a concern, you can lower this value, or consult with the development team to determine how to manage latency while ensuring semantic continuity in speech recognition. This will help avoid the AI being interrupted too sensitively.

{agora_python_server_sdk-2.1.7 → agora_python_server_sdk-2.2.1}/setup.py

@@ -20,10 +20,15 @@ class CustomInstallCommand(install):
         agora_service_path = os.path.join(site.getsitepackages()[0], 'agora', 'rtc')
         sdk_dir = os.path.join(agora_service_path, "agora_sdk")
         zip_path = os.path.join(agora_service_path, "agora_rtc_sdk.zip")
-
-        url = "https://download.agora.io/sdk/release/agora_rtc_sdk-x86_64-linux-gnu-v4.4.30-20241024_101940-398537.zip"
+        '''# version before 2.2.0
+        #url = "https://download.agora.io/sdk/release/agora_rtc_sdk-x86_64-linux-gnu-v4.4.30-20241024_101940-398537.zip"
+        #url = "https://download.agora.io/sdk/release/agora_rtc_sdk_mac_rel.v4.4.30_22472_FULL_20241024_1224_398653.zip"
+        '''
+        # verison 2.2.0
+        url = "https://download.agora.io/sdk/release/agora_rtc_sdk-x86_64-linux-gnu-v4.4.31-20241223_111509-491956.zip"
         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"
+            url = "https://download.agora.io/sdk/release/agora_sdk_mac_v4.4.31_23136_FULL_20241223_1245_492039.zip"
+
 
         if os.path.exists(sdk_dir):
             os.system(f"rm -rf {sdk_dir}")
@@ -45,7 +50,7 @@ class CustomInstallCommand(install):
 
 setup(
     name='agora_python_server_sdk',
-    version='2.1.7',
+    version='2.2.1',
     description='A Python SDK for Agora Server',
     long_description=open('README.md').read(),
     long_description_content_type='text/markdown',