Configurar a autenticação do PlayFab usando Facebook e Unity

​

Requisitos

• Unity 5+ e um projeto criado.
• Conta do Facebook para testes.
• SDK do Facebook importado no projeto.
• Título do PlayFab registrado.
• SDK do PlayFab importado no projeto com uma referência de título configurada.
• Familiaridade com os conceitos básicos e práticas recomendadas de login.

​

Implementação

​

Registrar um aplicativo do Facebook

1. Passe o mouse sobre o botão My Apps.
2. Selecione Add a New App, conforme mostrado na imagem abaixo.

1. Insira um nome para seu Application.
2. Insira um Contact Email.

1. Navegue até a guia Settings.
2. Em seguida, vá para a subguia Basic.
3. Localize seu Application ID.
   • Copie-o para um local seguro e de fácil acesso. Ele será usado mais tarde para configurar o SDK do Facebook.

1. Localize seu App na lista.
2. Verifique se ele tem um User Token atribuído.

1. Na página Application Manager, navegue até + Add Products.
2. Localize a entrada Facebook Login e selecione Get Started.

1. Certifique-se de que a página Settings do produto Login esteja aberta.
2. Verifique se Client OAuth e Web OAuth estão ativados.

​

Configurar o SDK do Facebook

1. Selecione Facebook no menu de arquivos.
2. Em seguida, selecione Edit Settings.

• Insira seu Application ID no campo correspondente, conforme mostrado na imagem a seguir.

​

Script de autenticação simples

1. Crie um script chamado PlayfabFacebookAuthExample.cs.
2. Adicione-o ao Game Object, conforme mostrado na imagem abaixo.

// Import statements introduce all the necessary classes for this example.
using Facebook.Unity;
using PlayFab;
using PlayFab.ClientModels;
using UnityEngine;
using LoginResult = PlayFab.ClientModels.LoginResult;

public class PlayfabFacebookAuthExample : MonoBehaviour
{
    // holds the latest message to be displayed on the screen
    private string _message;

    public void Start()
    {
        SetMessage("Initializing Facebook..."); // logs the given message and displays it on the screen using OnGUI method

        // This call is required before any other calls to the Facebook API. We pass in the callback to be invoked once initialization is finished
        FB.Init(OnFacebookInitialized);  

    }

    private void OnFacebookInitialized()
    {
        SetMessage("Logging into Facebook...");

        // Once Facebook SDK is initialized, if we are logged in, we log out to demonstrate the entire authentication cycle.
        if (FB.IsLoggedIn)
            FB.LogOut();

        // We invoke basic login procedure and pass in the callback to process the result
        FB.LogInWithReadPermissions(null, OnFacebookLoggedIn);
    }

    private void OnFacebookLoggedIn(ILoginResult result)
    {
        // If result has no errors, it means we have authenticated in Facebook successfully
        if (result == null || string.IsNullOrEmpty(result.Error))
        {
            SetMessage("Facebook Auth Complete! Access Token: " + AccessToken.CurrentAccessToken.TokenString + "\nLogging into PlayFab...");

            /*
             * We proceed with making a call to PlayFab API. We pass in current Facebook AccessToken and let it create
             * and account using CreateAccount flag set to true. We also pass the callback for Success and Failure results
             */
            PlayFabClientAPI.LoginWithFacebook(new LoginWithFacebookRequest { CreateAccount = true, AccessToken = AccessToken.CurrentAccessToken.TokenString},
                OnPlayfabFacebookAuthComplete, OnPlayfabFacebookAuthFailed);
        }
        else
        {
            // If Facebook authentication failed, we stop the cycle with the message
            SetMessage("Facebook Auth Failed: " + result.Error + "\n" + result.RawResult, true);
        }
    }

    // When processing both results, we just set the message, explaining what's going on.
    private void OnPlayfabFacebookAuthComplete(LoginResult result)
    {
        SetMessage("PlayFab Facebook Auth Complete. Session ticket: " + result.SessionTicket);
    }

    private void OnPlayfabFacebookAuthFailed(PlayFabError error)
    {
        SetMessage("PlayFab Facebook Auth Failed: " + error.GenerateErrorReport(), true);
    }

    public void SetMessage(string message, bool error = false)
    {
        _message = message;
        if (error)
            Debug.LogError(_message);
        else
            Debug.Log(_message);
    }

    public void OnGUI()
    {
        var style = new GUIStyle { fontSize = 40, normal = new GUIStyleState { textColor = Color.white }, alignment = TextAnchor.MiddleCenter, wordWrap = true };
        var area = new Rect(0,0,Screen.width,Screen.height);
        GUI.Label(area, _message,style);
    }
}

​

Testes

​

Executar o aplicativo no editor

1. Selecione o botão Play. Depois que o Facebook for inicializado (e uma chamada de autenticação for feita), uma caixa de diálogo de autenticação do Facebook aparecerá na visualização do jogo.
2. Insira o User Token.
3. Selecione o botão Send Success, conforme mostrado na imagem a seguir.

• Verifique a saída do console. Ela deve exibir nossas instruções de depuração, conforme mostrado na imagem abaixo.
• Se você não vir erros, isso significa que a autenticação foi bem-sucedida.

​

Executar o aplicativo no Android

• Primeiro, certifique-se de que a plataforma Android esteja selecionada e que o Package ID exclusivo esteja definido (conforme indicado no exemplo abaixo).

1. Navegue até as configurações Basic.
2. Selecione + Add Platform, conforme indicado no exemplo fornecido abaixo.

• Em seguida, selecione Android na lista de plataformas disponíveis.

• Preencha seu Package ID.
• Selecione Save (o botão Save fica oculto no canto inferior direito da página).

• O aplicativo deve recebê-lo com uma página de entrada do Facebook.
• Depois de entrar, observe a mensagem na tela à medida que ela muda.
• Por fim, você deverá ver uma mensagem indicando a autenticação bem-sucedida no PlayFab. Todo o procedimento é ilustrado no exemplo fornecido abaixo.

​

Executar o aplicativo no iOS

• Primeiro, certifique-se de que a plataforma iOS esteja selecionada.
• Em seguida, defina um Bundle ID exclusivo, conforme indicado no exemplo fornecido abaixo.
• Certifique-se de criar seu próprio Package ID exclusivo.

1. Navegue até as configurações Basic.
2. Selecione + Add Platform, conforme indicado no exemplo fornecido abaixo.

• Selecione iOS na lista de plataformas disponíveis.

• Preencha seu Package ID.
• Selecione o botão Save (o botão Save fica oculto no canto inferior direito da página).

• Em seguida, compile o aplicativo como de costume.
• Depois disso, abra o Project usando o XCode.

• Selecione o Project para abrir Project Settings.
• Verifique se o Bundle ID corresponde ao seu Package ID exclusivo.

• Certifique-se de selecionar o dispositivo correto.

• E selecione o Identity Team correto.

• Depois de iniciado, o aplicativo permitirá que você faça login no Facebook usando o navegador da Web.
• Depois disso, a autenticação do PlayFab será invocada e uma mensagem indicará o resultado.

​

Verificar pelo Game Manager do PlayFab

• Navegue até o painel.
• Consulte o painel PlayStream Debugger para verificar os eventos mais recentes. Você deverá ver o evento de autenticação do Facebook, conforme exibido no exemplo a seguir.