agora-python-server-sdk 2.4.6__tar.gz → 2.4.7__tar.gz

{agora_python_server_sdk-2.4.6/agora_python_server_sdk.egg-info → agora_python_server_sdk-2.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agora_python_server_sdk
-Version: 2.4.6
+Version: 2.4.7
 Summary: A Python SDK for Agora Server
 Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
 Classifier: Intended Audience :: Developers
@@ -63,7 +63,27 @@ 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
+# Release Note
+
+## 2026.06.24 Release Version 2.4.7
+
+- **New Features**:
+  - Added `RTCConnection.get_sid()` and `RTCConnection.set_simulcast_stream()` interfaces for retrieving SID and configuring Simulcast stream capabilities.
+  - In `EncryptionConfig`, added the `datastream_encryption_enabled` option to support data stream encryption.
+
+- **Improvements and Enhancements**:
+  - Improved the Simulcast Stream configuration process to further simplify the usage of `LocalVideoTrack.enable_simulcast_stream()`.
+  - Adjusted audio encoding timestamp behavior: when `capture_time_ms` is not set, the current time will be used by default.
+  - Optimized RTC/RTM binary message processing to enhance raw data passthrough capability.
+  - Enhanced lifecycle management of RTM ctypes callback objects to improve overall stability.
+
+- **Examples and Documentation**:
+  - Updated RTM/RTC example code, adding detailed examples for Simulcast and binary message transmission.
+  - Updated macOS SDK version records.
+
+## 2026.06.01 Release Version 2.4.6
+- **Update**: Updated the RTC SDK to version 174, resolving the issue where two same UIDs could join the same channel.
+
 ## 2026.05.08 Release Version 2.4.5
 - **Update**: Update arm rtc sdk, which can run basic function on arm64 platform, the vad function is not supported yet.
 

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7}/README.md

@@ -48,7 +48,27 @@ 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
+# Release Note
+
+## 2026.06.24 Release Version 2.4.7
+
+- **New Features**:
+  - Added `RTCConnection.get_sid()` and `RTCConnection.set_simulcast_stream()` interfaces for retrieving SID and configuring Simulcast stream capabilities.
+  - In `EncryptionConfig`, added the `datastream_encryption_enabled` option to support data stream encryption.
+
+- **Improvements and Enhancements**:
+  - Improved the Simulcast Stream configuration process to further simplify the usage of `LocalVideoTrack.enable_simulcast_stream()`.
+  - Adjusted audio encoding timestamp behavior: when `capture_time_ms` is not set, the current time will be used by default.
+  - Optimized RTC/RTM binary message processing to enhance raw data passthrough capability.
+  - Enhanced lifecycle management of RTM ctypes callback objects to improve overall stability.
+
+- **Examples and Documentation**:
+  - Updated RTM/RTC example code, adding detailed examples for Simulcast and binary message transmission.
+  - Updated macOS SDK version records.
+
+## 2026.06.01 Release Version 2.4.6
+- **Update**: Updated the RTC SDK to version 174, resolving the issue where two same UIDs could join the same channel.
+
 ## 2026.05.08 Release Version 2.4.5
 - **Update**: Update arm rtc sdk, which can run basic function on arm64 platform, the vad function is not supported yet.
 

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7}/agora/rtc/_ctypes_handle/_ctypes_data.py

@@ -1276,7 +1276,8 @@ class EncryptionConfigInner(ctypes.Structure):
         return EncryptionConfigInner(
             config.encryption_mode,
             encryption_key,
-            encryption_kdf_salt
+            encryption_kdf_salt,
+            config.datastream_encryption_enabled
         )
 
 

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7}/agora/rtc/agora_base.py

@@ -566,7 +566,7 @@ class EncodedAudioFrameInfo:
     samples_per_channel: int = 1024
     send_even_if_empty: int = 1
     number_of_channels: int = 1
-    capture_time_ms: int = 0
+    capture_time_ms: int = -1 #-1 means not set, when push_audio_encoded_data, if capture_time_ms is not set, will use the current time
 
 
 @dataclass(kw_only=True)
@@ -701,6 +701,7 @@ class EncryptionConfig:
     encryption_mode: int
     encryption_key: str
     encryption_kdf_salt: bytearray = None
+    datastream_encryption_enabled: bool = False
 @dataclass(kw_only=True)
 class CapabilityItem:
     id: int

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7}/agora/rtc/local_video_track.py

@@ -53,8 +53,8 @@ class LocalVideoTrack:
         ret = agora_local_video_track_set_video_encoder_config(self.track_handle, ctypes.byref(VideoEncoderConfigurationInner.create(config)))
         return ret
 
-    def enable_simulcast_stream(self, enabled, config):
-        ret = agora_local_video_track_enable_simulcast_stream(self.track_handle, enabled, ctypes.byref(config))
+    def enable_simulcast_stream(self, enabled, config: SimulcastStreamConfig):
+        ret = agora_local_video_track_enable_simulcast_stream(self.track_handle, enabled, ctypes.byref(SimulcastStreamConfigInner.create(config)))
         return ret
 
     # def update_simulcast_stream(self, enabled, config):

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7}/agora/rtc/rtc_connection.py

@@ -87,6 +87,11 @@ agora_local_audio_track_set_total_extra_send_ms = agora_lib.agora_local_audio_tr
 agora_local_audio_track_set_total_extra_send_ms.restype = AGORA_API_C_INT
 agora_local_audio_track_set_total_extra_send_ms.argtypes = [AGORA_HANDLE, ctypes.c_uint64]
 
+#get sid
+agora_rtc_conn_get_sid = agora_lib.agora_rtc_conn_get_sid
+agora_rtc_conn_get_sid.restype = ctypes.c_char_p
+agora_rtc_conn_get_sid.argtypes = [AGORA_HANDLE]
+
 #global variable
 _is_deliver_mute_data_has_set: bool = False
 
@@ -208,11 +213,13 @@ class RTCConnection:
     # send data stream message to connection
     def send_stream_message(self, data) -> int:
         length = len(data)
-        c_data = ctypes.c_char_p(data)
+        #c_data = ctypes.c_char_p(data)
+        arr = (ctypes.c_char * length).from_buffer(data)   # zero copy
+        ptr = ctypes.cast(arr, ctypes.POINTER(ctypes.c_char_p))
         ret = agora_rtc_conn_send_stream_message(
             self.conn_handle,
             self._data_stream_id,
-            c_data,
+            ptr,
             length
         )
         return ret
@@ -631,4 +638,17 @@ class RTCConnection:
         ret = self.local_user._send_intra_request(remote_uid)
         return ret
         pass
+    def set_simulcast_stream(self, enabled: bool, config: SimulcastStreamConfig)->int:
+        ret = -1000
+        if self._video_track:
+            ret = self._video_track.enable_simulcast_stream(enabled, config)
+        return ret
+        pass    
+    def get_sid(self)->str:
+        ret = -1000
+        if self.conn_handle is None:
+            return ""
+        sid = agora_rtc_conn_get_sid(self.conn_handle)
+        return sid.decode() if sid else ""
+        pass
     

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7}/agora/rtm/_ctypes_handle/_ctypes_data.py

@@ -182,12 +182,13 @@ class MessageEventInner(ctypes.Structure):
         ("customType", ctypes.c_char_p)
     ]
     def get(self) -> MessageEvent:
+        message = ctypes.string_at(self.message, self.messageLength) if self.message else b""
         return MessageEvent(
             channel_type=self.channelType,
             message_type=self.messageType,
             channel_name=self.channelName.decode('utf-8') if self.channelName else "",
             channel_topic=self.channelTopic.decode('utf-8') if self.channelTopic else "",
-            message=self.message.decode('utf-8') if self.message else "",
+            message=message,
             message_length=self.messageLength,
             publisher=self.publisher.decode('utf-8') if self.publisher else "",
             custom_type=self.customType.decode('utf-8') if self.customType else "",

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7}/agora/rtm/rtm_client.py

@@ -100,12 +100,13 @@ class RTMClient:
         #register event handler from python to ctypes
         
         config_inner = RtmConfigInner.create(config)
-        c_event_handler = RtmEventHandlerInner(config.event_handler, self)
-        config_inner.eventHandler = ctypes.cast(ctypes.byref(c_event_handler), ctypes.c_void_p)
+        self._event_handler = RtmEventHandlerInner(config.event_handler, self)
+        config_inner.eventHandler = ctypes.cast(ctypes.byref(self._event_handler), ctypes.c_void_p)
         self.client_handle = agora_rtm_client_create(ctypes.byref(config_inner), ctypes.byref(ret))
         print(f"create_rtm_client ret: {ret.value}, client_handle: {self.client_handle}")
         print(f"error reason: {self.get_error_reason(ret.value)}")
         self.is_valid = self.client_handle is not None and ret.value == 0
+        self._config_inner = config_inner 
     def _is_valid(self)->bool:
         return self.is_valid
        
@@ -116,6 +117,8 @@ class RTMClient:
             if ret == 0:
                 self.client_handle = None
                 self.config = None
+                self._event_handler = None    # release 之后再清
+                self._config_inner = None
     def login(self, token: str)->(int, int):
         #convert from str to c_char_p without memory copy
         bytes_data = token.encode('utf-8')
@@ -132,13 +135,17 @@ class RTMClient:
         request_id = ctypes.c_uint64(0)
         ret = agora_rtm_client_renew_token(self.client_handle, token.encode(), ctypes.byref(request_id))
         return ret, int(request_id.value)
-    def publish(self, channel_name: str, message: str, options: PublishOptions) ->(int, uint64_t):
+    def publish(self, channel_name: str, message, options: PublishOptions) ->(int, uint64_t):
         inner_options = PublishOptionsInner.create(options)
         request_id = ctypes.c_uint64(0) 
-        ret = agora_rtm_client_publish(self.client_handle, channel_name.encode(), message.encode(), len(message), ctypes.byref(inner_options), ctypes.byref(request_id))
+        #change msg to c_char_p without memory copy
+        length = len(message)   
+        arr = (ctypes.c_char * length).from_buffer_copy(message)
+        ptr = ctypes.cast(arr, ctypes.c_char_p)
+        ret = agora_rtm_client_publish(self.client_handle, channel_name.encode(), ptr, length, ctypes.byref(inner_options), ctypes.byref(request_id))
         return ret, int(request_id.value)
      
-    def send_channel_message(self, channel_name: str, message: str) ->(int, uint64_t):
+    def send_channel_message(self, channel_name: str, message) ->(int, uint64_t):
         publish_options = PublishOptions(
             channel_type=RtmChannelType.RTM_CHANNEL_TYPE_MESSAGE,
             message_type=RtmMessageType.RTM_MESSAGE_TYPE_BINARY,
@@ -147,7 +154,7 @@ class RTMClient:
         )
         ret, request_id = self.publish(channel_name, message, publish_options)
         return ret, request_id
-    def send_user_message(self, user_id: str, message: str) ->(int, uint64_t):
+    def send_user_message(self, user_id: str, message) ->(int, uint64_t):
         publish_options = PublishOptions(
             channel_type=RtmChannelType.RTM_CHANNEL_TYPE_USER,
             message_type=RtmMessageType.RTM_MESSAGE_TYPE_BINARY,

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7/agora_python_server_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agora_python_server_sdk
-Version: 2.4.6
+Version: 2.4.7
 Summary: A Python SDK for Agora Server
 Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
 Classifier: Intended Audience :: Developers
@@ -63,7 +63,27 @@ 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
+# Release Note
+
+## 2026.06.24 Release Version 2.4.7
+
+- **New Features**:
+  - Added `RTCConnection.get_sid()` and `RTCConnection.set_simulcast_stream()` interfaces for retrieving SID and configuring Simulcast stream capabilities.
+  - In `EncryptionConfig`, added the `datastream_encryption_enabled` option to support data stream encryption.
+
+- **Improvements and Enhancements**:
+  - Improved the Simulcast Stream configuration process to further simplify the usage of `LocalVideoTrack.enable_simulcast_stream()`.
+  - Adjusted audio encoding timestamp behavior: when `capture_time_ms` is not set, the current time will be used by default.
+  - Optimized RTC/RTM binary message processing to enhance raw data passthrough capability.
+  - Enhanced lifecycle management of RTM ctypes callback objects to improve overall stability.
+
+- **Examples and Documentation**:
+  - Updated RTM/RTC example code, adding detailed examples for Simulcast and binary message transmission.
+  - Updated macOS SDK version records.
+
+## 2026.06.01 Release Version 2.4.6
+- **Update**: Updated the RTC SDK to version 174, resolving the issue where two same UIDs could join the same channel.
+
 ## 2026.05.08 Release Version 2.4.5
 - **Update**: Update arm rtc sdk, which can run basic function on arm64 platform, the vad function is not supported yet.
 

{agora_python_server_sdk-2.4.6 → agora_python_server_sdk-2.4.7}/setup.py

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