agora-python-server-sdk 2.0.0__tar.gz → 2.0.1__tar.gz

{agora_python_server_sdk-2.0.0/agora_python_server_sdk.egg-info → agora_python_server_sdk-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agora_python_server_sdk
-Version: 2.0.0
+Version: 2.0.1
 Summary: A Python SDK for Agora Server
 Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
 Classifier: Intended Audience :: Developers

{agora_python_server_sdk-2.0.0 → agora_python_server_sdk-2.0.1}/agora/rtc/_audio_frame_observer.py

@@ -73,31 +73,31 @@ class AudioFrameObserverInner(ctypes.Structure):
         # self.on_get_ear_monitoring_audio_frame_param = ON_GET_EAR_MONITORING_AUDIO_FRAME_PARAM_CALLBACK(self._on_get_ear_monitoring_audio_frame_param)
 
     def _on_record_audio_frame(self, local_user_handle, channel_id, audio_frame_inner):
-        print("AudioFrameObserverInner _on_record_audio_frame", local_user_handle, channel_id, audio_frame_inner)
+        # print("AudioFrameObserverInner _on_record_audio_frame", local_user_handle, channel_id, audio_frame_inner)
         channel_id_str = channel_id.decode('utf-8')
         frame = audio_frame_inner.contents._to_audio_frame()
         ret = self.observer.on_record_audio_frame(self.local_user, channel_id_str, frame)
         return ret
 
     def _on_playback_audio_frame(self, local_user_handle, channel_id, audio_frame_inner):
-        print("AudioFrameObserverInner _on_playback_audio_frame", local_user_handle, channel_id, audio_frame_inner)
+        # print("AudioFrameObserverInner _on_playback_audio_frame", local_user_handle, channel_id, audio_frame_inner)
         channel_id_str = channel_id.decode('utf-8')
         frame = audio_frame_inner.contents._to_audio_frame()
         ret = self.observer.on_playback_audio_frame(self.local_user, channel_id_str, frame)
         return ret
 
     def _on_mixed_audio_frame(self, local_user_handle, channel_id, audio_frame_inner):
-        print("AudioFrameObserverInner _on_mixed_audio_frame", local_user_handle, channel_id, audio_frame_inner)
+        # print("AudioFrameObserverInner _on_mixed_audio_frame", local_user_handle, channel_id, audio_frame_inner)
         ret = self.observer.on_mixed_audio_frame(self.local_user, audio_frame_inner)
         return ret
 
     def _on_ear_monitoring_audio_frame(self, local_user_handle, audio_frame_inner):
-        print("AudioFrameObserverInner _on_ear_monitoring_audio_frame", local_user_handle, audio_frame_inner)
+        # print("AudioFrameObserverInner _on_ear_monitoring_audio_frame", local_user_handle, audio_frame_inner)
         ret = self.observer.on_ear_monitoring_audio_frame(self.local_user, audio_frame_inner)
         return ret
 
     def _on_playback_audio_frame_before_mixing(self, local_user_handle, channel_id, user_id, audio_frame_inner):
-        print("AudioFrameObserverInner _on_playback_audio_frame_before_mixing", local_user_handle, channel_id, user_id, audio_frame_inner)
+        # print("AudioFrameObserverInner _on_playback_audio_frame_before_mixing", local_user_handle, channel_id, user_id, audio_frame_inner)
         if channel_id is None:
             channel_id_str = ""
         else:
@@ -109,12 +109,12 @@ class AudioFrameObserverInner(ctypes.Structure):
         return ret
     
     def _on_get_audio_frame_position(self, local_user_handle):
-        print("AudioFrameObserverInner _on_get_audio_frame_position", local_user_handle)
+        # print("AudioFrameObserverInner _on_get_audio_frame_position", local_user_handle)
         return 0
         return self.observer.on_get_audio_frame_position(self.local_user)
 
     def _on_get_playback_audio_frame_param(self, local_user_handle):
-        print("AudioFrameObserverInner _on_get_playback_audio_frame_param", local_user_handle)
+        # print("AudioFrameObserverInner _on_get_playback_audio_frame_param", local_user_handle)
         params = AudioParams()
         params.sample_rate = 16000  # 示例值
         params.channels = 1          # 示例值
@@ -124,7 +124,7 @@ class AudioFrameObserverInner(ctypes.Structure):
         return self.observer.on_get_playback_audio_frame_param(self.local_user)
 
     def _on_get_record_audio_frame_param(self, local_user_handle):
-        print("AudioFrameObserverInner _on_get_record_audio_frame_param", local_user_handle)
+        # print("AudioFrameObserverInner _on_get_record_audio_frame_param", local_user_handle)
         params = AudioParams()
         params.sample_rate = 16000  # 示例值
         params.channels = 1          # 示例值
@@ -134,7 +134,7 @@ class AudioFrameObserverInner(ctypes.Structure):
         return self.observer.on_get_record_audio_frame_param(self.local_user)
 
     def _on_get_mixed_audio_frame_param(self, local_user_handle):
-        print("AudioFrameObserverInner _on_get_mixed_audio_frame_param", local_user_handle)
+        # print("AudioFrameObserverInner _on_get_mixed_audio_frame_param", local_user_handle)
         params = AudioParams()
         params.sample_rate = 16000  # 示例值
         params.channels = 1          # 示例值
@@ -144,7 +144,7 @@ class AudioFrameObserverInner(ctypes.Structure):
         return self.observer.on_get_mixed_audio_frame_param(self.local_user)
 
     def _on_get_ear_monitoring_audio_frame_param(self, local_user_handle):
-        print("AudioFrameObserverInner _on_get_ear_monitoring_audio_frame_param", local_user_handle)
+        # print("AudioFrameObserverInner _on_get_ear_monitoring_audio_frame_param", local_user_handle)
         params = AudioParams()
         params.sample_rate = 16000  # 示例值
         params.channels = 1          # 示例值

{agora_python_server_sdk-2.0.0 → agora_python_server_sdk-2.0.1}/agora/rtc/_local_user_observer.py

@@ -1,8 +1,8 @@
 import ctypes
 from .agora_base import *
 from .local_user import *
-from .local_user_observer import *
-from .remote_video_track import RemoteVideoTrack
+from .remote_audio_track import RemoteAudioTrack, RemoteAudioTrackStats
+from .remote_video_track import RemoteVideoTrack, RemoteVideoTrackStats
 uid_t = ctypes.c_uint
 track_id_t = ctypes.c_uint
 
@@ -10,21 +10,6 @@ track_id_t = ctypes.c_uint
 
 
 
-class RemoteAudioTrackStats(ctypes.Structure):
-    _fields_ = [
-        ("uid", ctypes.c_uint),
-        ("quality", ctypes.c_int),
-        ("network_transport_delay", ctypes.c_int),
-        ("jitter_buffer_delay", ctypes.c_int),
-        ("audio_loss_rate", ctypes.c_int),
-        ("num_channels", ctypes.c_int),
-        ("received_sample_rate", ctypes.c_int),
-        ("received_bitrate", ctypes.c_int),
-        ("total_frozen_time", ctypes.c_int),
-        ("frozen_rate", ctypes.c_int),
-        ("received_bytes", ctypes.c_int64)
-    ]
-
 class VideoTrackInfoInner(ctypes.Structure):
     _fields_ = [
         ("is_local", ctypes.c_int),
@@ -51,56 +36,6 @@ class VideoTrackInfoInner(ctypes.Structure):
         track_info.owner_uid = self.owner_uid
         return track_info
 
-    
-
-class LocalVideoTrackStats(ctypes.Structure):
- _fields_ = [
-        ("number_of_streams", ctypes.c_uint64),
-        ("bytes_major_stream", ctypes.c_uint64),
-        ("bytes_minor_stream", ctypes.c_uint64),
-        ("frames_encoded", ctypes.c_uint32),
-        ("ssrc_major_stream", ctypes.c_uint32),
-        ("ssrc_minor_stream", ctypes.c_uint32),
-        ("capture_frame_rate", ctypes.c_int),
-        ("regulated_capture_frame_rate", ctypes.c_int),
-        ("input_frame_rate", ctypes.c_int),
-        ("encode_frame_rate", ctypes.c_int),
-        ("render_frame_rate", ctypes.c_int),
-        ("target_media_bitrate_bps", ctypes.c_int),
-        ("media_bitrate_bps", ctypes.c_int),
-        ("total_bitrate_bps", ctypes.c_int),
-        ("capture_width", ctypes.c_int),
-        ("capture_height", ctypes.c_int),
-        ("regulated_capture_width", ctypes.c_int),
-        ("regulated_capture_height", ctypes.c_int),
-        ("width", ctypes.c_int),
-        ("height", ctypes.c_int),
-        ("encoder_type", ctypes.c_uint32),
-        ("uplink_cost_time_ms", ctypes.c_uint32),
-        ("quality_adapt_indication", ctypes.c_int)
-    ]
-class RemoteVideoTrackStats(ctypes.Structure):
-    _fields_ = [
-        ("uid", ctypes.c_uint),
-        ("delay", ctypes.c_int),
-        ("width", ctypes.c_int),
-        ("height", ctypes.c_int),
-        ("received_bitrate", ctypes.c_int),
-        ("decoder_output_frame_rate", ctypes.c_int),
-        ("renderer_output_frame_rate", ctypes.c_int),
-        ("frame_loss_rate", ctypes.c_int),
-        ("packet_loss_rate", ctypes.c_int),
-        ("rx_stream_type", ctypes.c_int),
-        ("total_frozen_time", ctypes.c_int),
-        ("frozen_rate", ctypes.c_int),
-        ("total_decoded_frames", ctypes.c_uint32),
-        ("av_sync_time_ms", ctypes.c_int),
-        ("downlink_process_time_ms", ctypes.c_uint32),
-        ("frame_render_delay_ms", ctypes.c_uint32),
-        ("totalActiveTime", ctypes.c_uint64),
-        ("publishDuration", ctypes.c_uint64)
-    ]
-
 class AudioVolumeInfo(ctypes.Structure):
     _fields_ = [
         ("user_id", ctypes.c_uint),
@@ -338,7 +273,7 @@ class RTCLocalUserObserverInner(ctypes.Structure):
         self.local_user_observer.on_user_audio_track_subscribed(self.local_user, user_id_str, remote_audio_track)
 
     def _on_remote_audio_track_statistics(self, local_user_handle, remote_audio_track_handle, stats):
-        print("LocalUserCB _on_remote_audio_track_statistics:", local_user_handle, remote_audio_track_handle, stats)
+        # print("LocalUserCB _on_remote_audio_track_statistics:", local_user_handle, remote_audio_track_handle, stats)
         audio_stats = stats.contents #RemoteAudioTrackStats
         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)
@@ -480,10 +415,10 @@ class RTCLocalUserObserverInner(ctypes.Structure):
         self.local_user_observer.on_remote_subscribe_fallback_to_audio_only(self.local_user, user_id_str, is_fallback)
 
     def _on_stream_message(self, local_user_handle, user_id, stream_id, data, size):
-        print("LocalUserCB _on_stream_message:", local_user_handle, user_id, stream_id, data, size)
+        # print("LocalUserCB _on_stream_message:", local_user_handle, user_id, stream_id, data, size)
         user_id_str = user_id.decode('utf-8') if user_id else ""
         bytes_from_c = ctypes.string_at(data, size)  
-        data_byte_array = bytearray(bytes_from_c)     
+        data_byte_array = bytearray(bytes_from_c).decode()     
         #note: do not use date_byte_array.decode()  for the stream msg is binary data, not limited to only text
         self.local_user_observer.on_stream_message(self.local_user, user_id_str, stream_id, data_byte_array, size)
 

{agora_python_server_sdk-2.0.0 → agora_python_server_sdk-2.0.1}/agora/rtc/_video_encoded_frame_observer.py

@@ -53,7 +53,7 @@ class VideoEncodedFrameObserverInner(ctypes.Structure):
         self.on_encoded_video_frame = ON_ENCODED_VIDEO_FRAME(self._on_encoded_video_frame)
     
     def _on_encoded_video_frame(self, agora_video_encoded_frame_observer ,uid, image_buffer, length, video_encoded_frame_info):
-        print("VideoEncodedFrameObserverInnerCB on_encoded_video_frame")
+        # print("VideoEncodedFrameObserverInnerCB on_encoded_video_frame")
         img_buffer = ctypes.string_at(image_buffer, length)
         vefi = video_encoded_frame_info.contents._to_encoded_video_frame_info()
         self.video_encoded_frame_observer.on_encoded_video_frame(agora_video_encoded_frame_observer, uid, img_buffer, length, vefi)

{agora_python_server_sdk-2.0.0 → agora_python_server_sdk-2.0.1}/agora/rtc/_video_frame_observer.py

@@ -63,7 +63,7 @@ class VideoFrameObserverInner(ctypes.Structure):
 
     def _on_frame(self, agora_handle, channel_id, user_id, video_frame:VideoFrameInner):
         vf = video_frame.contents
-        print("VideoFrameObserver _on_frame:", agora_handle, channel_id, user_id, vf.metadata_buffer, vf.metadata_size)
+        # print("VideoFrameObserver _on_frame:", agora_handle, channel_id, user_id, vf.metadata_buffer, vf.metadata_size)
         self.video_frame_observer.on_frame(agora_handle, channel_id.decode() if channel_id else None, user_id.decode(), vf.to_video_frame())
     
 

{agora_python_server_sdk-2.0.0 → agora_python_server_sdk-2.0.1}/agora/rtc/remote_audio_track.py

@@ -1,7 +1,21 @@
 import ctypes
 from .agora_base import *
 
-from ._local_user_observer import RemoteAudioTrackStats
+
+class RemoteAudioTrackStats(ctypes.Structure):
+    _fields_ = [
+        ("uid", ctypes.c_uint),
+        ("quality", ctypes.c_int),
+        ("network_transport_delay", ctypes.c_int),
+        ("jitter_buffer_delay", ctypes.c_int),
+        ("audio_loss_rate", ctypes.c_int),
+        ("num_channels", ctypes.c_int),
+        ("received_sample_rate", ctypes.c_int),
+        ("received_bitrate", ctypes.c_int),
+        ("total_frozen_time", ctypes.c_int),
+        ("frozen_rate", ctypes.c_int),
+        ("received_bytes", ctypes.c_int64)
+    ]
 
 agora_remote_audio_track_get_statistics = agora_lib.agora_remote_audio_track_get_statistics
 agora_remote_audio_track_get_statistics.restype = ctypes.POINTER(RemoteAudioTrackStats)

{agora_python_server_sdk-2.0.0 → agora_python_server_sdk-2.0.1/agora_python_server_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agora_python_server_sdk
-Version: 2.0.0
+Version: 2.0.1
 Summary: A Python SDK for Agora Server
 Home-page: https://github.com/AgoraIO-Extensions/Agora-Python-Server-SDK
 Classifier: Intended Audience :: Developers

{agora_python_server_sdk-2.0.0 → agora_python_server_sdk-2.0.1}/agora_python_server_sdk.egg-info/SOURCES.txt

@@ -31,4 +31,9 @@ agora/rtc/video_frame_sender.py
 agora_python_server_sdk.egg-info/PKG-INFO
 agora_python_server_sdk.egg-info/SOURCES.txt
 agora_python_server_sdk.egg-info/dependency_links.txt
-agora_python_server_sdk.egg-info/top_level.txt
+agora_python_server_sdk.egg-info/top_level.txt
+tests/test_conn.py
+tests/test_conn2.py
+tests/test_conn3.py
+tests/test_conn4.py
+tests/test_conn5.py

{agora_python_server_sdk-2.0.0 → agora_python_server_sdk-2.0.1}/setup.py

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

agora_python_server_sdk-2.0.1/tests/test_conn.py

@@ -0,0 +1,30 @@
+import pytest
+import asyncio
+from unittest.mock import patch
+
+class TestRTCConnection:
+    @pytest.mark.asyncio
+    async def test_connect_with_correct_uid(self):
+        # 创建模拟的 RTCConnection 对象
+        with patch('your_module.RTCConnection') as mock_rtc_connection:
+            # 配置模拟对象的行为
+            mock_rtc_connection.return_value.connect.return_value = 0  # 假设连接成功
+            mock_rtc_connection.return_value.register_observer.return_value = 0
+
+            # 创建测试用的 Observer
+            class TestObserver(IRTCConnectionObserver):
+                def __init__(self):
+                    self.local_user_id = None
+
+                def on_connected(self, agora_rtc_conn, conn_info, reason):
+                    self.local_user_id = conn_info.local_user_id
+
+            test_observer = TestObserver()
+
+            # 创建 RTCConnection 实例并调用 connect
+            rtc_conn = mock_rtc_connection()
+            rtc_conn.register_observer(test_observer)
+            await rtc_conn.connect('token', 'channel_id', 'my_uid')
+
+            # 断言 local_user_id
+            assert test_observer.local_user_id == 'my_uid'

agora_python_server_sdk-2.0.1/tests/test_conn2.py

@@ -0,0 +1,73 @@
+import asyncio  
+import pytest  
+
+import os
+import sys
+
+script_dir = os.path.dirname(os.path.abspath(__file__))
+sdk_dir = os.path.dirname(script_dir)
+# sdk_dir = os.path.dirname(os.path.dirname(script_dir))
+if sdk_dir not in sys.path:
+    sys.path.insert(0, sdk_dir)
+
+import time
+import os
+import sys
+import datetime
+from agora.rtc.agora_service import AgoraServiceConfig, AgoraService, AudioSubscriptionOptions, RTCConnConfig
+from agora.rtc.rtc_connection_observer import IRTCConnectionObserver
+from agora.rtc.rtc_connection import RTCConnection
+from agora.rtc.agora_base import *
+
+class MockObserver(IRTCConnectionObserver):  
+    def __init__(self):  
+        self.event = asyncio.Event()  
+        self.conn_info = None  
+  
+    def on_connected(self, rtc_conn, conn_info, reason):  
+        print("on_connected")
+        self.conn_info = conn_info  
+        self.event.set()  # 设置事件，表示回调已被调用  
+
+# 使用 pytest-asyncio 的异步测试  
+@pytest.mark.asyncio  
+async def test_connection_connect_with_observer():  
+        # 创建RTCConnection实例  
+        #---------------1. Init SDK
+        config = AgoraServiceConfig()
+        config.appid = "aab8b8f5a8cd4469a63042fcfafe7063"
+        config.log_path = "/Users/dingyusong/Downloads/tests_log/agorasdk.log"
+
+        agora_service = AgoraService()
+        agora_service.initialize(config)
+
+        #---------------2. Create Connection
+        con_config = RTCConnConfig(
+            client_role_type=ClientRoleType.CLIENT_ROLE_BROADCASTER,
+            channel_profile=ChannelProfileType.CHANNEL_PROFILE_LIVE_BROADCASTING,
+        )
+
+        connection = agora_service.create_rtc_connection(con_config)
+  
+        # 创建MockObserver实例  
+        observer = MockObserver()  
+  
+        # 注册观察者  
+        connection.register_observer(observer)  
+        print("before connect")
+        # 调用connect方法  
+        sample_token = "aab8b8f5a8cd4469a63042fcfafe7063"  
+        channel_id = "dummy_channel"  
+        uid = "1"  
+        connection.connect(sample_token, channel_id, uid)  
+        
+        print("after connect")
+        # 等待事件被设置，表示 on_connected 已被调用  
+        await observer.event.wait()  
+
+        # 验证 conn_info 是否被正确设置  
+        assert observer.conn_info is not None  
+        assert observer.conn_info.local_user_id == "dummy_uid"  
+  
+# if __name__ == '__main__':  
+#     test_connection_connect_with_observer()

agora_python_server_sdk-2.0.1/tests/test_conn3.py

@@ -0,0 +1,95 @@
+import asyncio  
+import pytest  
+
+import os
+import sys
+
+script_dir = os.path.dirname(os.path.abspath(__file__))
+sdk_dir = os.path.dirname(script_dir)
+# sdk_dir = os.path.dirname(os.path.dirname(script_dir))
+if sdk_dir not in sys.path:
+    sys.path.insert(0, sdk_dir)
+
+import time
+import os
+import sys
+import datetime
+from agora.rtc.agora_service import AgoraServiceConfig, AgoraService, AudioSubscriptionOptions, RTCConnConfig
+from agora.rtc.rtc_connection_observer import IRTCConnectionObserver
+from agora.rtc.rtc_connection import RTCConnection
+from agora.rtc.agora_base import *
+
+# class MockObserver(IRTCConnectionObserver):  
+#     def __init__(self):  
+#         self.event = asyncio.Event()  
+#         self.conn_info = None  
+  
+#     def on_connected(self, rtc_conn, conn_info, reason):  
+#         print("on_connected")
+#         self.conn_info = conn_info  
+#         self.event.set()  # 设置事件，表示回调已被调用  
+import pytest
+from unittest.mock import MagicMock
+import threading
+import time
+
+# 假设RTCConnection和IRTCConnectionObserver的定义在my_module.py中
+# from my_module import RTCConnection, IRTCConnectionObserver
+
+class MockObserver(IRTCConnectionObserver):
+    def __init__(self):
+        self.connected_info = None
+        self.event = threading.Event()
+
+    def on_connected(self, agora_rtc_conn, conn_info, reason):
+        print("Observer: on_connected called")
+        self.connected_info = conn_info
+        self.event.set()  # 触发事件，表示已连接
+        print(f"Observer: Connected with local_user_id: {conn_info.local_user_id}")
+
+# 测试用例
+def test_on_connected_called_with_correct_user_id():
+    print("Test: Starting test_on_connected_called_with_correct_user_id")
+    # 创建一个RTCConnection实例
+    #---------------1. Init SDK
+    config = AgoraServiceConfig()
+    config.appid = "aab8b8f5a8cd4469a63042fcfafe7063"
+    config.log_path = "/Users/dingyusong/Downloads/tests_log/agorasdk.log"
+
+    agora_service = AgoraService()
+    agora_service.initialize(config)
+
+    #---------------2. Create Connection
+    con_config = RTCConnConfig(
+        client_role_type=ClientRoleType.CLIENT_ROLE_BROADCASTER,
+        channel_profile=ChannelProfileType.CHANNEL_PROFILE_LIVE_BROADCASTING,
+    )
+
+    connection = agora_service.create_rtc_connection(con_config)
+    
+    # 创建一个具体的观察者实例
+    observer = MockObserver()
+    
+    # 注册观察者
+    connection.register_observer(observer)
+    
+    print("before connect")
+    # 调用connect方法  
+    sample_token = "aab8b8f5a8cd4469a63042fcfafe7063"  
+    channel_id = "dummy_channel"  
+    uid = "1"  
+    connection.connect(sample_token, channel_id, uid)  
+    
+    print("after connect")
+
+    # 等待 on_connected 被调用
+    observer.event.wait(timeout=5)  # 等待最多5秒
+
+    print("after connect2222")
+    # 验证 local_user_id 是否与 uid 一致
+    assert observer.connected_info is not None, "on_connected should have been called"
+    assert observer.connected_info.local_user_id == uid, "local_user_id should match the provided uid"
+
+# 运行测试
+# if __name__ == "__main__":
+#     pytest.main()

agora_python_server_sdk-2.0.1/tests/test_conn4.py

@@ -0,0 +1,90 @@
+import asyncio  
+import pytest  
+
+import os
+import sys
+
+script_dir = os.path.dirname(os.path.abspath(__file__))
+sdk_dir = os.path.dirname(script_dir)
+# sdk_dir = os.path.dirname(os.path.dirname(script_dir))
+if sdk_dir not in sys.path:
+    sys.path.insert(0, sdk_dir)
+
+import time
+import os
+import sys
+import datetime
+import threading
+
+from agora.rtc.agora_service import AgoraServiceConfig, AgoraService, AudioSubscriptionOptions, RTCConnConfig
+from agora.rtc.rtc_connection_observer import IRTCConnectionObserver
+from agora.rtc.rtc_connection import RTCConnection
+from agora.rtc.agora_base import *
+
+
+class MockObserver(IRTCConnectionObserver):
+    def __init__(self):
+        self.connected_info = None
+        self.event = asyncio.Event() 
+
+    def on_connected(self, agora_rtc_conn, conn_info, reason):
+        print("Observer: on_connected called")
+        self.connected_info = conn_info
+        self.event.set()  # 触发事件，表示已连接
+        print(f"Observer: Connected with local_user_id: {conn_info.local_user_id}")
+        print("Observer: thread id", threading.get_ident())
+
+# 测试用例
+@pytest.mark.asyncio
+async def test_on_connected_called_with_correct_user_id():
+    print("Test: Starting test_on_connected_called_with_correct_user_id")
+    # 创建一个RTCConnection实例
+    #---------------1. Init SDK
+    config = AgoraServiceConfig()
+    config.appid = "aab8b8f5a8cd4469a63042fcfafe7063"
+    config.log_path = "/Users/dingyusong/Downloads/tests_log/agorasdk.log"
+
+    agora_service = AgoraService()
+    agora_service.initialize(config)
+
+    #---------------2. Create Connection
+    con_config = RTCConnConfig(
+        client_role_type=ClientRoleType.CLIENT_ROLE_BROADCASTER,
+        channel_profile=ChannelProfileType.CHANNEL_PROFILE_LIVE_BROADCASTING,
+    )
+
+    connection = agora_service.create_rtc_connection(con_config)
+    
+    # 创建一个具体的观察者实例
+    observer = MockObserver()
+    
+    # 注册观察者
+    connection.register_observer(observer)
+    
+    print("before connect")
+    # 调用connect方法  
+    sample_token = "aab8b8f5a8cd4469a63042fcfafe7063"  
+    channel_id = "dummy_channel"  
+    uid = "1"  
+    connection.connect(sample_token, channel_id, uid)  
+    print("connect: thread id", threading.get_ident())
+    print("after connect")
+
+    # 等待 on_connected 被调用
+    # observer.event.wait()  # 等待最多5秒
+    await observer.event.wait()  # 等待事件被设置
+    print("after connect2222")
+
+    # try:
+    #     await asyncio.wait_for(observer.event.wait(), timeout=5)
+    # except asyncio.TimeoutError:
+    #     assert False, "on_connected was not called within the timeout period"
+
+    print("after connect3333")
+    # 验证 local_user_id 是否与 uid 一致
+    assert observer.connected_info is not None, "on_connected should have been called"
+    assert observer.connected_info.local_user_id == uid, "local_user_id should match the provided uid"
+
+# 运行测试
+# if __name__ == "__main__":
+#     pytest.main()

agora_python_server_sdk-2.0.1/tests/test_conn5.py

@@ -0,0 +1,68 @@
+import asyncio  
+import pytest  
+import os
+import sys
+
+script_dir = os.path.dirname(os.path.abspath(__file__))
+sdk_dir = os.path.dirname(script_dir)
+if sdk_dir not in sys.path:
+    sys.path.insert(0, sdk_dir)
+
+from agora.rtc.agora_service import AgoraServiceConfig, AgoraService, RTCConnConfig
+from agora.rtc.rtc_connection_observer import IRTCConnectionObserver
+from agora.rtc.agora_base import *
+
+
+class MockObserver(IRTCConnectionObserver):
+    def __init__(self):
+        self.connected_info = None
+        self.event = asyncio.Event() 
+
+    def on_connected(self, agora_rtc_conn, conn_info, reason):
+        print("Observer: on_connected called")
+        self.connected_info = conn_info
+        self.event.set()  # 触发事件，表示已连接
+        print(f"Observer: Connected with local_user_id: {conn_info.local_user_id}")
+
+# 测试用例
+@pytest.mark.asyncio
+async def test_on_connected_called_with_correct_user_id():
+    print("Test: Starting test_on_connected_called_with_correct_user_id")
+    # 创建一个RTCConnection实例
+    #---------------1. Init SDK
+    config = AgoraServiceConfig()
+    config.appid = "aab8"
+    config.log_path = "/Users/dd/Downloads/tests_log/agorasdk.log"
+
+    agora_service = AgoraService()
+    agora_service.initialize(config)
+
+    #---------------2. Create Connection
+    con_config = RTCConnConfig(
+        client_role_type=ClientRoleType.CLIENT_ROLE_BROADCASTER,
+        channel_profile=ChannelProfileType.CHANNEL_PROFILE_LIVE_BROADCASTING,
+    )
+
+    connection = agora_service.create_rtc_connection(con_config)
+    
+    # 创建一个具体的观察者实例
+    observer = MockObserver()
+    
+    # 注册观察者
+    connection.register_observer(observer)
+    
+    print("before connect")
+    # 调用connect方法  
+    sample_token = "aab8"  
+    channel_id = "dummy_channel"  
+    uid = "1"  
+    connection.connect(sample_token, channel_id, uid)  
+    
+    print("after connect")
+
+    await observer.event.wait() 
+
+    print("after connect3333")
+    assert observer.connected_info is not None, "on_connected should have been called"
+    assert observer.connected_info.local_user_id == uid, "local_user_id should match the provided uid"
+