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

{agora_python_server_sdk-2.2.1/agora_python_server_sdk.egg-info → agora_python_server_sdk-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.1
 Name: agora_python_server_sdk
-Version: 2.2.1
+Version: 2.2.2
 Summary: A Python SDK for Agora Server
 Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
 Classifier: Intended Audience :: Developers
@@ -12,12 +12,6 @@ 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.
@@ -56,6 +50,19 @@ python agora_rtc/examples/example_audio_pcm_send.py --appId=xxx --channelId=xxx
 ```
 
 # Change log
+2025.04.10 Release 2.2.2
+-- Additions:
+  - Added push_video_encoded_file.py to support pushing mp4 files and h264 encoded h.264 files. Includes conversion from mp4 file avformat to raw 264 stream in annex B format.
+-- Additions:
+  - Added set_log_file_filter function to set the log filter level.
+-- Additions:
+  - Added support for arm64 version, but currently this version does not support audio label algorithm. Therefore, it is not supported on arm64!
+-- Changes:
+  - Modified localuserstats, local video stats, local audio stats, remote video stats, remote audio stats.
+-- Additions:
+  - Added connection::agora_rtc_conn_enable_encryption.
+-- Additions:
+  - Added connectionObserver::on_encryption_error (but not working for now, need to fix in the next monthly version 4.4.32).
 2025.02.26 Release 2.2.1
 --Update：
   ​- Reduced buffer size from ​180ms​ to ​100ms​ to minimize latency.

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

@@ -35,6 +35,19 @@ python agora_rtc/examples/example_audio_pcm_send.py --appId=xxx --channelId=xxx
 ```
 
 # Change log
+2025.04.10 Release 2.2.2
+-- Additions:
+  - Added push_video_encoded_file.py to support pushing mp4 files and h264 encoded h.264 files. Includes conversion from mp4 file avformat to raw 264 stream in annex B format.
+-- Additions:
+  - Added set_log_file_filter function to set the log filter level.
+-- Additions:
+  - Added support for arm64 version, but currently this version does not support audio label algorithm. Therefore, it is not supported on arm64!
+-- Changes:
+  - Modified localuserstats, local video stats, local audio stats, remote video stats, remote audio stats.
+-- Additions:
+  - Added connection::agora_rtc_conn_enable_encryption.
+-- Additions:
+  - Added connectionObserver::on_encryption_error (but not working for now, need to fix in the next monthly version 4.4.32).
 2025.02.26 Release 2.2.1
 --Update：
   ​- Reduced buffer size from ​180ms​ to ​100ms​ to minimize latency.

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

@@ -8,6 +8,7 @@ from urllib import request
 import ctypes
 import os
 import sys
+import platform
 import logging
 logger = logging.getLogger(__name__)
 ssl._create_default_https_context = ssl._create_unverified_context
@@ -26,6 +27,12 @@ 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")
 
+    # for diff os and arch
+    arch = platform.machine()
+    os_type = platform.system()
+
+    
+
     #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"
@@ -42,6 +49,9 @@ def _check_download_and_extract_sdk():
         libagora_rtc_sdk_path = os.path.join(sdk_dir, "libAgoraRtcKit.dylib")
         #rtc_md5 = "ca3ca14f9e2b7d97eb2594d1f32dab9f"
         rtc_md5 = "6821cae218c8f31f8d720ac0c77edab0"
+    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"
+        rtc_md5 = "41d200483e2e2e913a617c59b9d922b0"
 
 
     if os.path.exists(libagora_rtc_sdk_path) and get_file_md5(libagora_rtc_sdk_path) == rtc_md5:

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

@@ -267,7 +267,7 @@ class LocalAudioStatsInner(ctypes.Structure):
     ]
 
     def get(self):
-        return LocalAudioStats(
+        return LocalAudioTrackStats(
             num_channels=self.num_channels,
             sent_sample_rate=self.sent_sample_rate,
             sent_bitrate=self.sent_bitrate,
@@ -276,7 +276,7 @@ class LocalAudioStatsInner(ctypes.Structure):
         )
 
     @staticmethod
-    def create(stats: LocalAudioStats) -> 'LocalAudioStatsInner':
+    def create(stats: LocalAudioTrackStats) -> 'LocalAudioStatsInner':
         return LocalAudioStatsInner(
             stats.num_channels,
             stats.sent_sample_rate,
@@ -1210,3 +1210,39 @@ class EncodedVideoFrameInfoInner(ctypes.Structure):
             info.uid,
             info.stream_type
         )
+    
+
+
+class EncryptionConfigInner(ctypes.Structure):
+    _fields_ = [
+        ("encryption_mode", ctypes.c_int),
+        ("encryption_key", ctypes.c_char_p),
+        ("encryption_kdf_salt", ctypes.c_uint8 * 32)
+    ]
+
+    def get(self):
+        return EncryptionConfig(
+            encryption_mode=self.encryption_mode,
+            encryption_key=self.encryption_key.decode() if self.encryption_key else "",
+            encryption_kdf_salt=bytearray(bytes(self.encryption_kdf_salt))
+        )   
+
+    @staticmethod
+    def create(config: EncryptionConfig) -> 'EncryptionConfigInner':
+        length = len(config.encryption_kdf_salt) if config.encryption_kdf_salt else 0
+        #   如果length大于32，则设置为32
+        if length > 32:
+            length = 32
+        #change bytearray to uint8 * length
+        if length > 0:
+            encryption_kdf_salt = (ctypes.c_uint8 * length)(*config.encryption_kdf_salt)
+        else:
+            encryption_kdf_salt = (ctypes.c_uint8 * 32)() # 32 bytes,empty array
+        # change encryption_key to c_char_p
+        encryption_key = config.encryption_key.encode('utf-8') if config.encryption_key else None
+        #change None to c_char_p
+        return EncryptionConfigInner(
+            config.encryption_mode,
+            encryption_key,
+            encryption_kdf_salt
+        )

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

@@ -180,7 +180,7 @@ class RTCLocalUserObserverInner(ctypes.Structure):
         self.local_user_observer.on_local_audio_track_state_changed(self.local_user, audio_track, state, error)
 
     def _on_local_audio_track_statistics(self, local_user_handle, stats):
-        local_audio_stats = stats.contents
+        local_audio_stats = stats.contents.get() if stats else None
         self.local_user_observer.on_local_audio_track_statistics(self.local_user, local_audio_stats)
 
     def _on_user_audio_track_subscribed(self, local_user_handle, user_id, remote_audio_track_handle):
@@ -194,7 +194,7 @@ class RTCLocalUserObserverInner(ctypes.Structure):
 
     def _on_remote_audio_track_statistics(self, local_user_handle, remote_audio_track_handle, stats):
         logger.debug(f"LocalUserCB _on_remote_audio_track_statistics: {local_user_handle}, {remote_audio_track_handle}, {stats}")
-        audio_stats = stats.contents  # RemoteAudioTrackStats
+        audio_stats = stats.contents.get() if stats else None
         remote_audio_track = self.local_user.get_remote_audio_map(remote_audio_track_handle)
         self.local_user_observer.on_remote_audio_track_statistics(self.local_user, remote_audio_track, audio_stats)
 
@@ -246,7 +246,7 @@ class RTCLocalUserObserverInner(ctypes.Structure):
         logger.debug(f"LocalUserCB _on_local_video_track_statistics: {local_user_handle}, {local_video_track_handle}, {stats}")
         # stats: ctypes.pointer to LocalVideoTrackStats
         local_video_track = self.local_user.get_video_map(local_video_track_handle)
-        video_stats = stats.contents
+        video_stats = stats.contents.get() if stats else None
         self.local_user_observer.on_local_video_track_statistics(self.local_user, local_video_track, video_stats)
 
     def _on_user_video_track_subscribed(self, local_user_handle, user_id, video_track_info, remote_video_track_handle):
@@ -269,7 +269,7 @@ class RTCLocalUserObserverInner(ctypes.Structure):
 
     def _on_remote_video_track_statistics(self, local_user_handle, remote_video_track_handle, stats_ptr):
         logger.debug(f"LocalUserCB _on_remote_video_track_statistics: {local_user_handle}, {remote_video_track_handle}, {stats_ptr}")
-        remote_stats = stats_ptr.contents  # RemoteVideoTrackStats
+        remote_stats = stats_ptr.contents.get() if stats_ptr else None
         video_track = self.local_user.get_remote_video_map(remote_video_track_handle)
         self.local_user_observer.on_remote_video_track_statistics(self.local_user, video_track, remote_stats)
 

{agora_python_server_sdk-2.2.1 → agora_python_server_sdk-2.2.2}/agora/rtc/_ctypes_handle/_rtc_connection_observer.py

@@ -44,6 +44,7 @@ ON_STREAM_MESSAGE_ERROR_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE, user_id_
 ON_ENCRYPTION_ERROR_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE, ctypes.c_int)
 ON_UPLOAD_LOG_RESULT_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE, ctypes.c_char_p, ctypes.c_int, ctypes.c_int)
 
+ON_ENCRYPTION_ERROR_CALLBACK = ctypes.CFUNCTYPE(None, AGORA_HANDLE, ctypes.c_int)   
 
 class RTCConnectionObserverInner(ctypes.Structure):
     _fields_ = [
@@ -81,7 +82,8 @@ class RTCConnectionObserverInner(ctypes.Structure):
         ("on_user_account_updated", ON_USER_ACCOUNT_UPDATED_CALLBACK),
         ("on_stream_message_error", ON_STREAM_MESSAGE_ERROR_CALLBACK),
         ("on_encryption_error", ON_ENCRYPTION_ERROR_CALLBACK),
-        ("on_upload_log_result", ON_UPLOAD_LOG_RESULT_CALLBACK)
+        ("on_upload_log_result", ON_UPLOAD_LOG_RESULT_CALLBACK),
+        ("on_encryption_error", ON_ENCRYPTION_ERROR_CALLBACK)
     ]
 
     def __init__(self, conn_observer: IRTCConnectionObserver, connection: 'RTCConnection') -> None:
@@ -118,6 +120,7 @@ class RTCConnectionObserverInner(ctypes.Structure):
         self.on_stream_message_error = ON_STREAM_MESSAGE_ERROR_CALLBACK(self._on_stream_message_error)
         self.on_encryption_error = ON_ENCRYPTION_ERROR_CALLBACK(self._on_encryption_error)
         self.on_upload_log_result = ON_UPLOAD_LOG_RESULT_CALLBACK(self._on_upload_log_result)
+        self.on_encryption_error = ON_ENCRYPTION_ERROR_CALLBACK(self._on_encryption_error)
 
     def _on_connected(self, agora_rtc_conn, conn_info_inner, reason):
         logger.debug(f"ConnCB _on_connected: {agora_rtc_conn}, {conn_info_inner}, {reason}")
@@ -263,3 +266,7 @@ class RTCConnectionObserverInner(ctypes.Structure):
         logger.debug(f"ConnCB _on_upload_log_result: {agora_rtc_conn}, {request_id}, {success}, {reason}")
         _request_id_str = request_id.decode("utf-8") if request_id else ""
         self.conn_observer.on_upload_log_result(self.conn, _request_id_str, success, reason)
+
+    def _on_encryption_error(self, agora_rtc_conn, error_type):
+        logger.debug(f"ConnCB _on_encryption_error: {agora_rtc_conn}, {error_type}")
+        self.conn_observer.on_encryption_error(self.conn, error_type)

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

@@ -145,7 +145,7 @@ class RTCStats:
 
 
 @dataclass(frozen=True, kw_only=True)
-class LocalAudioStats:
+class LocalAudioTrackStats:
     num_channels: int
     sent_sample_rate: int
     sent_bitrate: int
@@ -512,3 +512,10 @@ class LocalAudioDetailedStats:
     typing_noise_detected: int
     ana_statistics: AnaStats
     apm_statistics: AudioProcessingStats
+
+
+@dataclass(kw_only=True)
+class EncryptionConfig:
+    encryption_mode: int
+    encryption_key: str
+    encryption_kdf_salt: bytearray = None

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

@@ -59,6 +59,11 @@ agora_service_create_custom_video_track_encoded = agora_lib.agora_service_create
 agora_service_create_custom_video_track_encoded.restype = AGORA_HANDLE
 agora_service_create_custom_video_track_encoded.argtypes = [AGORA_HANDLE, AGORA_HANDLE, ctypes.POINTER(SenderOptionsInner)]
 
+#for version 2.2.2
+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]
+
 
 class AgoraService:
     def __init__(self) -> None:
@@ -70,6 +75,7 @@ class AgoraService:
     def initialize(self, config: AgoraServiceConfig):
         if self.inited == True:
             return 0
+        
         config.app_id = config.appid.encode('utf-8')
         result = agora_service_initialize(self.service_handle, ctypes.byref(AgoraServiceConfigInner.create(config=config)))
         if result == 0:
@@ -96,12 +102,12 @@ class AgoraService:
         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:
                 log_size = config.log_size
             agora_service_set_log_file(self.service_handle, ctypes.create_string_buffer(config.log_path.encode('utf-8')), log_size)
-
         return result
 
     def release(self):

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

@@ -6,6 +6,7 @@
 # state: int
 # agora_remote_audio_track: RemoteAudioTrack
 """
+from agora.rtc.agora_base import *
 
 
 class IRTCLocalUserObserver():
@@ -25,10 +26,10 @@ class IRTCLocalUserObserver():
     def on_local_audio_track_state_changed(self, agora_local_user, agora_local_audio_track, state, error):
         pass
 
-    def on_local_audio_track_statistics(self, agora_local_user, stats):
+    def on_local_audio_track_statistics(self, agora_local_user, stats:LocalAudioTrackStats):
         pass
 
-    def on_remote_audio_track_statistics(self, agora_local_user, agora_remote_audio_track, stats):
+    def on_remote_audio_track_statistics(self, agora_local_user, agora_remote_audio_track, stats:RemoteAudioTrackStats):
         pass
 
     def on_user_audio_track_subscribed(self, agora_local_user, user_id, agora_remote_audio_track):
@@ -64,7 +65,7 @@ class IRTCLocalUserObserver():
     def on_local_video_track_state_changed(self, agora_local_user, agora_local_video_track, state, error):
         pass
 
-    def on_local_video_track_statistics(self, agora_local_user, agora_local_video_track, stats):
+    def on_local_video_track_statistics(self, agora_local_user, agora_local_video_track, stats:LocalVideoTrackStats):
         pass
 
     def on_user_video_track_subscribed(self, agora_local_user, user_id, info, agora_remote_video_track):
@@ -73,7 +74,7 @@ class IRTCLocalUserObserver():
     def on_user_video_track_state_changed(self, agora_local_user, user_id, agora_remote_video_track, state, reason, elapsed):
         pass
 
-    def on_remote_video_track_statistics(self, agora_local_user, agora_remote_video_track, stats):
+    def on_remote_video_track_statistics(self, agora_local_user, agora_remote_video_track, stats:RemoteVideoTrackStats):
         pass
 
     def on_audio_volume_indication(self, agora_local_user, speakers_list, speaker_number, total_volume):

{agora_python_server_sdk-2.2.1 → agora_python_server_sdk-2.2.2}/agora/rtc/rtc_connection.py

@@ -51,6 +51,12 @@ agora_rtc_conn_renew_token = agora_lib.agora_rtc_conn_renew_token
 agora_rtc_conn_renew_token.restype = AGORA_API_C_INT
 agora_rtc_conn_renew_token.argtypes = [AGORA_HANDLE, ctypes.c_char_p]
 
+#AGORA_API_C_INT agora_rtc_conn_enable_encryption(AGORA_HANDLE agora_rtc_conn, int enabled, const encryption_config* config);
+
+agora_rtc_conn_enable_encryption = agora_lib.agora_rtc_conn_enable_encryption
+agora_rtc_conn_enable_encryption.restype = AGORA_API_C_INT
+agora_rtc_conn_enable_encryption.argtypes = [AGORA_HANDLE, ctypes.c_int, ctypes.POINTER(EncryptionConfigInner)]
+
 
 class RTCConnection:
     def __init__(self, conn_handle, is_low_delay: bool = False) -> None:
@@ -129,6 +135,22 @@ class RTCConnection:
 
     def get_local_user(self):
         return self.local_user
+   
+    def enable_encryption(self, enabled: int, config: EncryptionConfig) -> int:
+        """
+        Enables or disables encryption for the connection.
+
+        Args:
+            enabled (int): 1 to enable encryption, 0 to disable.
+            config (EncryptionConfig): The encryption configuration.
+
+        Returns:
+            int: The result of the operation. 0 if successful, otherwise an error code.
+        Note:
+            This method must be called before self.connect()
+        """
+        inner_config = EncryptionConfigInner.create(config)
+        return agora_rtc_conn_enable_encryption(self.conn_handle, enabled, ctypes.byref(inner_config))
 
     def release(self):
         # release local user map

{agora_python_server_sdk-2.2.1 → agora_python_server_sdk-2.2.2}/agora/rtc/rtc_connection_observer.py

@@ -88,3 +88,5 @@ class IRTCConnectionObserver():
 
     def on_upload_log_result(self, agora_rtc_conn, request_id_str, success, reason):
         pass
+    def on_encryption_error(self, agora_rtc_conn, error_type: int):
+        pass

{agora_python_server_sdk-2.2.1 → agora_python_server_sdk-2.2.2/agora_python_server_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.1
 Name: agora_python_server_sdk
-Version: 2.2.1
+Version: 2.2.2
 Summary: A Python SDK for Agora Server
 Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
 Classifier: Intended Audience :: Developers
@@ -12,12 +12,6 @@ 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.
@@ -56,6 +50,19 @@ python agora_rtc/examples/example_audio_pcm_send.py --appId=xxx --channelId=xxx
 ```
 
 # Change log
+2025.04.10 Release 2.2.2
+-- Additions:
+  - Added push_video_encoded_file.py to support pushing mp4 files and h264 encoded h.264 files. Includes conversion from mp4 file avformat to raw 264 stream in annex B format.
+-- Additions:
+  - Added set_log_file_filter function to set the log filter level.
+-- Additions:
+  - Added support for arm64 version, but currently this version does not support audio label algorithm. Therefore, it is not supported on arm64!
+-- Changes:
+  - Modified localuserstats, local video stats, local audio stats, remote video stats, remote audio stats.
+-- Additions:
+  - Added connection::agora_rtc_conn_enable_encryption.
+-- Additions:
+  - Added connectionObserver::on_encryption_error (but not working for now, need to fix in the next monthly version 4.4.32).
 2025.02.26 Release 2.2.1
 --Update：
   ​- Reduced buffer size from ​180ms​ to ​100ms​ to minimize latency.

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

@@ -7,6 +7,7 @@ import zipfile
 # import urllib
 from urllib import request
 import ssl
+import platform
 ssl._create_default_https_context = ssl._create_unverified_context
 
 
@@ -20,6 +21,9 @@ 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")
+        arch = platform.machine()
+        os_type = platform.system()
+
         '''# 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"
@@ -28,6 +32,10 @@ class CustomInstallCommand(install):
         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_sdk_mac_v4.4.31_23136_FULL_20241223_1245_492039.zip"
+        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"
+      
+
 
 
         if os.path.exists(sdk_dir):
@@ -50,7 +58,7 @@ class CustomInstallCommand(install):
 
 setup(
     name='agora_python_server_sdk',
-    version='2.2.1',
+    version='2.2.2',
     description='A Python SDK for Agora Server',
     long_description=open('README.md').read(),
     long_description_content_type='text/markdown',