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 클래스로 조회(Get) 가능한 설정¶

Configuration 클래스 메서드로 값 조회(get)만 가능한 설정 항목들은 아래와 같습니다.

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

Configuration 클래스 메서드로 값 변경(set)이 가능한 항목들은 아래와 같습니다. 필수 항목은 반드시 입력해야 하며, 선택 항목은 필요에 따라 입력합니다. 선택 항목을 입력하지 않으면 Hive SDK 기본값으로 동작합니다. 필수 항목일지라도 hive_config.xml에 이미 입력했었고 런타임 시 변경할 필요가 없다면 Configuration 클래스로 변경할 필요가 없습니다.

지원하지 않는 항목¶

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