GS2-SDK for UE5 Blueprint 튜토리얼
중간까지는 일반적인 튜토리얼과 동일한 순서로 진행됩니다.
클라이언트 초기화
GS2::Core::Action::Initialize 노드를 생성하고, clientId / clientSecret / 접속할 리전을 설정합니다.
clientId / clientSecret 에는 크리덴셜(API 키) 생성 에서 생성한 값을 설정합니다.
초기화에 성공한 경우 OnSuccess 가 호출되고, 실패한 경우 OnError 가 호출됩니다.
성공 시에는 Client 에 GS2 클라이언트 객체가, 실패 시에는 Error 에 실패 사유의 에러 객체가 반환됩니다.
GS2-Account 클라이언트 생성
초기화 시 얻은 Client 객체를 지정하여 GS2::Account::Service 노드를 생성합니다.
Service 에 GS2-Account 의 기능을 이용하기 위한 서비스 클라이언트가 반환됩니다.
Namespace 객체 생성
GS2-Account 의 서비스 클라이언트를 지정하여 GS2::Account::Namespace 노드를 생성합니다.
Namespace Name 에는 로그인 처리에 필요한 리소스 준비 에서 생성한 네임스페이스 이름을 지정합니다.
Namespace 에 GS2-Account 의 Namespace 객체가 반환됩니다.
익명 계정 신규 생성
GS2-Account 의 Namespace 객체를 지정하여 GS2::Account::Action::Create 노드를 생성합니다.
계정 생성에 성공한 경우 OnSuccess 가 호출되고, 실패한 경우 OnError 가 호출됩니다.
성공 시에는 Account 에 생성된 계정 객체가, 실패 시에는 Error 에 실패 사유의 에러 객체가 반환됩니다.
계정 객체에서 값 추출
계정 객체를 지정하여 GS2::Account::Fetch::GetValueOfAccount 노드를 생성합니다.
계정 값 추출에 성공한 경우 OnSuccess 가 호출되고, 실패한 경우 OnError 가 호출됩니다.
성공 시에는 Value 에 계정 객체의 값이, 실패 시에는 Error 에 실패 사유의 에러 객체가 반환됩니다. 구조체를 전개함으로써 발급된 사용자ID와 비밀번호를 추출할 수 있습니다.
로그인
로그인 처리를 실행하기 위해 GS2::Core::Action::Login 노드를 생성합니다.
Login 노드는 Client 와 Authenticator 의 지정이 필요합니다.
Client 에는 GS2::Core::Action::Initialize 노드로 생성한 Client 를 지정합니다.
Authenticator 에는 GS2::Core::CreateGs2Authenticator 노드로 생성한 Authenticator 를 지정합니다.
UserId / Password 에는 앞서 생성한 사용자ID와 비밀번호를 지정합니다.
로그인에 성공한 경우 OnSuccess 가 호출되고, 실패한 경우 OnError 가 호출됩니다.
성공 시에는 AccessToken 에 생성된 액세스 토큰 객체가, 실패 시에는 Error 에 실패 사유의 에러 객체가 반환됩니다.
액세스 토큰은 로그인이 필요한 API 호출 시 필요한 파라미터입니다.
로그인 후 호출 가능한 API 호출
로그인 후 호출 가능한 API 호출 예시로, 인계 정보 목록을 취득해 보겠습니다.
액세스 토큰 객체를 사용하여 GS2::Account::Me 로 자신의 계정 객체를 생성합니다.
그 후, 자신의 계정 객체를 사용하여 GS2::Account::Fetch::ListOfTakeOver 노드를 생성하고, 인계 정보 목록을 취득합니다.
인계 정보 목록 취득에 성공한 경우 OnSuccess 가 호출되고, 실패한 경우 OnError 가 호출됩니다.
성공 시에는 Values 에 인계 정보 배열이, 실패 시에는 Error 에 실패 사유의 에러 객체가 반환됩니다.
Values 를 For Each Loop 노드로 반복하면서 값을 추출합니다.