# 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[注解] 该参数用于技术预览功能或特殊定制,请在技术支持指导下配置。 :::