Inicio rápido de Python

• Como una herramienta de administración de consola independiente para el mantenimiento de su juego.
• Integración en un motor de juego existente basado en Python.
  • Para obtener una lista de motores de juego de Python, consulte PythonGameLibraries en el sitio web de python.org.

​

Requisitos previos

• Una cuenta de desarrollador de PlayFab.
• Python 3 instalado en su sistema.
  • También debe tener instalado el módulo requests.

​

Configuración del proyecto de Python

1. Desde un símbolo del sistema, instale el paquete de PlayFab con el siguiente comando.

pip install playfab

python -m pip install playfab

2. En el directorio de su proyecto, cree un script de Python llamado playfab_test.py.

​

Configurar su primera llamada a la 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)

​

Finalizar y ejecutar

python playfab_test.py

​

Análisis del código

• Importaciones
  • Las importaciones de PlayFab le proporcionan acceso a las API.
• PlayFabSettings.TitleId = "144"
  • Cada desarrollador de PlayFab crea un título en Game Manager. Cuando publique su juego, debe codificar ese titleId en su juego. Esto permite al cliente saber cómo acceder a los datos correctos dentro de PlayFab. Para la mayoría de los usuarios, considérelo simplemente un paso obligatorio que hace que PlayFab funcione.
• request
  • La mayoría de los métodos de la API de PlayFab requieren parámetros de entrada, y esos parámetros de entrada se empaquetan en un objeto de diccionario.
    • LoginWithCustomIDRequest toma un parámetro obligatorio de CustomId, que identifica de forma única a un jugador y devuelve el token de entidad asociado, y CreateAccount, que permite la creación de una nueva cuenta con esta llamada.
    • Para el inicio de sesión, la mayoría de los desarrolladores querrán usar un método de inicio de sesión más apropiado.
      • Consulte la documentación de inicio de sesión de PlayFab para obtener una lista de todos los métodos de inicio de sesión y los parámetros de entrada. Las opciones comunes son:
        • LoginWithAndroidDeviceID
        • LoginWithIOSDeviceID
        • LoginWithEmailAddress
• Callback
  • Success
    • Si la llamada a la API se realizó correctamente, success contendrá la información solicitada y failure será None.
    • Para las solicitudes de inicio de sesión, success contendrá información básica sobre el jugador, pero para la mayoría de los usuarios, el inicio de sesión es simplemente un paso obligatorio antes de llamar a otras API.
  • Failure
    • Si la llamada a la API no se realizó correctamente, failure contendrá información de error y success será None.
    • Las llamadas a la API pueden fallar por muchas razones, y siempre debería intentar controlar el error.
    • Por qué fallan las llamadas a la API (en orden de probabilidad)
      • PlayFabSettings.TitleId no está establecido. Si olvida establecer titleId en su título, nada funcionará.
      • Parámetros de la solicitud. Si no ha proporcionado la información correcta o requerida para una llamada a la API en particular, esta fallará.
      • Problema de conectividad del dispositivo. Los teléfonos móviles pierden y recuperan la conectividad constantemente, por lo que cualquier llamada a la API en cualquier momento puede fallar aleatoriamente y luego funcionar inmediatamente después. Entrar en un túnel puede desconectarle por completo.
      • Problema del servidor de PlayFab. Como con todo software, puede haber problemas. Consulte nuestras notas de la versión para obtener actualizaciones.
      • Internet no es 100 % confiable. A veces el mensaje se daña o no llega al servidor de PlayFab.
• PlayFabClientAPI.LoginWithCustomID
  • Desencadena la llamada a la API de forma sincrónica. Cuando se completa, se invoca la devolución de llamada.