配置类¶

使用 Configuration 类，您可以在应用程序运行时 检索 (get) 或 更改 (set) 配置值。例如，在检索应用服务器信息时，请使用 getServerId() 方法，而在更改时，请使用 setServerId() 方法。

作为使用Configuration类的示例，您可以在应用程序执行期间使用Configuration类更改用户的zone设置。

using hive;  

Configuration.setZone(ZoneType.REAL);

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
using namespace std;    
using namespace hive;      

Configuration::setZone(ZoneType::REAL);

import com.hive.Configuration    

Configuration.zone = Configuration.ZoneType.REAL

import com.hive.Configuration;    

Configuration.INSTANCE.setZone(Configuration.ZoneType.REAL);

import HIVEService    

ConfigurationInterface.setZone(.real)

#import <HIVEService/HIVEService-Swift.h>    

[HIVEConfiguration setZone: HIVEZoneTypeReal];

配置类的使用场景¶

如果您需要在应用程序运行时更改 Hive SDK 设置，请参阅以下情况。

Hive SDK 初始化前¶

在初始化Hive SDK之前，请在设置中反映游戏服务器或游戏语言。

Hive SDK 初始化 ~ 服务器维护弹窗之前¶

这是用户在初始化 Hive SDK 之后选择游戏服务器的情况，然后显示服务器维护弹出窗口。在初始化 Hive SDK 之后，游戏服务器选择 UI 被暴露，用户选择的游戏服务器反映在设置中。执行此过程后，显示服务器维护弹出窗口。

示例：游戏服务器选择界面

进入游戏后¶

如果用户在进入游戏后更改游戏设置中的游戏语言或游戏服务器，他们可以在游戏设置或其他菜单中配置用于更改游戏服务器或游戏语言的用户界面。如果用户使用该用户界面更改服务器或语言，则该信息也必须反映在设置中。

示例：游戏语言选择界面

其他情况¶

根据游戏规划和其他情况的变化，改变之前设定的值。

使用配置类的示例¶

这里是关于使用Configuration类的附加指南。

Hive 主题设置¶

您可以使用 Configuration.setHiveTheme 暴露暗黑主题。

using hive;

Configuration.setHiveTheme(HiveThemeType.hiveLight);
Configuration.setHiveTheme(HiveThemeType.hiveDark);

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;

Configuration::setHiveTheme(HiveThemeType::hiveLight);
Configuration::setHiveTheme(HiveThemeType::hiveDark);

import com.hive.Configuration

Configuration.hiveTheme = HiveTheme.hiveLight
Configuration.hiveTheme = HiveTheme.hiveDark

import com.hive.Configuration;

Configuration.INSTANCE.setHiveTheme(Configuration.HiveTheme.HiveLight);
Configuration.INSTANCE.setHiveTheme(Configuration.HiveTheme.HiveDark);

#import <HIVEService/HIVEService-Swift.h>

[HIVEConfiguration setHiveTheme: HIVEThemeTypeHiveLight];
[HIVEConfiguration setHiveTheme: HIVEThemeTypeHiveDark];

import HIVEService

ConfigurationInterface.setHiveTheme(.hiveLight)
ConfigurationInterface.setHiveTheme(.hiveDark)

配置类和 hive_config.xml 文件¶

使用Configuration类中的方法更改设置（运行时设置）会覆盖在hive_config.xml中设置的值（构建时设置）。换句话说，Configuration类设置的值优先级更高。然而，Configuration类设置的值在Hive SDK中优先，而hive_config.xml文件中的现有值不会被更改。

例如，即使您在 hive_config.xml 中的上述 zone 配置中将 zone 设置为 sandbox，在使用 Configuration 类将此值更改为 real 并初始化 Hive SDK 后，Hive SDK 将基于 real 进行操作。然而，hive_config.xml 中的 zone 仍将保持为 sandbox。

可检索设置的配置类¶

配置类方法允许您检索设置的值（get），这些设置仅在下面列出。

可配置设置与配置类¶

可以通过Configuration类方法更改的项目(set)如下所示。必须输入的项目为强制项，而可选项目可以根据需要输入。如果未输入可选项目，它们将使用Hive SDK的默认值进行操作。即使是强制项，如果已经在hive_config.xml中输入且在运行时不需要更改，也无需通过Configuration类进行更改。

不支持的项目¶

以下是Configuration类不再支持的方法。