# IAgoraService 类 (/zh-CN/api-reference/local-server-recording/cpp/iagoraservice.cpp)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## createAgoraService [#createagoraservice]
```cpp
AGORA_API agora::base::IAgoraService* AGORA_CALL createAgoraService();
```
创建一个 [`IAgoraService`](/zh-CN/api-reference/local-server-recording/cpp/iagoraservice.cpp) 对象并返回指针。
#### 返回值 [#返回值]
- 方法调用成功,返回 [`IAgoraService`](/zh-CN/api-reference/local-server-recording/cpp/iagoraservice.cpp) 对象指针。
- 方法调用失败,返回空指针。
## initialize [#initialize]
```cpp
virtual int initialize(const AgoraServiceConfiguration& config) = 0;
```
初始化 [`IAgoraService`](/zh-CN/api-reference/local-server-recording/cpp/iagoraservice.cpp) 对象。
#### 参数 [#参数]
| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `config` | `const AgoraServiceConfiguration&` | 初始化配置。详见 [`AgoraServiceConfiguration`](/zh-CN/api-reference/local-server-recording/cpp/struct#agoraserviceconfiguration)。 |
#### 返回值 [#返回值-1]
- 0:方法调用成功。
- < 0:方法调用失败。
## release [#release]
```cpp
virtual int release() = 0;
```
释放 [`IAgoraService`](/zh-CN/api-reference/local-server-recording/cpp/iagoraservice.cpp) 对象。
#### 返回值 [#返回值-2]
- 0:方法调用成功。
- < 0:方法调用失败。
## setLogFile [#setlogfile]
```cpp
virtual int setLogFile(const char* filePath, unsigned int fileSize, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
```
设置 SDK 日志文件的路径和大小。
SDK 运行期间会将所有日志数据记录在两个日志文件中,每个文件的默认大小为 512 KB。如果将 `fileSize` 设置为 1024 KB,日志文件的总大小为 2 MB。当日志文件总大小超过设置值时,新日志将覆盖旧日志。
:::warning[注意]
为确保日志输出完整,请在调用 [`initialize`](/zh-CN/api-reference/local-server-recording/cpp/iagoraservice.cpp#initialize) 后立即调用此方法。
:::
#### 参数 [#参数-1]
| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `filePath` | `const char*` | 日志文件路径指针。请确保该路径所在目录存在且可写。 |
| `fileSize` | `unsigned int` | 每个日志文件的大小(字节)。 |
#### 返回值 [#返回值-3]
- 0:方法调用成功。
- < 0:方法调用失败。
## setLogFilter [#setlogfilter]
```cpp
virtual int setLogFilter(unsigned int filters, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
```
设置 SDK 日志输出过滤器。
日志级别的顺序为 `OFF`、`CRITICAL`、`ERROR`、`WARNING`、`INFO` 和 `DEBUG`。
你可以选择一个日志级别,SDK 会输出该级别及以上级别的日志。例如,如果将日志级别设置为 `WARNING`,则会输出 `CRITICAL`、`ERROR` 和 `WARNING` 级别的日志。
#### 参数 [#参数-2]
| 参数 | 数据类型 | 描述 |
| --- | --- | --- |
| `filters` | `unsigned int` | [iagoraservice-cpp-html-2-1-2 details](#table-slot-iagoraservice-cpp-html-2-1-2) |
**iagoraservice-cpp-html-2-1-2 details**
日志输出过滤器。
- `LOG_LEVEL_NONE (0x0000)`:不输出任何日志文件。
- `LOG_LEVEL_INFO (0x0001)`:(推荐)输出 `INFO` 级别的日志文件。
- `LOG_LEVEL_WARN (0x0002)`:输出 `WARN` 级别的日志文件。
- `LOG_LEVEL_ERROR (0x0004)`:输出 `ERROR` 级别的日志文件。
- `LOG_LEVEL_FATAL (0x0008)`:输出 `FATAL` 级别的日志文件。
#### 返回值 [#返回值-4]
- 0:方法调用成功。
- < 0:方法调用失败。
## getAgoraParameter [#getagoraparameter]
```cpp
virtual agora_refptr getAgoraParameter() = 0;
```
获取 `IAgoraParameter` 对象。
#### 返回值 [#返回值-5]
- 方法调用成功,返回 `IAgoraParameter` 对象。
- 方法调用失败,返回空指针。