設定クラス¶

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クラスでもはやサポートされていないメソッドは以下の通りです。