Início rápido de Java para Native e Android Studio

• Obter os arquivos JAR necessários.
• Adicionar os arquivos JAR ao classpath.
• Criar um aplicativo de console Java mínimo que execute a chamada à API de logon com Custom ID.

​

Obter os arquivos JAR necessários

​

Configuração do projeto com o Intellij Idea

​

Configuração do projeto com qualquer IDE

​

Configurar sua primeira chamada à API

import java.util.concurrent.*;
import java.util.*;

import com.playfab.PlayFabErrors.*;
import com.playfab.PlayFabSettings;
import com.playfab.PlayFabClientModels;
import com.playfab.PlayFabClientAPI;

public class Main
{
    private static boolean _running = true;

    public static void main(String[] args) {
        PlayFabSettings.TitleId = "144";

        PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();
        request.CustomId = "GettingStartedGuide";
        request.CreateAccount = true;

        FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
        loginTask.run();

        while (_running) {
            if (loginTask.isDone()) { // You would probably want a more sophisticated way of tracking pending async API calls in a real game
                OnLoginComplete(loginTask);
            }

            // Presumably this would be your main game loop, doing other things
            try {
                Thread.sleep(1);
            } catch(Exception e) {
                System.out.println("Critical error in the example main loop: " + e);
            }
        }
    }

    private static void OnLoginComplete(FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask) {
        PlayFabResult<com.playfab.PlayFabClientModels.LoginResult> result = null;
        try {
            result = loginTask.get(); // Wait for the result from the async call
        } catch(Exception e) {
            System.out.println("Exception in PlayFab api call: " + e); // Did you assign your PlayFabSettings.TitleId correctly?
        }

        if (result != null && result.Result != null) {
            System.out.println("Congratulations, you made your first successful API call!");
        } else if (result != null && result.Error != null) {
            System.out.println("Something went wrong with your first API call.");
            System.out.println("Here's some debug information:");
            System.out.println(CompileErrorsFromResult(result));
        }

        _running = false; // Because this is just an example, successful login triggers the end of the program
    }

    // This is a utility function we haven't put into the core SDK yet. Feel free to use it.
    private static <RT> String CompileErrorsFromResult(PlayFabResult<RT> result) {
        if (result == null || result.Error == null)
            return null;

        String errorMessage = "";
        if (result.Error.errorMessage != null)
            errorMessage += result.Error.errorMessage;
        if (result.Error.errorDetails != null)
            for (Map.Entry<String, List<String>> pair : result.Error.errorDetails.entrySet() )
                for (String msg : pair.getValue())
                    errorMessage += "\n" + pair.getKey() + ": " + msg;
        return errorMessage;
    }
}

​

Concluir e executar

1. Selecione a seta de reprodução > no canto superior direito. Isso iniciará a execução do programa, e o painel de saída será exibido.
2. Localize a mensagem de depuração. Ela indica que a chamada à API foi bem-sucedida.

​

Desconstruir o código

• Imports
  • Este é o conjunto mínimo de imports usado para fazer chamadas à API do PlayFab.
• public static void main(String[] args) {
  • Apenas um loop básico que inicia uma chamada à API e aguarda sua conclusão.
  • PlayFabSettings.TitleId = "xxxx";
    • Todo desenvolvedor do PlayFab cria um título no Game Manager. Ao publicar seu jogo, você precisa codificar esse titleId no jogo. Isso permite que o cliente saiba como acessar os dados corretos no PlayFab. Para a maioria dos usuários, basta considerar isso uma etapa obrigatória para que o PlayFab funcione.
  • PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();
    • A maioria dos métodos da API do PlayFab exige parâmetros de entrada, e esses parâmetros são empacotados em um objeto de requisição.
    • Cada método da API exige um objeto de requisição exclusivo, com uma combinação de parâmetros opcionais e obrigatórios.
      • Para LoginWithCustomIDRequest, há um parâmetro obrigatório CustomId, que identifica um jogador de forma exclusiva, e CreateAccount, que permite a criação de uma nova conta com essa chamada.
    • Para o logon, a maioria dos desenvolvedores vai querer usar um método de logon mais adequado.
      • Consulte a documentação de logon do PlayFab para obter uma lista de todos os métodos de logon e parâmetros de entrada. As opções comuns são:
        • LoginWithAndroidDeviceID
        • LoginWithIOSDeviceID
        • LoginWithEmailAddress
  • FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
    • Isso inicia a requisição assíncrona para LoginWithCustomID, usando o framework FutureTask do Java.
  • While (running) { if (loginTask.isDone()) { OnLoginComplete(loginTask); } }
    • Executa um loop principal trivial e aguarda de forma assíncrona a conclusão do loginTask.
    • Ao terminar, chama OnLoginComplete.
• OnLoginComplete (loginTask)
  • result = loginTask.get();
    • Busca o resultado assíncrono (isso não causará bloqueio, porque confirmamos que o FutureTask já foi concluído).
  • Se (result.Result != null), a chamada à API foi bem-sucedida.
    • Em caso de sucesso, o objeto result.Result de muitos callbacks de API conterá as informações solicitadas.
    • LoginResult contém especificamente algumas informações básicas sobre o jogador. Mas, para a maioria dos usuários, o logon é simplesmente uma etapa obrigatória antes de chamar outras APIs.
  • Se (result.Error != null), a chamada à API falhou.
    • As chamadas à API podem falhar por vários motivos, e você deve sempre tentar tratar a falha.
    • Por que as chamadas à API falham (em ordem de probabilidade)
      • PlayFabSettings.TitleId não está definido. Se você se esquecer de definir TitleId para o seu título, nada funcionará.
      • Parâmetros da requisição. Se você não tiver fornecido as informações corretas ou obrigatórias para uma determinada chamada à API, ela falhará. Consulte error.errorMessage, error.errorDetails ou error.GenerateErrorReport() para obter mais informações.
      • Problema de conectividade do dispositivo. Celulares perdem e recuperam a conectividade constantemente, portanto qualquer chamada à API pode falhar aleatoriamente a qualquer momento e funcionar logo em seguida. Entrar em um túnel pode desconectar você completamente.
      • Problema no servidor do PlayFab. Como em qualquer software, podem ocorrer problemas. Consulte nossas notas de versão para obter atualizações.
      • A internet não é 100% confiável. Às vezes, a mensagem é corrompida ou não chega ao servidor do PlayFab.
  • Se você estiver com dificuldades para depurar um problema e as informações do erro não forem suficientes, visite nossos fóruns.