콘텐츠로 이동

모듈 설치 및 초기화

'계정 및 인증' 기능을 사용하려면 Hive Axyl SDK에 인증 모듈을 설치하고 SDK 전역 초기화 시점에 등록해야 합니다. 모듈 설치에 앞서 Hive Axyl SDK 설치를 먼저 완료하세요.

1. 모듈 설치

모듈은 Unity Package Manager에서 패키지를 프로젝트 의존성에 추가해 설치합니다. 전역 공통 패키지인 com.com2usplatform.hiveaxyl.core가 먼저 설치되어 있어야 합니다.

1.1. 인증 모듈

'계정 및 인증' 기능을 사용하려면 아래 패키지를 설치하세요.

  • com.com2usplatform.hiveaxyl.auth: 로그인 수단 조회, 계정 연동과 해제, 이용 제한 조회를 제공하는 IAuthService와 토큰 발급을 제공하는 ITokenService를 담은 패키지

1.2. 보안 저장소 모듈

com.com2usplatform.hiveaxyl.storage는 액세스 토큰이나 리프레시 토큰처럼 다음 실행에도 남겨야 하는 값을 기기의 보안 저장소에 암호화해 보관하는 ISecureStorage를 제공합니다. 자동 로그인과 여러 계정 간 전환을 구현하거나, 로그아웃과 계정 삭제에서 저장한 토큰을 지울 때 필요합니다. 그 밖의 '계정 및 인증' 기능만 사용한다면 설치하지 않아도 됩니다.

Note

보안 저장소는 iOS, macOS, Android, Windows 플레이어 빌드에서만 동작합니다. Unity 에디터에서는 등록되지 않으므로 HiveCore.Resolve<ISecureStorage>() 대신 HiveCore.TryResolve<ISecureStorage>(out var storage)로 확인한 뒤 사용하세요. Windows에서는 앱을 실행하는 모든 기기에 Microsoft Visual C++ 2015-2022 재배포 가능 패키지(x64)가 설치되어 있어야 합니다.

1.3. 설치 확인

아래 using 구문에서 컴파일 오류가 발생하지 않으면 설치가 완료된 것입니다.

using Hive.Axyl.Core;
using Hive.Axyl.Auth;
using Hive.Axyl.Storage;   // 보안 저장소 모듈을 설치한 경우에만 필요합니다.

패키지 선택과 설치 절차는 시작하기 - 모듈 설치를 참조하세요.

2. 모듈 초기화

모듈은 SDK 전역 초기화 시점에 함께 등록합니다. HiveBootstrap.Initialize의 등록 단계에서 AddAuth()를 호출하면 IAuthService가, AddToken()을 호출하면 ITokenService가, AddSecureStorage()를 호출하면 ISecureStorage가 등록됩니다.

using Hive.Axyl.Core;
using Hive.Axyl.Auth;
using Hive.Axyl.Storage;

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

HiveBootstrap.Initialize(config, builder =>
{
    builder.AddAuth()
           .AddToken()
           .AddSecureStorage();   // 토큰을 기기에 저장하거나 저장한 토큰을 지울 때 등록합니다.
});

2.1. 초기화 결과 확인

초기화 이후에는 필요한 서비스를 HiveCore.Resolve<T>()로 가져와 사용합니다.

IAuthService auth = HiveCore.Resolve<IAuthService>();
ITokenService token = HiveCore.Resolve<ITokenService>();

// 보안 저장소는 지원 OS의 플레이어 빌드에서만 등록됩니다.
if (HiveCore.TryResolve<ISecureStorage>(out ISecureStorage storage))
{
    // 토큰 저장·복원 로직에서 storage를 사용합니다.
}

IAuthService와 ITokenService가 정상 반환되면 초기화가 완료된 상태입니다. 전역 초기화 절차는 시작하기 - SDK 초기화를 참조하세요.

다음 단계

로그인 화면에 노출할 로그인 수단을 정하려면 지원하는 로그인 수단 조회를 참조하세요.