設定クラス¶

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の初期化前¶

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クラスによって設定された値がより高い優先度を持ちます。ただし、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クラスの以下のメソッドはもはやサポートされていません。