Visão geral da API C do Services - PFAuthenticationTypes.h - XBOX Game Development Documentation

Estruturas

Estrutura	Descrição
PFAuthenticationLoginWithXUserRequest	Modelo de dados de PFAuthenticationLoginWithXUserRequest. Se esta for a primeira vez que um usuário entra com a conta do XBOX Live e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta do XBOX Live. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do XBOX Live, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab. Objeto de solicitação para PFAuthenticationLoginWithXUserAsync.
PFAuthenticationAuthenticateCustomIdRequest	Modelo de dados de PFAuthenticationAuthenticateCustomIdRequest. Cria ou retorna um token de entidade game_server. O chamador deve ser uma entidade de título.
PFAuthenticationAuthenticateCustomIdResult	Modelo de dados de PFAuthenticationAuthenticateCustomIdResult.
PFAuthenticationDeleteRequest	Modelo de dados de PFAuthenticationDeleteRequest. Exclui uma entidade game_server. O chamador pode ser a entidade game_server tentando excluir a si mesma. Ou uma entidade de título tentando excluir entidades game_server deste título.
PFAuthenticationEntityTokenResponse	Modelo de dados de PFAuthenticationEntityTokenResponse.
PFAuthenticationGetEntityRequest	Modelo de dados de PFAuthenticationGetEntityRequest. Esta API deve ser chamada com os cabeçalhos X-SecretKey, X-Authentication ou X-EntityToken. O cabeçalho ainda deve ser válido e não pode estar expirado nem revogado. Se for bem-sucedida, ela emitirá um novo token de entidade e disparará o evento do PlayStream “entity_logged_in”.
PFAuthenticationLoginResult	Modelo de dados de PFAuthenticationLoginResult.
PFAuthenticationLoginWithAppleRequest	Modelo de dados de PFAuthenticationLoginWithAppleRequest.
PFAuthenticationLoginWithBattleNetRequest	Modelo de dados de PFAuthenticationLoginWithBattleNetRequest.
PFAuthenticationLoginWithCustomIDRequest	Modelo de dados de PFAuthenticationLoginWithCustomIDRequest. É altamente recomendável que os desenvolvedores garantam que seja extremamente improvável que um cliente consiga gerar uma ID que já esteja em uso por outro cliente. Se esta for a primeira vez que um usuário entra com a Custom ID e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à Custom ID. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à Custom ID, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationLoginWithFacebookRequest	Modelo de dados de PFAuthenticationLoginWithFacebookRequest. A entrada com o Facebook é realizada usando o Facebook User Access Token. Mais informações sobre o token podem ser encontradas na documentação para desenvolvedores do Facebook (https://developers.facebook.com/docs/facebook-login/access-tokens/). No Unity, por exemplo, o token está disponível como AccessToken no ScriptableObject FB do SDK do Facebook. Se esta for a primeira vez que um usuário entra com a conta do Facebook e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à Facebook ID da conta fornecida. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do Facebook, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab. Observe que os títulos nunca devem reutilizar os mesmos aplicativos do Facebook entre Title IDs do PlayFab, pois o Facebook fornece IDs de usuário exclusivas por aplicativo, e fazer isso pode resultar em problemas com a Facebook ID do usuário nas informações da conta do PlayFab. Se você precisar reutilizar um aplicativo em uma nova Title ID do PlayFab, primeiro desvincule todas as contas do Facebook ou exclua todos os usuários da primeira Title ID. Observação: se o usuário for autenticado com AuthenticationToken, em vez de AccessToken, a API GetFriendsList retornará uma lista vazia.
PFAuthenticationLoginWithGameCenterRequest	Modelo de dados de PFAuthenticationLoginWithGameCenterRequest. O identificador de jogador do Game Center (https://developer.apple.com/library/ios/documentation/Accounts/Reference/ACAccountClassRef/index.html# // apple_ref/occ/instp/ACAccount/identifier) é uma cadeia de caracteres gerada que é armazenada no dispositivo local. Assim como acontece com os identificadores de dispositivo, deve-se tomar cuidado para nunca expor o identificador do Game Center de um jogador aos usuários finais, pois isso pode resultar no comprometimento da conta de um usuário. Se esta for a primeira vez que um usuário entra com o Game Center e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada ao identificador do Game Center. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do Game Center, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab. Se um identificador de jogador do Game Center do iOS inválido for usado, um erro indicando isso será retornado.
PFAuthenticationLoginWithGoogleAccountRequest	Modelo de dados de PFAuthenticationLoginWithGoogleAccountRequest. A entrada com o Google é realizada obtendo uma credencial do Google OAuth 2.0 usando as APIs de entrada do Google para Android no dispositivo e passando-a para esta API. Se esta for a primeira vez que um usuário entra com a conta do Google e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta do Google. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do Google, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab. O método atual (recomendado) para obter uma credencial de conta do Google em um aplicativo Android é chamar GoogleSignInAccount.getServerAuthCode() e enviar o código de autenticação como o parâmetro ServerAuthCode desta API. Antes de fazer isso, você deve criar uma ID do cliente de aplicativo Web OAuth 2.0 no Google API Console e configurar a ID do cliente e o segredo no Google Add-on do PlayFab Game Manager para o seu título. Esse método não exige que o usuário seja solicitado a conceder permissões adicionais da conta do Google, resultando em uma experiência do usuário com o mínimo de atrito possível. Para obter mais informações sobre como obter o código de autenticação do servidor, consulte https://developers.google.com/identity/sign-in/android/offline-access. O método anterior (preterido) era obter um token de acesso OAuth chamando GetAccessToken() no cliente e passando-o como o parâmetro AccessToken para esta API. para o com o Google OAuth 2.0 Access Token. Mais informações sobre essa alteração podem ser encontradas na documentação para desenvolvedores do Google (https://android-developers.googleblog.com/2016/01/play-games-permissions-are-changing-in.html).
PFAuthenticationLoginWithGooglePlayGamesServicesRequest	Modelo de dados de PFAuthenticationLoginWithGooglePlayGamesServicesRequest. A entrada com o Google Play Games é realizada obtendo uma credencial do Google OAuth 2.0 usando as APIs de entrada do Google Play Games para Android no dispositivo e passando-a para esta API. Se esta for a primeira vez que um usuário entra com a conta do Google Play Games e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta do Google Play Games. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do Google Play Games, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab. O método atual (recomendado) para obter uma credencial de conta do Google Play Games em um aplicativo Android é chamar GamesSignInClient.requestServerSideAccess() e enviar o código de autenticação como o parâmetro ServerAuthCode desta API. Antes de fazer isso, você deve criar uma ID do cliente de aplicativo Web OAuth 2.0 no Google API Console e configurar a ID do cliente e o segredo no Google Add-on do PlayFab Game Manager para o seu título. Esse método não exige que o usuário seja solicitado a conceder permissões adicionais da conta do Google, resultando em uma experiência do usuário com o mínimo de atrito possível. Para obter mais informações sobre como obter o código de autenticação do servidor, consulte https://developers.google.com/games/services/android/signin.
PFAuthenticationLoginWithNintendoServiceAccountRequest	Modelo de dados de PFAuthenticationLoginWithNintendoServiceAccountRequest.
PFAuthenticationLoginWithOpenIdConnectRequest	Modelo de dados de PFAuthenticationLoginWithOpenIdConnectRequest.
PFAuthenticationLoginWithPSNRequest	Modelo de dados de PFAuthenticationLoginWithPSNRequest. Se esta for a primeira vez que um usuário entra com a conta da PlayStation :tm: Network e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta da PlayStation :tm: Network. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta da PlayStation :tm: Network, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationLoginWithServerCustomIdRequest	Modelo de dados de PFAuthenticationLoginWithServerCustomIdRequest.
PFAuthenticationLoginWithSteamIdRequest	Modelo de dados de PFAuthenticationLoginWithSteamIdRequest. Se esta for a primeira vez que um usuário entra com a Steam ID e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta Steam. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta Steam, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab. Os usuários do Steam que não estiverem conectados ao aplicativo Steam Client terão apenas o nome de usuário do Steam sincronizado; outros dados, como moeda e país, não estarão disponíveis até que eles façam logon com o Client aberto.
PFAuthenticationLoginWithSteamRequest	Modelo de dados de PFAuthenticationLoginWithSteamRequest. A entrada com o Steam é realizada com o Steam Session Ticket. Mais informações sobre o tíquete podem ser encontradas no SDK do Steamworks, aqui: https://partner.steamgames.com/documentation/auth. OBSERVAÇÃO: para que a autenticação do Steam funcione, o título deve estar configurado com a Steam Application ID e a Web API Key no PlayFab Game Manager (em Steam, no Add-ons Marketplace). Você pode obter uma Web API Key na página Permissions de qualquer Group associado à sua App ID no site do Steamworks. Se esta for a primeira vez que um usuário entra com a conta Steam e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à Steam ID da conta fornecida. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta Steam, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationLoginWithXboxIdRequest	Modelo de dados de PFAuthenticationLoginWithXboxIdRequest. Se esta for a primeira vez que um usuário entra com a XBOX ID e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta do XBOX Live. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do XBOX Live, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationLoginWithXboxRequest	Modelo de dados de PFAuthenticationLoginWithXboxRequest. Se esta for a primeira vez que um usuário entra com a conta do XBOX Live e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta do XBOX Live. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do XBOX Live, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationServerLoginWithAndroidDeviceIDRequest	Modelo de dados de PFAuthenticationServerLoginWithAndroidDeviceIDRequest. Em dispositivos Android, a recomendação é usar Settings.Secure.ANDROID_ID como AndroidDeviceId, conforme descrito nesta postagem de blog (http://android-developers.blogspot.com/2011/03/identifying-app-installations.html). Mais informações sobre esse identificador podem ser encontradas na documentação do Android (http://developer.android.com/reference/android/provider/Settings.Secure.html). Se esta for a primeira vez que um usuário entra com o dispositivo Android e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à ID do dispositivo Android. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada ao dispositivo Android, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab. Observe que, embora vários dispositivos desse tipo possam ser vinculados a uma única conta de usuário, somente o usado mais recentemente para fazer logon (ou vinculado mais recentemente) será refletido nas informações da conta do usuário. Atualizaremos para mostrar todos os dispositivos vinculados em uma versão futura.
PFAuthenticationServerLoginWithBattleNetRequest	Modelo de dados de PFAuthenticationServerLoginWithBattleNetRequest.
PFAuthenticationServerLoginWithCustomIDRequest	Modelo de dados de PFAuthenticationServerLoginWithCustomIDRequest. É altamente recomendável que os desenvolvedores garantam que seja extremamente improvável que um cliente consiga gerar uma ID que já esteja em uso por outro cliente. Se esta for a primeira vez que um usuário entra com a Custom ID e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à Custom ID. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à Custom ID, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationServerLoginWithIOSDeviceIDRequest	Modelo de dados de PFAuthenticationServerLoginWithIOSDeviceIDRequest. Em dispositivos iOS, o identifierForVendor (https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIDevice_Class/index.html# // apple_ref/occ/instp/UIDevice/identifierForVendor) deve ser usado como DeviceId, pois o uniqueIdentifier de UIDevice foi preterido a partir do iOS 5, e o uso do advertisingIdentifier para essa finalidade resultará em falha no processo de certificação da Apple. Se esta for a primeira vez que um usuário entra com o dispositivo iOS e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à ID do dispositivo iOS específica do fornecedor. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada ao dispositivo iOS, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationServerLoginWithPSNRequest	Modelo de dados de PFAuthenticationServerLoginWithPSNRequest. Se esta for a primeira vez que um usuário entra com a conta da PlayStation :tm: Network e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta da PlayStation :tm: Network. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta da PlayStation :tm: Network, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationServerLoginWithXboxRequest	Modelo de dados de PFAuthenticationServerLoginWithXboxRequest. Se esta for a primeira vez que um usuário entra com a conta do XBOX Live e CreateAccount estiver definido como true, uma nova conta do PlayFab será criada e vinculada à conta do XBOX Live. Nesse caso, nenhum email ou nome de usuário será associado à conta do PlayFab. Caso contrário, se nenhuma conta do PlayFab estiver vinculada à conta do XBOX Live, um erro indicando isso será retornado, para que o título possa orientar o usuário na criação de uma conta do PlayFab.
PFAuthenticationUserSettings	Modelo de dados de PFAuthenticationUserSettings.
PFAuthenticationValidateEntityTokenRequest	Modelo de dados de PFAuthenticationValidateEntityTokenRequest. Dado um token de entidade, valida se ele não expirou nem foi revogado e retorna os detalhes do proprietário.
PFAuthenticationValidateEntityTokenResponse	Modelo de dados de PFAuthenticationValidateEntityTokenResponse.

Alterações de estado

Alteração de estado	Descrição

Enumerações

Enumeração	Descrição
PFAuthenticationIdentifiedDeviceType	Enumeração IdentifiedDeviceType.

Última modificação em 6 de outubro de 2026

Tópicos relacionados

Visão geral da API C do Services - PFAuthentication.h PFAuthenticationLoginWithNintendoServiceAccountRequest PFAuthenticationLoginWithGooglePlayGamesServicesRequest PFAuthenticationIdentifiedDeviceType PFAuthenticationLoginWithPSNRequest

⌘I