配置类¶

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

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

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类设置的值具有更高的优先级。然而，Hive SDK在内部使用Configuration类设置的值，并且hive_config.xml文件中的现有值不会被更改。

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

配置类仅可检索设置¶

可以仅通过 Configuration 类方法检索 (get) 的配置项如下。

配置类可修改设置¶

可以使用Configuration类方法修改的项目(set)如下。这些项目与在构建应用程序之前预配置在hive_config.xml中的Hive SDK常见设置项相同。必填项目必须输入，选填项目根据需要输入。如果不输入选填项目，Hive SDK将使用默认值运行。

不支持的项目¶

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