配置類¶

使用 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類別中不再支持的方法。