設定クラス¶

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のままです。

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

取得できる構成アイテムは、Configurationクラスのメソッドを使用してのみ取得されます。

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

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

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

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