Inicio rápido de Lua para Corona

​

Configuración del proyecto de Corona

1. Descargue e instale Corona: https://coronalabs.com/.
2. Ejecute Corona y cree un proyecto nuevo. El siguiente vínculo contiene información que puede ayudarle con los primeros pasos si aún no los ha realizado: https://docs.coronalabs.com/guide/start/installWin/index.html
3. Una vez que haya instalado, iniciado sesión y creado un proyecto nuevo, debería ver varias ventanas con un aspecto similar al del ejemplo que se muestra a continuación.
4. Active el complemento PlayFab Client en Corona Marketplace: https://marketplace.coronalabs.com/plugin/playfab-client
5. La instalación de PlayFab está completa.

​

Configuración de la primera llamada a la API

settings =
{
    -- ADD THESE THREE LINES at the top, leave everything else as-is
    plugins = {
        ["plugin.playfab.client"] = { publisherId = "com.playfab" }
    },

-- Other existing lines...
}

local pfClient = require("plugin.playfab.client")
local PlayFabClientApi = pfClient.PlayFabClientApi
PlayFabClientApi.settings.titleId = "144"

local loginRequest = {
    -- See the API reference for LoginWithCustomID.
    CustomId = "GettingStartedGuide",
    CreateAccount = true
}
PlayFabClientApi.LoginWithCustomID(loginRequest,
    function(result) print("Congratulations, you made your first successful API call!") end,
    function(error) print("Something went wrong with your first API call.\nHere's some debug information:\n" .. error.errorMessage) end
)

​

Finalización y ejecución

​

Análisis del código

• build.settings
  • plugins = {
    • Esto invoca el sistema de complementos de Corona y le indica que descargue e instale complementos de Corona Marketplace en el proyecto
  • ["plugin.playfab.client"] = { publisherId = "com.playfab" }
    • Esto le indica que descargue específicamente el complemento PlayFab Client.
• main.lua
  • Líneas require():
    • Estas son las importaciones mínimas que necesita para realizar llamadas a la API de PlayFab.
  • PlayFabClientApi.settings.titleId = "xxxx"
    • Cada desarrollador de PlayFab crea un título en Game Manager. Cuando publique su juego, debe codificar ese titleId en el juego. Esto permite que el cliente sepa 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.
  • local loginRequest = { CustomId = "GettingStartedGuide", CreateAccount = true }
    • 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 solicitud
    • Cada método de la API requiere un objeto de solicitud único, con una combinación de parámetros opcionales y obligatorios
      • Para LoginWithCustomIDRequest, hay un parámetro obligatorio, CustomId, que identifica de forma única a un jugador, y CreateAccount, que permite crear una cuenta nueva con esta llamada.
  • PlayFabClientApi.LoginWithCustomID(loginRequest, {OnLoginSuccess-function}, {OnLoginError-function})
    • Esto inicia la solicitud asincrónica a LoginWithCustomID, que llamará a la primera devolución de llamada (OnLoginSuccess) si se realiza correctamente, o a la segunda función (OnLoginError) en caso de error.
  • 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 adecuado.
    • 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
    • OnLoginSuccess es cualquier función que acepte un único parámetro (result).
      • El objeto result contendrá la información solicitada, según la API a la que se haya llamado.
      • LoginResult contiene 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.
    • OnLoginError es cualquier función que acepte un único parámetro (error).
      • Las llamadas a la API pueden fallar por muchos motivos, y siempre debe intentar controlar los errores.
      • Motivos por los que 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 necesaria para una llamada a la API concreta, esta fallará. Consulte error.errorMessage, error.errorDetails o error.GenerateErrorReport() para obtener más información.
        • 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 funcionar inmediatamente después. Entrar en un túnel puede desconectarle por completo.
        • Problema del servidor de PlayFab. Como ocurre con todo el software, puede haber problemas. Consulte nuestras notas de la versión para conocer las actualizaciones.
        • Internet no es 100 % confiable. A veces, el mensaje se daña o no llega al servidor de PlayFab.
      • Si tiene dificultades para depurar un problema y la información contenida en el error no es suficiente, visítenos en nuestros foros.