配置類¶

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 设置中的 hive_config.xml 中将 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類別中不再支援的方法。