블루프린트 연동

Learn how to implement authentication using Unreal Engine Blueprints.

읽는 시간 3분

최근 업데이트: 6달 전

종속성으로 Authentication SDK 추가

다음 블루프린트 데모를 계속 진행하려면 먼저 Authentication SDK 플러그인을 성공적으로 설치했는지, 블루프린트의 이벤트 그래프 또는 Unity Gaming Services > Authentication의 함수에서 인증 관련 함수를 볼 수 있는지 확인해야 합니다.

Sign In Anonymously

함수를 사용해 익명으로 권한을 부여합니다. 이는 사용자 정보 없이 빠르게 인증할 수 있는 방법이며, 외부 공급자와의 상호 작용이 필요하지 않습니다. 성공하면 현재 플레이어 프로필이 Unity Authentication 서버에서 반환된 검색된 자격 증명 정보로 채워집니다.

Sign In Anonymously

는 로그인 수행 방식을 변경하는 파라미터로

FAuthenticationSignInOptions

구조체를 사용합니다. 이러한 파라미터에 대한 자세한 내용은 공식 Unity API 서비스 기술 자료 페이지에서 확인할 수 있습니다. SDK의 응답은 사용자 지정 이벤트에서 처리할 수 있으며, 이 이벤트는 Authentication Response를 출력 핀으로 수신해야 합니다. 응답 변수를 분리하려면 응답 본문 출력 핀을 오른쪽 클릭하고 Split Pin을 선택합니다.

Get User Info

Get User Info

함수를 사용해 현재 인증된 사용자에 대한 정보를 검색합니다. 여기에는 사용자 ID, 인증 타임스탬프, 세션에 연결된 모든 외부 ID 제공업체 정보 등이 포함됩니다. SDK의 응답은 사용자 지정 이벤트에서 처리할 수 있으며, 이 이벤트는 Authentication User Response를 출력 핀으로 수신해야 합니다. 응답 변수를 분리하려면 응답 본문 출력 핀을 오른쪽 클릭하고 Split Pin을 선택합니다.

Delete User

Delete User

함수를 사용해 현재 인증된 플레이어와 관련된 모든 정보를 삭제합니다. 이 함수는 또한 플레이어를 로그아웃하고 플레이어에 연결된 모든 플레이어 환경 설정과 프로필을 삭제합니다. SDK의 응답은 사용자 지정 이벤트에서 처리할 수 있으며, 이 이벤트는 삭제 성공 여부를 나타내는

Boolean

을 출력 핀으로 가져와야 합니다.

Register State Changed Callback

Register State Changed Callback

함수를 사용해 보조 시스템의 상태가 변경될 때 호출되는 콜백 함수를 할당합니다. 예를 들어, 할당된 함수는 플레이어가 인증에 성공하고 보조 시스템 상태가

Authorized

로 변경되면 실행됩니다. SDK의 응답은 사용자 지정 이벤트에서 처리할 수 있으며, 이 이벤트는 Authentication State Changed Response를 출력 핀으로 수신해야 합니다. 응답 변수를 분리하려면 응답 본문 출력 핀을 오른쪽 클릭하고 Split Pin을 선택합니다.

Sign Out

Sign Out

함수를 사용해 현재 인증된 플레이어 프로필에서 로그아웃합니다. 이렇게 하면 현재 플레이어 프로필이 제거되고 기본 프로필로 전환됩니다. 이 함수에는 이 플레이어와 관련된 모든 저장된 자격 증명 정보를 제거하는 선택적 파라미터도 있습니다.

참고

참고: 기본 프로필을 사용하는 동안

Sign Out

을 사용하면 프로필 정보가 지워지고 프로필은 그대로 유지됩니다.

이 함수는 작업의 성공 여부를 나타내는

Boolean

을 반환합니다.

Switch Profile

Switch Profile

함수를 사용해 플레이어 프로필로 전환하거나 프로필을 만듭니다.

참고

참고:

Switch Profile

은 로그아웃한 상태에서만 호출할 수 있습니다. 인증된 상태에서 프로필 전환을 호출하면 경고가 기록되고 아무 일도 일어나지 않습니다.

Switch profile

Profile Exists

Profile Exists

함수를 사용해 현재 세션에 지정된 프로필이 있는지 확인합니다.

참고

참고:

Profile Exists

는 현재 세션에서 다시 만들지 않은 이전 세션의 프로필을 감지할 수 없습니다.

이 함수는 주어진 프로필 이름이 현재 플레이어 프로필 목록에 존재하는지 여부를 나타내는

Boolean

을 반환합니다.

Profile Exists

Get Current Profile Name

Get Current Profile Name

함수를 사용해 현재 플레이어 프로필의 이름을 검색합니다. 이 함수는 Authentication 보조 시스템에서 사용 중인 현재 플레이어 프로필의 이름을 나타내는

String

을 반환합니다.

Get current profile name

Get Profile Names

Get Current Profile Names

함수를 사용해 현재 세션에서 사용 중인 모든 플레이어 프로필 이름 목록을 검색합니다. 이 함수는 Authentication 보조 시스템에서 사용 중인 모든 플레이어 프로필의 이름을 나타내는

String Array

를 반환합니다.

Get profile names

Register Profile Changed Callback

Register Profile Changed Callback

함수를 사용해 플레이어 프로필이 변경될 때 호출되는 콜백 함수를합니다. 예를 들어, 할당된 함수는 프로필 전환이 성공적으로 실행되면 실행됩니다. SDK의 응답은 사용자 지정 이벤트에서 처리할 수 있으며, 이 이벤트는 Authentication Player Profile Changed Response를 출력 핀으로 수신해야 합니다. 응답 변수를 분리하려면 응답 본문 출력 핀을 오른쪽 클릭하고 Split Pin을 선택합니다.

Register Profile Deleted Callback

Register Profile Changed Callback

함수를 사용하여 현재 세션에서 플레이어 프로필이 제거될 때 호출되는 콜백 함수를 지정할 수 있습니다. 예를 들어, 할당된 함수는 로그아웃이 성공적으로 실행되면 실행됩니다. SDK의 응답은 사용자 지정 이벤트에서 처리할 수 있으며, 이 이벤트는 Authentication Player Profile Deleted Response를 출력 핀으로 수신해야 합니다. 응답 변수를 분리하려면 응답 본문 출력 핀을 오른쪽 클릭하고 Split Pin을 선택합니다.

Is Signed In

Is Signed In

함수를 사용해 현재 플레이어 프로필이 로그인되어 있는지 확인합니다. '로그인' 상태는 권한이 부여된 상태 또는 만료된 상태로 정의됩니다. 이 함수는 현재 플레이어 프로필이 로그인되어 있는지 여부를 나타내는

Boolean

을 반환합니다.

Is Anonymous

Is Anonymous

함수를 사용해 현재 플레이어 프로필이 익명으로 로그인되어 있는지 확인합니다.

Sign In Anonymously

를 성공적으로 실행하고 나면 true가 반환됩니다. 이 함수는 현재 플레이어 프로필이 익명으로 로그인했는지 여부를 나타내는

Boolean

을 반환합니다. 마지막 로그인이 익명인 경우 세션이 만료된 경우에도 true를 반환합니다.

Is Authorized

Is Authorized

함수를 사용해 현재 플레이어 프로필이 로그인되어 있고 현재 권한을 부여한 상태인지 확인합니다. 이 함수는 현재 플레이어 프로필이 로그인되어 있고 권한을 부여하는 데 성공했는지 여부를 나타내는

Boolean

을 반환합니다. 만료 시간이 아직 지나지 않은 상태에서 로그인 함수를 실행하면 true를 반환해야 합니다.

Is Expired

Is Expired

함수를 사용해 현재 플레이어 프로필의 세션이 만료되었는지 확인합니다. 이 함수는 현재 플레이어 프로필의 세션이 초기 인증 응답에서 반환된 만료 시간을 지났는지를 나타내는

Boolean

을 반환합니다.

Session Token Exists

Session Token Exists

함수를 사용해 현재 플레이어 프로필에 대한 플레이어 환경 설정에 세션 토큰이 있는지 확인합니다. 이 함수는 세션 토큰의 존재 여부를 나타내는

Boolean

을 반환합니다.

Get Unity Project Id

Get Unity Project Id

함수를 사용해 현재 인증 세션과 연결된 Unity 프로젝트 ID를 검색합니다. 이 함수는 현재 사용 중이 프로젝트 ID를 나타내는

Guid

을 반환합니다.

Get Unity Environment Name

Get Unity Environment Name

함수를 사용해 현재 인증 세션과 연결된 Unity 환경 이름의 이름을 검색합니다. 이 함수는 현재 사용 중이 프로젝트 ID를 나타내는

String

을 반환합니다.

Get Access Token

Get Access Token

함수를 사용해 현재 세션의 액세스 토큰을 검색합니다. 토큰이 없으면 빈 문자열을 반환합니다.

Get Session Token

Get Session Token

함수를 사용해 현재 세션의 세션 토큰을 검색합니다. 토큰이 없으면 빈 문자열을 반환합니다.

Get User Id

Get User Id

함수를 사용해 현재 세션의 사용자 ID를 검색합니다.

참고

참고: 플레이어 프로필 이름과는 다릅니다. 사용자 ID는 Unity Authentication 시스템에서 반환된 고유한 사용자 식별자입니다.

이 함수는 현재 플레이어 프로필의 사용자 ID를 나타내는

String

을 반환합니다. 토큰이 없으면 빈 문자열을 반환합니다.

Get State

Get State

함수를 사용해 인증 세션의 현재 상태를 검색합니다. 이 함수는 보조 시스템의 상태를 나타내는

Enum

을 나타냅니다.

Set Unity Project Id

Set Unity Project Id

함수를 사용해 현재 인증 세션의 Unity 프로젝트 ID를 설정합니다. 함수는

Guid

를 사용합니다.

참고

참고: 이렇게 하면 프로젝트 설정에서 구성된 Unity 프로젝트 ID가 오버라이드됩니다.

Set Unity Environment Name

Set Unity Environment Name

함수를 사용해 현재 인증 세션의 Unity 환경 이름을 설정합니다. 함수는

String

를 사용합니다.

참고

참고: 이렇게 하면 프로젝트 설정에서 구성된 Unity 환경 이름이 오버라이드됩니다.

기술 자료

Development

User Acquisition

Monetization

산업 분야

기술 자료

Development

User Acquisition

Monetization

산업 분야

Authentication for Unreal Engine

Authentication for Unreal Engine

블루프린트 연동

종속성으로 Authentication SDK 추가

Get User Info

Delete User

Register State Changed Callback

Sign Out

Switch Profile

Profile Exists

Get Current Profile Name

Get Profile Names

Register Profile Changed Callback

Register Profile Deleted Callback

Is Signed In

Is Anonymous

Is Authorized

Is Expired

Session Token Exists

Get Unity Project Id

Get Unity Environment Name

Get Access Token

Get Session Token

Get User Id

Get State

Set Unity Project Id

Set Unity Environment Name