# AgoraService 类 (/zh-CN/api-reference/rtc-server-sdk/python-api/agoraservice.python)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
`AgoraService` 类。作为 SDK 的入口类,你可以通过 `AgoraService` 类创建媒体轨道和连接。
## initialize [#initialize]
```python
def initialize(self, config: AgoraServiceConfig)
```
初始化 `AgoraService` 对象。
#### 参数 [#参数]
| 参数 | 描述 |
|---------|----------------------------------------------------------------------|
| `config` | 初始化配置。详见 [`AgoraServiceConfig`](/zh-CN/api-reference/rtc-server-sdk/python-api/apidatatype.python#agoraserviceconfig)。 |
#### 返回值 [#返回值]
- 0: 方法调用成功。
- < 0: 方法调用失败。
## release [#release]
```python
def release(self)
```
释放 `AgoraService` 对象。
:::warning[注意]
`release` 需要在非回调内的子线程调用,避免在回调中执行。
:::
## create_rtc_connection [#create_rtc_connection]
```python
def create_rtc_connection(self, con_config: RTCConnConfig)
```
创建一个 RTC 连接对象。
:::warning[注意]
如需创建多个 Connection,声网推荐使用多进程的方式,以避免内存泄露等问题。
:::
#### 参数 [#参数-1]
| 参数 | 描述 |
|---------------|----------------------------------------------------------------------|
| `con_config` | RTC 连接配置。详见 [`RTCConnConfig`](/zh-CN/api-reference/rtc-server-sdk/python-api/apidatatype.python#rtcconnconfig)。 |
#### 返回值 [#返回值-1]
- `RTCConnection` 对象: 方法调用成功。
- `None`: 方法调用失败。
## create_custom_audio_track_pcm [#create_custom_audio_track_pcm]
```python
def create_custom_audio_track_pcm(self, audio_pcm_data_sender: AudioPcmDataSender)
```
创建本地音频轨道对象,包含一个发送 PCM 音频数据的音频源。该轨道对象可用于发送来 PCM 格式的音频数据。
#### 参数 [#参数-2]
| 参数 | 描述 |
|-----------------------|----------------------------------------------------------------------|
| `audio_pcm_data_sender` | PCM 格式的音频数据源。详见 [`AudioPcmDataSender`](/zh-CN/api-reference/rtc-server-sdk/python-api/audiopcmdatasender.python#audiopcmdatasender)。 |
#### 返回值 [#返回值-2]
- `LocalAudioTrack` 对象: 方法调用成功。
- `None`: 方法调用失败。
## create_custom_audio_track_encoded [#create_custom_audio_track_encoded]
```python
def create_custom_audio_track_encoded(self, audio_encoded_frame_sender: AudioEncodedFrameSender, mix_mode: int)
```
创建本地音频轨道对象,包含一个发送编码音频数据的音频源。该轨道对象可用于发送已编码的音频数据,例如 Opus 格式的编码数据。
#### 参数 [#参数-3]
| 参数 | 描述 |
| --- | --- |
| `audio_encoded_frame_sender` | 发送编码音频数据的音频源。详见 [`AudioEncodedFrameSender`](/zh-CN/api-reference/rtc-server-sdk/python-api/audioencodedframesender.python#audioencodedframesender)。 |
| `mix_mode` | [agoraservice-python-html-0-2-1 details](#table-slot-agoraservice-python-html-0-2-1) |
**agoraservice-python-html-0-2-1 details**
已编码的音频在频道中的混音模式。
- `0`:对频道中的所有音频轨道进行混音。
- `1`:不进行混音。
#### 返回值 [#返回值-3]
- `LocalAudioTrack` 对象: 方法调用成功。
- `None`: 方法调用失败。
## create_media_node_factory [#create_media_node_factory]
```python
def create_media_node_factory(self)
```
创建一个媒体节点工厂对象。
#### 返回值 [#返回值-4]
- `MediaNodeFactory` 对象: 方法调用成功。
- `None`: 方法调用失败。
## create_custom_video_track_frame [#create_custom_video_track_frame]
```python
def create_custom_video_track_frame(self, video_frame_sender: VideoFrameSender)
```
创建本地视频轨道对象,包含一个发送 YUV 格式视频数据的视频源。该轨道对象可用于发送 YUV 格式视频数据。
#### 参数 [#参数-4]
| 参数 | 描述 |
|---------------------|----------------------------------------------------------------------|
| `video_frame_sender` | YUV 格式视频源对象。详见 [`VideoFrameSender`](/zh-CN/api-reference/rtc-server-sdk/python-api/videoframesender.python#videoframesender)。 |
#### 返回值 [#返回值-5]
- `LocalVideoTrack` 对象: 方法调用成功。
- `None`: 方法调用失败。
## create_custom_video_track_encoded [#create_custom_video_track_encoded]
```python
def create_custom_video_track_encoded(self, video_encoded_frame_sender: VideoEncodedImageSender, options: SenderOptions)
```
创建本地视频轨道对象,包含一个发送编码视频数据的视频源。该轨道对象可用于发送已编码的视频数据,例如 H.264 或 VP8 格式的编码数据。
#### 参数 [#参数-5]
| 参数 | 描述 |
|----------------------------|----------------------------------------------------------------------|
| `video_encoded_frame_sender` | 发送编码视频数据的视频源。详见 [`VideoEncodedImageSender`](/zh-CN/api-reference/rtc-server-sdk/python-api/videoencodedimagesender.python)。 |
| `options` | 视频轨道设置。详见 [`SenderOptions`](/zh-CN/api-reference/rtc-server-sdk/python-api/apidatatype.python#senderoptions)。 |
#### 返回值 [#返回值-6]
- `LocalVideoTrack` 对象: 方法调用成功。
- `None`: 方法调用失败。
## set_log_file [#set_log_file]
```python
def set_log_file(self, log_path: str, log_size: int = 512 * 1024)
```
设置 SDK 日志文件的路径和大小。
SDK 默认生成 5 个 SDK 日志文件和 5 个 API 调用日志文件,规则如下:
- SDK 日志文件的名称分别为:`agorasdk.log`、`agorasdk.1.log`、`agorasdk.2.log`、`agorasdk.3.log`、`agorasdk.4.log`。
- API 调用日志文件的名称分别为:`agoraapi.log`、`agoraapi.1.log`、`agoraapi.2.log`、`agoraapi.3.log`、`agoraapi.4.log`。
- 每个 SDK 日志文件的默认大小为 1,024 KB;API 调用日志文件的默认大小为 2,048 KB。日志文件均为 UTF-8 编码。
- 最新的日志永远写在 `agorasdk.log` 和 `agoraapi.log` 中。
当 `agorasdk.log` 写满后,SDK 会按照以下顺序对日志文件进行操作:
- 删除 `agorasdk.4.log` 文件(如有)。
- 将 `agorasdk.3.log` 重命名为 `agorasdk.4.log`。
- 将 `agorasdk.2.log` 重命名为 `agorasdk.3.log`。
- 将 `agorasdk.1.log` 重命名为 `agorasdk.2.log`。
- 新建 `agorasdk.log` 文件。
`agoraapi.log` 文件的覆盖规则与 `agorasdk.log` 相同。
#### 参数 [#参数-6]
| 参数 | 描述 |
|--------------|--------------------------------------------------------------------------------------------------|
| `log_path` | 日志文件的完整路径。该日志文件为 UTF-8 编码。 |
| `log_size` | 单个 `agorasdk.log` 日志文件的大小,单位为 KB,取值范围为 [128,20480],默认值为 1,024 KB。 如果你将 `file_size` 设为小于 128 KB,SDK 会自动调整到 128 KB;如果你将 `file_size` 设为大于 20,480 KB,SDK 会自动调整到 20,480 KB。 |
#### 返回值 [#返回值-7]
- 0: 方法调用成功。
- < 0: 方法调用失败。