Unity Player Accounts#

개요

Unity Player Accounts는 게임, 기기, 플랫폼 간 일관성을 지원하는 Unity의 종합 로그인 솔루션입니다. Unity Player Accounts는 사용자 플로 UX, 이메일 및 비밀번호, 소셜 로그인 옵션, 데이터 액세스 및 삭제 플로가 포함된 종합 계정 시스템입니다.

Unity Player Accounts는 Unity Gaming Services와 연동되며 익명, Apple, Google, Facebook, Steam과 함께 Authentication이 지원하는 ID 제공업체 중 하나이고, SSO, 조직 수준의 플레이어 풀과 크로스 게임, 크로스 디바이스, 크로스 플랫폼 게임플레이와 같은 이점을 제공합니다.

시작하기#

SDK 설치#

Unity의 최신 Authentication 패키지를 설치하려면 다음 단계를 따르십시오.

1. Unity 에디터에서 Window > Package Manager를 엽니다.
2. Package Manager에서 Unity Registry 목록 뷰를 선택합니다.
3. Authentication을 검색하거나 패키지 목록에서 찾습니다.
4. 패키지를 선택한 후 Install을 선택합니다.

자세한 내용은 패키지 관리자 기술 자료를 참조하십시오.

Unity Player Accounts 설정#

Unity Dashboard에서 직접 Unity Player Accounts를 설정할 수 있습니다.

Unity Player Accounts를 사용하려면 다음을 제공해야 합니다.

게임 퍼블리시 전#

Unity의 규정 준수 및 브랜딩 가이드라인을 검토하십시오.

• 플레이어가 애플리케이션과 Unity Player 계정에 대한 데이터 삭제 및 공개를 요청할 수 있는 수단을 제공해야 합니다.
• Unity Player Accounts 계정 삭제 페이지에 대한 링크를 제공하십시오.
• 데이터 공개 또는 다른 개인정보 관련 요청을 할 수 있도록 Unity Player Accounts 개인정보 지원 이메일에 대한 링크를 제공하십시오.
• 데이터 공개 또는 다른 개인정보 관련 요청을 할 수 있도록 이메일에 대한 링크를 제공하십시오.
• Unity 서비스 약관을 항상 준수해야 합니다.
• 최종 사용자에게 데이터를 적절히 공개하고, 적합한 모든 개인정보 및 데이터 보호 법률과 규정을 준수하며, Unity Player Accounts 서비스를 사용함에 있어 Unity에 필요한 권리를 부여하는 개인정보 처리방침을 항상 유지하고, 표시하며 준수해야 합니다.

서비스 약관 및 개인정보 보호#

Unity Dashboard에 서비스 약관과 개인정보 보호 링크를 제공해야 합니다.

SDK 연동#

Unity Player Accounts 로그인 설정#

패키지를 설치한 후 에디터 메뉴에서 Services > Unity Player Accounts > Settings를 선택합니다.

온보딩 후 가져온 다음 값을 추가합니다.

• Client ID
• Scope(선택 사항. All 또는 Empty는 허용된 모든 범위를 의미)
• Use Custom Deep Link Uri(선택 사항. 기본 딥링크 URI를 오버라이드)

Unity Player Accounts 샘플#

• Window > Package Manager를 선택해 샘플을 임포트합니다. Authentication을 찾고 Samples에서 Import를 선택합니다.

• Assets > Samples > Authentication > [Package-Version] > UI Example > UnityPlayerAccountsUIExample 아래의 샘플 씬을 엽니다.

Unity Authentication 서비스와 연동#

Unity Authentication의 Unity Player 계정 ID 제공업체를 설정합니다.

1. Unity 에디터 메뉴에서 **Edit > Project Settings...**로 이동한 후, 내비게이션 메뉴에서 Services > Authentication을 선택합니다.
2. Go to Dashboard를 선택해 Authentication ID 제공업체 웹 페이지를 엽니다.
3. 웹 페이지에서 Add Identity Provider를 선택하고 Unity Player Accounts를 선택합니다.
4. 제공업체를 설정하고 팝업 창에서 Add provider를 선택합니다.
5. Unity 에디터에서 Services > Authentication으로 돌아가서 Refresh를 선택합니다. Unity Player Accounts ID 제공업체가 표시됩니다.
6. Unity 에디터에서 Services > Authentication > Player Account Settings로 이동하여 클라이언트 ID가 올바르게 설정되었는지 확인합니다.
7. 앞서 임포트한 패키지 샘플 씬 UnityPlayerAccountsUIExample을 실행합니다.

void Awake()
{
   PlayerAccountService.Instance.SignedIn += SignInWithUnity;
}

기존 플레이어 로그인 또는 신규 플레이어 생성#

SignInWithUnityAsync 메서드를 사용하여 다음 중 하나를 수행할 수 있습니다.

• Unity Player 계정 자격 증명 정보를 사용해 새 Unity Authentication 플레이어 생성
• Unity Player 계정 자격 증명 정보를 사용해 기존 플레이어 로그인

async Task SignInWithUnityAsync(string accessToken)
        {
            try
            {
                await AuthenticationService.Instance.SignInWithUnityAsync(accessToken);
                Debug.Log("SignIn is successful.");
            }
            catch (AuthenticationException ex)
            {
                // Compare error code to AuthenticationErrorCodes
                // Notify the player with the proper error message
                Debug.LogException(ex);
            }
            catch (RequestFailedException ex)
            {
                // Compare error code to CommonErrorCodes
                // Notify the player with the proper error message
                Debug.LogException(ex);
            }
        }

플레이어를 익명에서 Unity Player 계정으로 업데이트#

익명 인증을 설정한 후, 플레이어가 Unity Player 계정을 생성하고 이를 통해 로그인하도록 업그레이드하려는 경우, 게임이 플레이어에게 Unity Player Accounts 로그인 창을 표시하고 Unity Player Accounts에서 액세스 토큰을 가져와야 합니다. 그런 다음 LinkWithUnityAsync API를 호출해 플레이어를 Unity Player 계정 액세스 토큰에 연결합니다.

SDK에 캐시된 플레이어가 존재하는 경우, 캐시된 플레이어를 Unity Player 계정에 연결할 수 있습니다.

1. SignInAnonymouslyAsync를 사용해 캐시된 플레이어의 계정에 로그인합니다.
2. LinkWithUnityAsync를 사용해 캐시된 플레이어의 계정을 Unity Player 계정에 연결합니다.

캐시된 플레이어에 대한 자세한 내용은 캐시된 사용자 로그인 섹션을 참고하십시오.

async Task LinkWithUnityAsync(string accessToken)
        {
            try
            {
                await AuthenticationService.Instance.LinkWithUnityAsync(accessToken);
                Debug.Log("Link is successful.");
            }
            catch (AuthenticationException ex) when (ex.ErrorCode == AuthenticationErrorCodes.AccountAlreadyLinked)
            {
                // Prompt the player with an error message.
                Debug.LogError("This user is already linked with another account. Log in instead.");
            }

            catch (AuthenticationException ex)
            {
                // Compare error code to AuthenticationErrorCodes
                // Notify the player with the proper error message
                Debug.LogException(ex);
            }
            catch (RequestFailedException ex)
            {
                // Compare error code to CommonErrorCodes
                // Notify the player with the proper error message
                Debug.LogException(ex);
            }
        }

Unity Player 계정 연결 해제#

플레이어가 Unity Player 계정 연결을 해제할 수 있도록 UnlinkUnityAsync API를 사용합니다. 연결이 해제되면 계정이 다른 ID에 연결되지 않은 경우 익명 계정으로 전환됩니다.

async Task UnlinkUnityAsync(string idToken)
{
   try
   {
       await AuthenticationService.Instance.UnlinkUnityAsync(idToken);
       Debug.Log("Unlink is successful.");
   }
   catch (AuthenticationException ex)
   {
       // Compare error code to AuthenticationErrorCodes
       // Notify the player with the proper error message
       Debug.LogException(ex);
   }
   catch (RequestFailedException ex)
   {
       // Compare error code to CommonErrorCodes
       // Notify the player with the proper error message
       Debug.LogException(ex);
   }
}