# io.agora.rtc.AgoraService类 参考 (/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). AgoraService 类。 AgoraService 是 SDK 的入口类,你可以通过 AgoraService 类创建媒体轨道和连接。 调用 [AgoraService](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service#ae63345707895139d903193cc6cebaa02) 创建 AgoraService 对象。 使用 AgoraServiceConfiguration 配置 AgoraService 对象。 ## 构造及析构函数说明 [#构造及析构函数说明] ### AgoraService() [#agoraservice] io.agora.rtc.AgoraService.AgoraService() 构造函数。 ## 成员函数说明 [#成员函数说明] ### agoraRtcConnCreate() [#agorartcconncreate] native [AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) io.agora.rtc.AgoraService.agoraRtcConnCreate([RtcConnConfig](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-rtc-conn-config) *rtc_conn_config*) 创建一个 [AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) 对象。 连接设置。

返回值

一个 AgoraRtcConn 对象。 ### createCustomAudioTrackEncoded() [#createcustomaudiotrackencoded] native [AgoraLocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track) io.agora.rtc.AgoraService.createCustomAudioTrackEncoded([AgoraAudioEncodedFrameSender](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-audio-encoded-frame-sender) *agora_audio_encoded_frame_sender*, int *mix_mode*) 创建本地音频轨道对象,包含一个发送已编码音频数据的音频源。 该轨道对象可用于发送来已编码的音频数据,例如 Opus 编码格式的音频数据。 发送已编码的音频数据的音频源,详见 [AgoraAudioEncodedFrameSender](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-audio-encoded-frame-sender)。 已编码音频数据的混音模式。

返回值

一个 AgoraLocalAudioTrack 对象。 ### createCustomAudioTrackPcm() [#createcustomaudiotrackpcm] native [AgoraLocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track) io.agora.rtc.AgoraService.createCustomAudioTrackPcm([AgoraAudioPcmDataSender](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-audio-pcm-data-sender) *agora_audio_pcm_data_sender*) 创建本地音频轨道对象,包含一个发送 PCM 音频数据的音频源。 该轨道对象可用于发送来 PCM 格式的音频数据。 发送 PCM 格式音频数据的音频源。

返回值

一个 AgoraLocalAudioTrack 对象。 ### createCustomVideoTrackEncoded() [#createcustomvideotrackencoded] native [AgoraLocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-video-track) io.agora.rtc.AgoraService.createCustomVideoTrackEncoded([AgoraVideoEncodedImageSender](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-video-encoded-image-sender) *agora_video_encoded_image_sender*, [SenderOptions](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-sender-options) *options*) 创建本地视频轨道对象,包含一个发送编码视频数据的视频源。 该轨道对象可用于发送编码的视频数据,例如 H.264 或 VP8 格式的视频数据。 发送编码视频数据的视频源。 视频轨道设置。

返回值

一个 AgoraVideoEncodedImageSender 对象。 ### createCustomVideoTrackFrame() [#createcustomvideotrackframe] native [AgoraLocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-video-track) io.agora.rtc.AgoraService.createCustomVideoTrackFrame([AgoraVideoFrameSender](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-video-frame-sender) *agora_video_frame_sender*) 创建本地视频轨道对象,包含一个发送 YUV 格式视频数据的视频源。 该轨道对象可用于发送 YUV 格式视频数据。 发送 YUV 格式视频数据的视频源。

返回值

一个 AgoraLocalVideoTrack 对象。 ### createLocalAudioTrack() [#createlocalaudiotrack] native [AgoraLocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track) io.agora.rtc.AgoraService.createLocalAudioTrack() 创建本地音频轨道对象。 默认情况下,SDK 是根据选定的音频输入设备,如移动设备的内置麦克风,来创建音频轨道。

返回值

一个 AgoraLocalAudioTrack 对象。 ### createMediaNodeFactory() [#createmedianodefactory] native [AgoraMediaNodeFactory](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-media-node-factory) io.agora.rtc.AgoraService.createMediaNodeFactory() 创建一个媒体节点工厂对象。

返回值

一个 AgoraMediaNodeFactory 对象。 ### destroy() [#destroy] void io.agora.rtc.AgoraService.destroy() 析构函数。 :::info[注解] 该方法需要在非回调内的子线程调用,避免在回调中执行。 ::: ### destroyAudioSessionConfig() [#destroyaudiosessionconfig] native void io.agora.rtc.AgoraService.destroyAudioSessionConfig(AudioSessionConfig *config*) ### getAgoraParameter() [#getagoraparameter] native [AgoraParameter](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-parameter) io.agora.rtc.AgoraService.getAgoraParameter() 获取 SDK 全局的 [AgoraParameter](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-parameter) 对象。 :::info[自从] 4.4.30 ::: 通过该方法获取的 AgoraParameter 对象,设置对 SDK 全局有效。如果仅需对某个 Connection 进行设置,改用 [AgoraRtcConn.getAgoraParameter](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn#a4887841b3c2232730440ad6ca3d74570) 方法。

返回值

- AgoraParameter 对象:方法调用成功。 - null:方法调用失败。 ### getAudioSessionConfig() [#getaudiosessionconfig] native AudioSessionConfig io.agora.rtc.AgoraService.getAudioSessionConfig() 获取音效设置。

返回值

音效的设置。 ### initialize() [#initialize] native int io.agora.rtc.AgoraService.initialize([AgoraServiceConfig](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service-config) *config*) 初始化 AgoraService 对象。 初始化配置。详见 [AgoraServiceConfig](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service-config)。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### setAudioSessionConfig() [#setaudiosessionconfig] native int io.agora.rtc.AgoraService.setAudioSessionConfig(AudioSessionConfig *config*) 自定义音效设置。 音效设置。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### setAudioSessionPreset() [#setaudiosessionpreset] native int io.agora.rtc.AgoraService.setAudioSessionPreset(int *audio_scenario*) 设置预设音效。 预设音效场景。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### setLogFile() [#setlogfile] native int io.agora.rtc.AgoraService.setLogFile(String *file_path*, int *file_size*) 设置 SDK 日志文件的路径和大小。 默认情况下,SDK 会生成 2 个 SDK 日志文件,每个 SDK 日志文件的默认大小为 512 KB。如果你将 file_size 设为 1024 KB, SDK 会最多输出总计 2 MB 的日志文件。如果日志文件的总大小超过所设置的值,旧的日志会被新的日志覆盖。 :::info[注解] 为保证输出日志的完成性,声网建议你在调用 [initialize](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service#a822287e735267b7c8f1c9aee77cbb1c9) 方法后立即调用此方法。 ::: 指向日志文件的指针。请确保指定的目录存在而且可写。 SDK 日志文件的大小(KB)。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### setLogFilter() [#setlogfilter] native int io.agora.rtc.AgoraService.setLogFilter(int *filters*) 设置日志输出等级。 日志级别顺序依次为 OFF、CRITICAL、ERROR、WARNING、INFO 和 DEBUG。 选择一个级别,你就可以看到在该级别之前所有级别的日志信息。 例如,你选择 WARNING 级别,就可以看到在 CRITICAL、ERROR 和 WARNING 级别上的所有日志信息。 日志输出等级: - LOG_LEVEL_NONE (0x0000): 不输出任何日志。 - LOG_LEVEL_INFO (0x0001): (推荐)输出 INFO 级别的日志信息。 - LOG_LEVEL_WARN (0x0002): 输出 WARN 级别的日志信息。 - LOG_LEVEL_ERROR (0x0004): 输出 ERROR 级别的日志信息。 - LOG_LEVEL_FATAL (0x0008): 输出 FATAL 级别的日志信息。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 --- 该类的文档由以下文件生成: - AgoraService.java