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

{agora_python_server_sdk-2.2.0/agora_python_server_sdk.egg-info → 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.2.0
+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,13 @@ 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:

{agora_python_server_sdk-2.2.0 → agora_python_server_sdk-2.2.1}/README.md

@@ -35,6 +35,13 @@ 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:

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

@@ -809,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
        
         

{agora_python_server_sdk-2.2.0 → 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.2.0 → agora_python_server_sdk-2.2.1/agora_python_server_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: agora_python_server_sdk
-Version: 2.2.0
+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,13 @@ 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:

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

@@ -50,7 +50,7 @@ class CustomInstallCommand(install):
 
 setup(
     name='agora_python_server_sdk',
-    version='2.2.0',
+    version='2.2.1',
     description='A Python SDK for Agora Server',
     long_description=open('README.md').read(),
     long_description_content_type='text/markdown',