# 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