다음을 통해 공유


서비스 C API 개요 - PFAuthenticationTypes.h

구조

구조 설명
PFAuthenticationAuthenticateCustomIdRequest PFAuthenticationAuthenticateCustomIdRequest 데이터 모델입니다. game_server 엔터티 토큰을 만들거나 반환합니다. 호출자는 타이틀 엔터티여야 합니다.
PFAuthenticationAuthenticateCustomIdResult PFAuthenticationAuthenticateCustomIdResult 데이터 모델입니다.
PFAuthenticationDeleteRequest PFAuthenticationDeleteRequest 데이터 모델. game_server 엔터티를 삭제합니다. 호출자는 자신을 삭제하려는 game_server 엔터티일 수 있습니다. 또는 이 타이틀에 대한 game_server 엔터티를 삭제하려는 타이틀 엔터티일 수 있습니다.
PFAuthenticationEntityTokenResponse PFAuthenticationEntityTokenResponse 데이터 모델입니다.
PFAuthenticationGetEntityRequest PFAuthenticationGetEntityRequest 데이터 모델입니다. 이 API는 X-SecretKey, X-Authentication 또는 X-EntityToken 헤더를 사용하여 호출해야 합니다. 선택적 EntityKey를 포함하여 결과 EntityToken을 특정 엔터티로 설정하려고 시도할 수 있지만 엔터티는 캐릭터의 master_player_account와 같이 호출자의 관계여야 합니다. X-EntityToken을 보내는 경우 계정은 새로 로그인된 것으로 표시되고 새 토큰을 발급합니다. X-Authentication 또는 X-EntityToken을 사용하는 경우 헤더는 여전히 유효해야 하며 만료되거나 취소될 수 없습니다.
PFAuthenticationLoginResult PFAuthenticationLoginResult 데이터 모델.
PFAuthenticationLoginWithAppleRequest PFAuthenticationLoginWithAppleRequest 데이터 모델.
PFAuthenticationLoginWithCustomIDRequest PFAuthenticationLoginWithCustomIDRequest 데이터 모델입니다. 개발자는 한 고객이 다른 고객이 이미 사용 중인 ID를 생성할 가능성이 매우 낮음을 확인하는 것이 좋습니다. 사용자가 사용자 지정 ID로 처음 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 만들어지고 사용자 지정 ID에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않고 PlayFab 계정이 사용자 지정 ID에 연결되어 있지 않으면 이를 나타내는 오류가 반환되어 타이틀이 PlayFab 계정 생성을 통해 사용자를 안내할 수 있습니다.
PFAuthenticationLoginWithFacebookRequest PFAuthenticationLoginWithFacebookRequest 데이터 모델. Facebook 사용자 액세스 토큰을 사용하여 Facebook 로그인을 수행합니다. 토큰에 대한 자세한 내용은 Facebook 개발자 설명서에서 확인할 수 있습니다 (https://developers.facebook.com/docs/facebook-login/access-tokens/). 예를 들어 Unity에서 토큰은 Facebook SDK ScriptableObject FB에서 AccessToken으로 사용할 수 있습니다. 사용자가 Facebook 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 생성되어 제공된 계정의 Facebook ID에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않으면 Facebook 계정에 연결된 PlayFab 계정이 없는 경우 이를 나타내는 오류가 반환되므로 타이틀이 사용자에게 PlayFab 계정 만들기를 안내할 수 있습니다. Facebook은 애플리케이션당 고유한 사용자 ID를 제공하므로 타이틀은 PlayFab 타이틀 ID 간에 동일한 Facebook 애플리케이션을 다시 사용하면 안 됩니다. 이렇게 하면 PlayFab 계정 정보에서 사용자의 Facebook ID에 문제가 발생할 수 있습니다. 새 PlayFab 타이틀 ID에서 애플리케이션을 다시 사용해야 하는 경우 먼저 Facebook에서 모든 계정의 연결을 해제하거나 첫 번째 타이틀 ID에서 모든 사용자를 삭제하세요.
PFAuthenticationLoginWithGameCenterRequest PFAuthenticationLoginWithGameCenterRequest 데이터 모델. Game Center 플레이어 식별자(https://developer.apple.com/library/ios/documentation/Accounts/Reference/ACAccountClassRef/index.html# // apple_ref/occ/instp/ACAccount/identifier)는 로컬 장치에 저장되는, 생성된 문자열입니다. 장치 식별자와 마찬가지로, 사용자의 계정이 노출될 수 있으므로, 플레이어의 Game Center 식별자가 최종 사용자에게 노출되지 않도록 주의해야 합니다. 사용자의 Game Center로 처음 로그인이며 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Game Center 식별자에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않으면 Game Center 계정에 연결된 PlayFab 계정이 없는 경우 이를 나타내는 오류가 반환되어 타이틀에서 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있습니다. 잘못된 iOS Game Center 플레이어 식별자를 사용하면 이를 나타내는 오류가 반환됩니다.
PFAuthenticationLoginWithGoogleAccountRequest PFAuthenticationLoginWithGoogleAccountRequest 데이터 모델. Google 로그인은 디바이스에서 Android API용 Google 로그인을 사용하여 Google OAuth 2.0 자격 증명을 획득하고 이 API에 전달하여 수행됩니다. 사용자가 Google 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 생성되고 Xbox Live 계정에 연결됩니다. 그렇지 않으면 Google 계정에 연결된 PlayFab 계정이 없으면 타이틀이 사용자에게 PlayFab 계정 생성을 안내할 수 있도록 이를 나타내는 오류가 반환됩니다. Android 애플리케이션에서 Google 계정 사용자 인증 정보를 얻기 위한 현재(권장) 방법은 GoogleSignInAccount.getServerAuthCode()를 호출하고 인증 코드를 이 API의 ServerAuthCode 매개변수로 전송하는 것입니다. 이렇게 하려면 먼저 Google API 콘솔에서 OAuth 2.0 웹 응용 프로그램 클라이언트 ID를 만들고 해당 타이틀의 PlayFab 게임 관리자 Google 추가 기능에서 클라이언트 ID와 암호를 구성해야 합니다. 이 방법은 사용자에게 추가 Google 계정 권한을 요청할 필요가 없으므로 마찰을 최소화하는 사용자 환경을 만듭니다. https://developers.google.com/identity/sign-in/android/offline-access에서 서버 인증 코드를 받는 방법을 자세히 알아보세요. 이전(더 이상 사용되지 않음) 메서드는 클라이언트에서 GetAccessToken()을 호출하고 이 API에 AccessToken 매개변수로 전달하여 OAuth 액세스 토큰을 얻는 것이었습니다. Google OAuth 2.0 액세스 토큰을 사용할 수 있습니다. 이 변경에 대한 자세한 내용은 Google 개발자 설명서(https://android-developers.googleblog.com/2016/01/play-games-permissions-are-changing-in.html)에서 확인할 수 있습니다.
PFAuthenticationLoginWithGooglePlayGamesServicesRequest PFAuthenticationLoginWithGooglePlayGamesServicesRequest 데이터 모델. Google Play Games 로그인은 디바이스에서 Android API용 Google Play Games 로그인을 사용하여 Google OAuth 2.0 자격 증명을 획득하고 이 API에 전달하여 수행됩니다. 사용자가 Google Play 게임 계정으로 로그인한 것이 처음이고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Google Play 게임 계정과 연결됩니다. 그렇지 않으면, Google Play 게임 계정에 연결된 PlayFab 계정이 없는 경우 이를 나타내는 오류가 반환되어 타이틀에서 사용자에게 PlayFab 계정 생성을 안내할 수 있습니다. Android 응용 프로그램에서 Google Play 게임 계정의 자격 증명을 가져오는 현재(권장) 방법은 GamesSignInClient.requestServerSideAccess()를 호출하고 이 API의 ServerAuthCode 매개 변수로 인증 코드를 보내는 것입니다. 이렇게 하려면 먼저 Google API 콘솔에서 OAuth 2.0 웹 응용 프로그램 클라이언트 ID를 만들고 해당 타이틀의 PlayFab 게임 관리자 Google 추가 기능에서 클라이언트 ID와 암호를 구성해야 합니다. 이 방법은 사용자에게 추가 Google 계정 권한을 요청할 필요가 없으므로 마찰을 최소화하는 사용자 환경을 만듭니다. https://developers.google.com/games/services/android/signin에서 서버 인증 코드를 받는 방법을 자세히 알아보세요.
PFAuthenticationLoginWithNintendoServiceAccountRequest PFAuthenticationLoginWithNintendoServiceAccountRequest 데이터 모델입니다.
PFAuthenticationLoginWithOpenIdConnectRequest PFAuthenticationLoginWithOpenIdConnectRequest 데이터 모델입니다.
PFAuthenticationLoginWithPSNRequest PFAuthenticationLoginWithPSNRequest 데이터 모델입니다. 사용자가 PlayStation ™️ 네트워크 계정으로 처음으로 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 만들어지고 PlayStation ™️ 네트워크 계정에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않고 PlayFab 계정이 PlayStation ™️ 네트워크 계정에 연결되어 있지 않으면 타이틀이 PlayFab 계정 생성을 통해 사용자를 안내할 수 있도록 이를 나타내는 오류가 반환됩니다.
PFAuthenticationLoginWithServerCustomIdRequest PFAuthenticationLoginWithServerCustomIdRequest 데이터 모델.
PFAuthenticationLoginWithSteamIdRequest PFAuthenticationLoginWithSteamIdRequest 데이터 모델입니다. 사용자가 Steam ID로 처음으로 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 만들어지고 Steam 계정에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않으면 Steam 계정에 연결된 PlayFab 계정이 없으면 타이틀이 사용자에게 PlayFab 계정 생성을 안내할 수 있도록 이를 나타내는 오류가 반환됩니다. Steam 클라이언트 앱에 로그인하지 않은 Steam 사용자는 Steam 사용자 이름만 동기화되며, 클라이언트가 열려 있는 동안 로그인할 때까지 통화 및 국가와 같은 다른 데이터를 사용할 수 없습니다.
PFAuthenticationLoginWithSteamRequest PFAuthenticationLoginWithSteamRequest 데이터 모델입니다. Steam 로그인은 Steam 세션 티켓으로 수행됩니다. 티켓에 대한 자세한 내용은 Steamworks SDK(https://partner.steamgames.com/documentation/auth)에서 확인할 수 있습니다. 참고: Steam 인증이 작동하려면 PlayFab 게임 관리자(추가 기능 Marketplace의 Steam 아래)에서 Steam 애플리케이션 ID 및 웹 API 키를 사용하여 타이틀을 구성해야 합니다. Steamworks 사이트의 앱 ID와 연결된 모든 그룹의 사용 권한 페이지에서 Web API 키를 가져올 수 있습니다. 사용자가 Steam 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 만들어지고 제공된 계정의 Steam ID에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않으면 Steam 계정에 연결된 PlayFab 계정이 없으면 타이틀이 사용자에게 PlayFab 계정 생성을 안내할 수 있도록 이를 나타내는 오류가 반환됩니다.
PFAuthenticationLoginWithXboxIdRequest PFAuthenticationLoginWithXboxIdRequest 데이터 모델입니다. 사용자가 Xbox ID로 처음으로 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 만들어지고 Xbox Live 계정에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않고 PlayFab 계정이 Xbox Live 계정에 연결되어 있지 않으면 타이틀이 PlayFab 계정 생성을 통해 사용자를 안내할 수 있도록 이를 나타내는 오류가 반환됩니다.
PFAuthenticationLoginWithXboxRequest PFAuthenticationLoginWithXboxRequest 데이터 모델입니다. 사용자가 Xbox Live 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 생성되고 Xbox Live 계정에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않고 PlayFab 계정이 Xbox Live 계정에 연결되어 있지 않으면 타이틀이 PlayFab 계정 생성을 통해 사용자를 안내할 수 있도록 이를 나타내는 오류가 반환됩니다.
PFAuthenticationLoginWithXUserRequest PFAuthenticationLoginWithXUserRequest 데이터 모델. 사용자가 Xbox Live 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 생성되고 Xbox Live 계정에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않고 PlayFab 계정이 Xbox Live 계정에 연결되어 있지 않으면 타이틀이 PlayFab 계정 생성을 통해 사용자를 안내할 수 있도록 이를 나타내는 오류가 반환됩니다. PFAuthenticationLoginWithXUserAsync에 대한 요청 개체입니다.
PFAuthenticationServerLoginWithXboxRequest PFAuthenticationServerLoginWithXboxRequest 데이터 모델. 사용자가 Xbox Live 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 생성되고 Xbox Live 계정에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않고 PlayFab 계정이 Xbox Live 계정에 연결되어 있지 않으면 타이틀이 PlayFab 계정 생성을 통해 사용자를 안내할 수 있도록 이를 나타내는 오류가 반환됩니다.
PFAuthenticationUserSettings PFAuthenticationUserSettings 데이터 모델입니다.
PFAuthenticationValidateEntityTokenRequest PFAuthenticationValidateEntityTokenRequest 데이터 모델. 엔터티 토큰이 지정된 경우 만료되지 않았거나 해지되었는지 확인하고 소유자의 세부 정보를 반환합니다.
PFAuthenticationValidateEntityTokenResponse PFAuthenticationValidateEntityTokenResponse 데이터 모델입니다.

상태 변경

상태 변경 설명

열거형

열거형 설명
PFAuthenticationIdentifiedDeviceType IdentifiedDeviceType 열거형입니다.