# agora::base::AgoraServiceConfiguration结构体 参考 (/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1base-1-1-agora-service-configuration)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 详细描述 [#详细描述]
[IAgoraService](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1base-1-1-i-agora-service) 类的全局配置。
在调用 [initialize](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1base-1-1-i-agora-service#a6f1fb6e792c564dee46903cbb3bc35fc) 方法时设置。
## 构造及析构函数说明 [#构造及析构函数说明]
### AgoraServiceConfiguration() [#agoraserviceconfiguration]
agora::base::AgoraServiceConfiguration::AgoraServiceConfiguration()
## 类成员变量说明 [#类成员变量说明]
### enableAudioProcessor [#enableaudioprocessor]
bool agora::base::AgoraServiceConfiguration::enableAudioProcessor
是否开启音频处理模块(Audio Processing Module, APM)。
- `true`: (默认) 开启音频处理模块。
- `false`: 关闭音频处理模块。你将无法创建音频轨道。
### enableAudioDevice [#enableaudiodevice]
bool agora::base::AgoraServiceConfiguration::enableAudioDevice
是否开启音频设备模块(Audio Device Module, ADM)。 ADM 用来管理音频设备,例如录制和播放音频。
- `true`: (默认) 开启音频设备模块。你可以录制和播放音频。
- `false`: 关闭音频设备模块。你无法录制和播放音频。
:::info[注解]
如果你将 `enableAudioDevice` 设为 `false` 且将 `enableAudioProcessor` 设为 `true`,你将无法使用音频设备,但你可以推送 PCM 音频数据。
:::
### enableVideo [#enablevideo]
bool agora::base::AgoraServiceConfiguration::enableVideo
是否开启视频。
- `true`: 开启视频。
- `false`: (默认) 关闭视频。
### appId [#appid]
const char* agora::base::AgoraServiceConfiguration::appId
你的声网项目的 App ID。该参数中不支持填写 Token。
### areaCode [#areacode]
unsigned int agora::base::AgoraServiceConfiguration::areaCode
服务器的访问区域。该功能为高级设置,适用于有访问安全限制的场景。 支持的区域详见 [AREA_CODE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a85a66bc360e0d01a3f675c6a0fe95f5e)。区域码支持位操作。
指定访问区域后,SDK 会连接指定区域内的声网服务器。
### channelProfile [#channelprofile]
[agora::CHANNEL_PROFILE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#abc5eb7ac0efb18032c8383e528c490a2) agora::base::AgoraServiceConfiguration::channelProfile
频道使用场景。详见 [CHANNEL_PROFILE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#abc5eb7ac0efb18032c8383e528c490a2)。
### audioScenario [#audioscenario]
[rtc::AUDIO_SCENARIO_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a2c5708461a9e1568bbda636d95055533) agora::base::AgoraServiceConfiguration::audioScenario
音频应用场景。详见 [AUDIO_SCENARIO_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a2c5708461a9e1568bbda636d95055533)。
### logConfig [#logconfig]
[commons::LogConfig](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1commons-1-1-log-config) agora::base::AgoraServiceConfiguration::logConfig
设置 SDK 输出的日志文件。详见 [LogConfig](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1commons-1-1-log-config)。
### useStringUid [#usestringuid]
bool agora::base::AgoraServiceConfiguration::useStringUid
是否允许 String UID。
### domainLimit [#domainlimit]
bool agora::base::AgoraServiceConfiguration::domainLimit
是否开启域名限制:
- `true`: 开启。SDK 只能访问指定域名的网络。
- `false`: (默认)不开启。SDK 可以访问任意域名的网络。
:::info[注解]
- 该参数仅对使用定向物联网卡的 IOT 场景有效。为保证使用定向物联网卡的设备与其他设备互通, 你需要将该参数设置为 `true`。
- 开启域名限制前,你需要[联系销售]([https://www.shengwang.cn/contact-sales/](https://www.shengwang.cn/contact-sales/)\}进行设置。
:::
### configDir [#configdir]
const char* agora::base::AgoraServiceConfiguration::configDir
配置文件目录。默认值为 `NULL`,使用 SDK 默认配置目录。
### dataDir [#datadir]
const char* agora::base::AgoraServiceConfiguration::dataDir
数据文件目录。默认值为 `NULL`,使用 SDK 默认数据目录。
### parameters [#parameters]
const char* agora::base::AgoraServiceConfiguration::parameters
初始化时传入的 JSON 格式 SDK 参数。默认值为 `NULL`。
:::info[注解]
该参数用于技术预览功能或特殊定制,请在技术支持指导下配置。
:::