# io.agora.rtc.AgoraServiceConfig类 参考 (/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service-config)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="details"></a>

<a id="header-details"></a>

AgoraService 类的全局配置。

在调用 [initialize](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-service#a822287e735267b7c8f1c9aee77cbb1c9) 时设置。

<a id="doc-constructors"></a>

<a id="header-doc-constructors"></a>

## 构造及析构函数说明 [#构造及析构函数说明]

<a id="a9d350f519bdf48060ae96b44bb76389c"></a>

### AgoraServiceConfig() [1/2] [#agoraserviceconfig-12]

<ApiSignature>

io.agora.rtc.AgoraServiceConfig.AgoraServiceConfig()

</ApiSignature>

<a id="a0c10d88204e4facc6fa6d89bca304b96"></a>

### AgoraServiceConfig() [2/2] [#agoraserviceconfig-22]

<ApiSignature>

io.agora.rtc.AgoraServiceConfig.AgoraServiceConfig(int *enableAudioProcessor*, int *enableAudioDevice*, int *enableVideo*, Object *context*, java.lang.String *appId*, int *areaCode*, int *channelProfile*, int *audioScenario*, int *useStringUid*, String *logFilePath*, int *logFileSize*, int *logFilters*, int *domainLimit*)

</ApiSignature>

<a id="doc-func-members"></a>

<a id="header-doc-func-members"></a>

## 成员函数说明 [#成员函数说明]

<a id="a40c2bc10ac76f85365e6d7b38c8e2554"></a>

### getAppId() [#getappid]

<ApiSignature>

String io.agora.rtc.AgoraServiceConfig.getAppId()

</ApiSignature>

<a id="a9ed5b93817feabf0aa4713c06e52d496"></a>

### getAreaCode() [#getareacode]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getAreaCode()

</ApiSignature>

<a id="a93dc51e5d765d2ce2729e04ae44ff861"></a>

### getAudioScenario() [#getaudioscenario]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getAudioScenario()

</ApiSignature>

<a id="a87525b24b0d8a191d087b962b14f578a"></a>

### getChannelProfile() [#getchannelprofile]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getChannelProfile()

</ApiSignature>

<a id="ae1523a701df5faf93f59391498520693"></a>

### getContext() [#getcontext]

<ApiSignature>

Object io.agora.rtc.AgoraServiceConfig.getContext()

</ApiSignature>

<a id="a525116ae691f895818ce2fbe79208ede"></a>

### getDomainLimit() [#getdomainlimit]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getDomainLimit()

</ApiSignature>

<a id="ae59b8a24655ced6db27c8f823beff4ca"></a>

### getEnableAudioDevice() [#getenableaudiodevice]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getEnableAudioDevice()

</ApiSignature>

<a id="a05d0f2f3e8bddeefdac0d4cf4893ec0e"></a>

### getEnableAudioProcessor() [#getenableaudioprocessor]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getEnableAudioProcessor()

</ApiSignature>

<a id="aa97bd967656ff99de65ecbc8e46e117e"></a>

### getEnableVideo() [#getenablevideo]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getEnableVideo()

</ApiSignature>

<a id="ad166548603058f7cf7fe64ccf7c06954"></a>

### getLogFilePath() [#getlogfilepath]

<ApiSignature>

String io.agora.rtc.AgoraServiceConfig.getLogFilePath()

</ApiSignature>

<a id="a2dfc14383d29f54598ace98e094d90e9"></a>

### getLogFileSize() [#getlogfilesize]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getLogFileSize()

</ApiSignature>

<a id="aff803ece9bca141e06ad4eb99845e4af"></a>

### getLogFilters() [#getlogfilters]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getLogFilters()

</ApiSignature>

<a id="a57e0147ecd6cb8f71a41d45b905c7e5a"></a>

### getUseStringUid() [#getusestringuid]

<ApiSignature>

int io.agora.rtc.AgoraServiceConfig.getUseStringUid()

</ApiSignature>

<a id="a949388f33120c8812871d97b221eb774"></a>

### setAppId() [#setappid]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setAppId(String *appId*)

</ApiSignature>

<a id="ab7295212eb395fe538ac9efa36847825"></a>

### setAreaCode() [#setareacode]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setAreaCode(int *areaCode*)

</ApiSignature>

<a id="abc40c5a8f343e65f30a863c40113b94c"></a>

### setAudioScenario() [#setaudioscenario]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setAudioScenario(int *audioScenario*)

</ApiSignature>

<a id="a99706daf6312380f2d094b7fd5bd6b76"></a>

### setChannelProfile() [#setchannelprofile]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setChannelProfile(int *channelProfile*)

</ApiSignature>

<a id="ab291f42bcca3a77cd428d9a0763efe6e"></a>

### setContext() [#setcontext]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setContext(Object *context*)

</ApiSignature>

<a id="aa82fd5d89f9144eb5f471057554f9694"></a>

### setDomainLimit() [#setdomainlimit]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setDomainLimit(int *domainLimit*)

</ApiSignature>

<a id="aede4eda3b24f687da6b9b52f2d77a10f"></a>

### setEnableAudioDevice() [#setenableaudiodevice]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setEnableAudioDevice(int *enableAudioDevice*)

</ApiSignature>

<a id="a3caf10834894a255a638c55bb876589a"></a>

### setEnableAudioProcessor() [#setenableaudioprocessor]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setEnableAudioProcessor(int *enableAudioProcessor*)

</ApiSignature>

<a id="a4a253e0f6641b7122cd838c512d4e5ff"></a>

### setEnableVideo() [#setenablevideo]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setEnableVideo(int *enableVideo*)

</ApiSignature>

<a id="a2b7de6e35f5fc434827ac4da4c4ea1ca"></a>

### setLogFilePath() [#setlogfilepath]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setLogFilePath(String *logFilePath*)

</ApiSignature>

<a id="a3c4a0844df2f2299a5089a3f773c0b84"></a>

### setLogFileSize() [#setlogfilesize]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setLogFileSize(int *logFileSize*)

</ApiSignature>

<a id="a9a2e61a53b8b1ee505febe69ae23c3d2"></a>

### setLogFilters() [#setlogfilters]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setLogFilters(int *logFilters*)

</ApiSignature>

<a id="a5c77b22409d8b5d03b0d7f317d78d515"></a>

### setUseStringUid() [#setusestringuid]

<ApiSignature>

void io.agora.rtc.AgoraServiceConfig.setUseStringUid(int *useStringUid*)

</ApiSignature>

<a id="ad7ed2cde45cf60be8929d0c5d754b199"></a>

### toString() [#tostring]

<ApiSignature>

String io.agora.rtc.AgoraServiceConfig.toString()

</ApiSignature>

<a id="doc-variable-members"></a>

<a id="header-doc-variable-members"></a>

## 类成员变量说明 [#类成员变量说明]

<a id="adc344b24ef5cd869f525b828018d9c24"></a>

### appId [#appid]

<ApiSignature labels="private">

String io.agora.rtc.AgoraServiceConfig.appId

</ApiSignature>

你的声网项目的 App ID。

<a id="a8d5c6b04716b850c34212bfc12f64900"></a>

### areaCode [#areacode]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.areaCode = Constants.AREA_CODE_GLOB

</ApiSignature>

服务器的访问区域。该功能为高级设置，适用于有访问安全限制的场景。指定访问区域后，SDK 会连接指定区域内的声网服务器。

- 0x00000001: 中国大陆。
- 0x00000002: 北美区域。
- 0x00000004: 欧洲区域。
- 0x00000008: 除中国大陆以外的亚洲区域。
- 0x00000010: 日本。
- 0x00000020: 印度。
- 0xFFFFFFFF:（默认）全球。

<a id="a207084ea5c00852c3fcc5e180859706c"></a>

### audioScenario [#audioscenario]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.audioScenario = Constants.AUDIO_SCENARIO_CHORUS

</ApiSignature>

音频编码属性：

- 0: (推荐) 默认的音频应用场景。
- 3: (推荐) 游戏开黑场景，适用于高清音乐播放的场景。
- 5: 语聊场景。该场景通常在 setClientRole 设置用户角色为观众后仍需要录制。
- 6:（推荐）高清场景。适用于高清音质的场景。
- 7:（默认）合唱场景。

<a id="a55c131186d55940ae34d4388a24b390f"></a>

### channelProfile [#channelprofile]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.channelProfile = Constants.CHANNEL_PROFILE_LIVE_BROADCASTING

</ApiSignature>

频道使用场景：

- 0: 通信场景。当频道中只有两个用户时，建议使用该场景。
- 1: （默认）直播场景。当频道中有两个以上的用户时，使用该场景。

<a id="abc69eda554f7e64d75771fb2455be2ff"></a>

### context [#context]

<ApiSignature labels="private">

Object io.agora.rtc.AgoraServiceConfig.context

</ApiSignature>

用户 Context 信息。

- 在 Windows 上，用来指加载视频的窗口句柄。如果你需要在主播直播时热插拔视频设备，需要设置该值。
- 在 Android 上，指 Activity 的 Context 信息。

<a id="a537f8d7d0b15f67b5b6a3de2e7929706"></a>

### domainLimit [#domainlimit]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.domainLimit

</ApiSignature>

是否开启域名限制：

- 1: 仅连接被 DNS 解析过服务器。
- 0:（默认）连接服务器无限制。

<a id="a2ba53beda7183a0ac7d19bd88061aa35"></a>

### enableAudioDevice [#enableaudiodevice]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.enableAudioDevice = 0

</ApiSignature>

是否开启音频设备模块（Audio Device Module, ADM）。 ADM 用来管理音频设备，例如录制和播放音频。如果你将 enableAudioDevice 设为 false 且将 enableAudioProcessor 设为 true，你将无法使用音频设备，但你可以推送 PCM 音频数据。

- true: 开启音频设备模块。你可以录制和播放音频。
- false: (默认) 关闭音频设备模块。你无法录制和播放音频。

<a id="abd221c4d04064a7aed8ab9bf1bb6de1a"></a>

### enableAudioProcessor [#enableaudioprocessor]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.enableAudioProcessor = 1

</ApiSignature>

是否开启音频处理模块：

- true: (默认) 开启音频处理模块。
- false: 关闭音频处理模块。你将无法创建音频轨道。

<a id="aefb3286e271fe41140b6ca4aa316b4f5"></a>

### enableVideo [#enablevideo]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.enableVideo = 0

</ApiSignature>

是否开启视频：

- true：开启视频。
- false：(默认)关闭视频。

<a id="a13c24a2276710190561662e79ab94786"></a>

### logFilePath [#logfilepath]

<ApiSignature labels="private">

String io.agora.rtc.AgoraServiceConfig.logFilePath

</ApiSignature>

日志文件路径，默认值为 NULL，表示使用默认的路径。

<a id="ae1510ad2ceac9d30ecc422697ff68fff"></a>

### logFileSize [#logfilesize]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.logFileSize = 2048

</ApiSignature>

日志文件大小，单位为 KB。默认大小为 2048。

<a id="a3106650f88ec2229f6dbd89b18925738"></a>

### logFilters [#logfilters]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.logFilters = Constants.LOG_FILTER_INFO

</ApiSignature>

日志过滤等级。默认为 LOG_FILTER_INFO。

- 0：不输出任何日志
- 0x80f：输出所有日志
- 0x0f：（默认）输出 CRITICAL、ERROR、WARNING 和 INFO 级别的日志
- 0x0e：输出 CRITICAL、ERROR 和 WARNING 级别的日志
- 0x0c：输出 CRITICAL 和 ERROR 级别的日志
- 0x08：输出 CRITICAL 级别的日志

<a id="ac51fb286bb4930a891dcc4776dd2f094"></a>

### useStringUid [#usestringuid]

<ApiSignature labels="private">

int io.agora.rtc.AgoraServiceConfig.useStringUid

</ApiSignature>

是否允许 String UID：

- true: 允许。
- false:（默认）不允许。

---

该类的文档由以下文件生成:

- AgoraServiceConfig.java