Storage 모듈

인증 토큰처럼 민감한 문자열 값을 기기의 보안 저장소에 암호화해 보관하는 키-값 저장소 모듈입니다. 값의 저장, 조회, 삭제와 저장소 비우기를 제공하며, 저장한 값은 앱을 다시 시작해도 유지됩니다.

Hive Axyl SDK는 로그인 세션을 메모리에만 유지합니다. 앱을 다시 시작한 뒤 로그인 상태를 복원하려면 앱이 인증 정보를 직접 저장해야 하며, 이 모듈은 그 저장소로 사용할 수 있습니다. 어떤 값을 언제 저장하고 삭제할지는 앱이 정합니다.

모듈 정보

• 패키지: com.com2usplatform.hiveaxyl.storage
• 네임스페이스: Hive.Axyl.Storage
• 지원 플랫폼: Android, Windows, iOS, macOS
• 최소 사양: Android API 29+, iOS 17+, macOS 15+, Unity 6000.0+

제공 인터페이스

인터페이스	등록 메서드	설명
ISecureStorage	AddSecureStorage()	값의 저장, 조회, 삭제와 저장소 비우기

등록과 획득

HiveBootstrap.Initialize의 등록 단계에서 AddSecureStorage()로 등록한 뒤 HiveCore.TryResolve<T>()로 가져옵니다.

Unity

using Hive.Axyl.Core;
using Hive.Axyl.Core.Unity;   // HiveBootstrap
using Hive.Axyl.Storage;

var config = CoreConfig.CreateBuilder("{appId}").Build();

HiveBootstrap.Initialize(config, builder =>
{
    builder.AddSecureStorage();
});

if (HiveCore.TryResolve<ISecureStorage>(out var storage))
{
    // 지원 플랫폼으로 빌드한 플레이어에서만 실행되는 코드
}

ISecureStorage는 지원 플랫폼으로 빌드한 플레이어에서만 등록되며, Unity 에디터에서는 등록되지 않습니다. 저장한 인증 정보로 로그인 상태를 복원하는 흐름은 자동 로그인 구현하기를 참조하세요.