Configuration 클래스¶

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];

Configuration 클래스 사용 상황¶

앱 실행 중 Hive SDK 설정을 변경해야 하는 경우는 다음과 같습니다.

Hive SDK 초기화 전¶

Hive SDK를 초기화하기 전 게임 서버나 게임 언어를 설정에 반영합니다.

Hive SDK 초기화 후 ~ 서버 점검 팝업 이전¶

Hive SDK 초기화 후 서버 점검 팝업을 띄우기 전 사용자가 게임 서버를 선택하는 경우입니다. Hive SDK를 초기화한 뒤 게임 서버 선택 UI를 노출하고, 사용자가 고른 게임 서버를 설정에 반영합니다. 이 과정을 실행한 후 서버 점검 팝업을 띄웁니다.

예시: 게임 서버 선택 UI

게임 진입 후¶

게임 진입 후 게임 설정에서 유저가 게임 언어 또는 게임 서버를 변경하는 경우, 게임을 플레이하는 도중에 게임 설정이나 다른 메뉴에서 게임 서버 또는 게임 언어 변경 UI를 구성할 수 있습니다. 사용자가 해당 UI를 이용해 서버나 언어를 변경했다면 이 내용을 설정에도 반영해야 합니다.

예시: 게임 언어 선택 UI

기타 상황¶

게임 기획 등 기타 상황에 따라 게임 정보가 변경되는 경우 등 여러가지 상황으로 기존에 설정했던 값을 변경합니다.

Configuration 클래스 사용 예시¶

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)

Configuration 클래스와 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 클래스 메서드로 값 조회(get)만 가능한 설정 항목들은 아래와 같습니다.

Configuration 클래스로 변경 가능한 설정¶

Configuration 클래스 메서드로 값 변경(set)이 가능한 항목들은 아래와 같습니다. 앱을 빌드하기 전에 hive_config.xml에 사전 설정하는 Hive SDK 공통 설정 항목들과 동일한 항목들입니다. 필수 항목은 반드시 입력해야 하며, 선택 항목은 필요에 따라 입력합니다. 선택 항목을 입력하지 않으면 Hive SDK 기본값으로 동작합니다.

지원하지 않는 항목¶

Configuration 클래스 메서드들 중 더는 지원하지 않는 메서드들은 다음과 같습니다.