設定クラス¶

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を表示し、ユーザーが選択したゲームサーバーを設定に反映させます。このプロセスを実行した後、サーバーチェックポップアップを表示します。

例: ゲームサーバー選択UI

ゲームに入った後¶

ゲームに入った後にユーザーがゲーム設定でゲームの言語やゲームサーバーを変更した場合、ゲーム設定やゲームをプレイ中の他のメニューにゲームサーバーまたはゲーム言語変更のUIを作成できます。このUIを使用してユーザーがサーバーや言語を変更した場合、設定にもこの情報を反映させる必要があります。

例: ゲーム言語選択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のままです。

設定のみ取得可能な構成クラス¶

取得（get）できる構成アイテムは、Configurationクラスのメソッドを使用してのみ取得されるものは以下の通りです。

設定クラスの変更可能な設定¶

Configurationクラスのメソッドを使用して変更できるアイテム（set）は以下の通りです。これらは、アプリをビルドする前にhive_config.xmlにプリコンフィグされたHive SDK共通設定項目と同じアイテムです。必須項目は入力する必要があり、任意項目は必要に応じて入力します。任意項目を入力しない場合、Hive SDKはデフォルト値で動作します。

サポートされていないアイテム¶

Configurationクラスでもはやサポートされていないメソッドは以下の通りです。