# AgoraService 类 (/zh-CN/api-reference/local-server-recording/java/agoraservice.java) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 提供声网服务初始化和管理的核心功能。 该类是使用声网录制功能的主要入口。 ## AgoraService [#agoraservice] ```java public AgoraService() ``` 构造一个 [`AgoraService`](/zh-CN/api-reference/local-server-recording/java/agoraservice.java) 实例并初始化原生组件。 一次只能初始化一个 [`AgoraService`](/zh-CN/api-reference/local-server-recording/java/agoraservice.java) 实例。 ## release [#release] ```java public int release() ``` 释放 [`AgoraService`](/zh-CN/api-reference/local-server-recording/java/agoraservice.java) 对象及其相关资源。 调用该方法后,该实例将失效,无法再使用。 #### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。 ## initialize [#initialize] ```java public int initialize(AgoraServiceConfiguration config) ``` 使用指定的配置初始化 [`AgoraService`](/zh-CN/api-reference/local-server-recording/java/agoraservice.java) 对象。 #### 参数 [#参数] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `config` | `AgoraServiceConfiguration` | 初始化参数配置对象。详见 [`AgoraServiceConfiguration`](/zh-CN/api-reference/local-server-recording/java/struct#agoraserviceconfiguration)。 | #### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。 - `ERR_INVALID_ARGUMENT`:在 Android 平台未提供 [`AgoraServiceConfiguration`](/zh-CN/api-reference/local-server-recording/java/struct#agoraserviceconfiguration) 中的 context 时返回该错误。 - `ERR_INIT_NET_ENGINE`:无法初始化网络引擎时返回该错误。在 Windows 平台,该错误通常是由于本地端口连接被防火墙阻止导致的。尝试关闭并重新打开防火墙以解决此问题。 ## createMediaRtcRecorder [#createmediartcrecorder] ```java public AgoraMediaRtcRecorder createMediaRtcRecorder() ``` 创建一个新的 [`AgoraMediaRtcRecorder`](/zh-CN/api-reference/local-server-recording/java/agoramediartcrecorder.java) 实例。 #### 返回值 [#返回值-2] 方法调用成功,返回 [`AgoraMediaRtcRecorder`](/zh-CN/api-reference/local-server-recording/java/agoramediartcrecorder.java) 实例。 ## getAgoraParameter [#getagoraparameter] ```java public AgoraParameter getAgoraParameter() ``` 创建并返回用于参数管理的 `AgoraParameter` 对象。 #### 返回值 [#返回值-3] 方法调用成功,返回 `AgoraParameter` 实例。 方法调用失败,返回 `null`。 ## getSdkVersion [#getsdkversion] ```java public static String getSdkVersion() ``` 获取 SDK 的版本信息。 #### 返回值 [#返回值-4] 方法调用成功时,返回 SDK 的版本信息。 方法调用失败,返回空字符串。 ## setLogFile [#setlogfile] ```java public int setLogFile(String filePath, int fileSize) ``` 设置 SDK 日志文件的路径和大小。 SDK 在运行期间会将所有日志数据记录在两个日志文件中,每个文件的默认大小为 512 KB。如果将 `fileSize` 设置为 1024 KB,SDK 会输出最大为 2 MB 的日志文件。如果日志文件的总大小超过设置值,新的日志内容将覆盖旧的内容。 :::warning[注意] 为确保日志输出的完整性,请在调用 [`initialize`](/zh-CN/api-reference/local-server-recording/java/agoraservice.java#initialize) 后立即调用此方法。 ::: #### 参数 [#参数-1] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `filePath` | `String` | 日志文件的路径。请确保该路径对应的目录具有写权限。 | | `fileSize` | `int` | 每个日志文件的大小(字节)。例如,设置为 1024 * 1024 表示每个日志文件大小为 1 MB。 | #### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败。 ## setLogLevel [#setloglevel] ```java public int setLogLevel(Constants.LogLevel level) ``` 设置 SDK 的日志输出等级。 你可以选择一个日志等级,SDK 会输出该等级及以上等级的日志。例如,将日志等级设置为 `WARNING` 时,SDK 会输出 `CRITICAL`、`ERROR` 和 `WARNING` 等级的日志。 #### 参数 [#参数-2] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `level` | `Constants.LogLevel` | [agoraservice-java-html-2-1-2 details](#table-slot-agoraservice-java-html-2-1-2) | **agoraservice-java-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 等级的日志文件。详见 `Constants.LogLevel`。 #### 返回值 [#返回值-6] - 0:方法调用成功。 - < 0:方法调用失败。 ## setGlobalLocalAccessPoint [#setgloballocalaccesspoint] ```java public int setGlobalLocalAccessPoint(LocalAccessPointConfiguration config) ``` 在本地 AP 模式下设置全局本地接入点地址。 你必须在调用 [`initialize`](/zh-CN/api-reference/local-server-recording/java/agoraservice.java#initialize) 方法之前调用该方法。 #### 参数 [#参数-3] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `config` | `LocalAccessPointConfiguration` | 本地接入点配置对象,详见 [`LocalAccessPointConfiguration`](/zh-CN/api-reference/local-server-recording/java/struct#localaccesspointconfiguration)。 | #### 返回值 [#返回值-7] - 0:方法调用成功。 - < 0:方法调用失败。