Início rápido de Python

• Como uma ferramenta de administração de console autônoma para manter seu jogo.
• Integrado a um mecanismo de jogo existente baseado em Python.
  • Para obter uma lista de mecanismos de jogo em Python, consulte PythonGameLibraries no site python.org.

​

Pré-requisitos

• Uma conta de desenvolvedor do PlayFab.
• Python 3 instalado no seu sistema.
  • Você também precisa ter o módulo requests instalado.

​

Configuração do projeto Python

1. Em um prompt de comando, instale o pacote do PlayFab usando o comando a seguir.

pip install playfab

python -m pip install playfab

2. No diretório do projeto, crie um script Python chamado playfab_test.py.

​

Configurar sua primeira chamada à API

from playfab import PlayFabClientAPI, PlayFabSettings

PlayFabSettings.TitleId = "144"

request = {
    "CustomId": "GettingStartedGuide",
    "CreateAccount": True
}

def callback(success, failure):
    if success:
        print("Congratulations, you made your first successful API call!")
    else:
        print("Something went wrong with your first API call.  :(")
        if failure:
            print("Here's some debug information:")
            print(failure.GenerateErrorReport())
PlayFabClientAPI.LoginWithCustomID(request, callback)

​

Concluir e executar

python playfab_test.py

​

Desconstruir o código

• Importações
  • As importações do PlayFab dão acesso às APIs.
• PlayFabSettings.TitleId = "144"
  • 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.
• request
  • 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 dicionário.
    • LoginWithCustomIDRequest recebe um parâmetro obrigatório CustomId, que identifica um jogador de forma exclusiva e retorna o token de entidade associado, 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
• Callback
  • Success
    • Se a chamada à API tiver sido bem-sucedida, success conterá as informações solicitadas e failure será None.
    • Para requisições de logon, success conterá 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.
  • Failure
    • Se a chamada à API não tiver sido bem-sucedida, failure conterá algumas informações de erro e success será None.
    • 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á.
      • 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.
• PlayFabClientAPI.LoginWithCustomID
  • Dispara a chamada à API de forma síncrona. Quando ela for concluída, o callback será invocado.