Início rápido de Lua para Defold

​

Configuração do projeto Defold

1. Crie uma conta e baixe o Defold, ou entre em https://www.defold.com/ (usa Google O-Auth): https://d.defold.com/stable/.
2. Se você ainda não concluiu o “Getting Started Tutorial” do Defold, faça isso agora.
3. Crie um novo projeto no Defold Dashboard, conforme mostrado abaixo.

4. Execute o Defold e carregue seu novo projeto. Você verá várias janelas parecidas com o exemplo mostrado abaixo.

5. Atualize as configurações do projeto (Project Settings) e inclua o PlayFab nas dependências: https://github.com/PlayFab/LuaSdk/raw/master/Defold/PlayFabClientSdk.zip

6. Selecione: Project -> Fetch Libraries, e você verá uma nova pasta interna do PlayFab, conforme mostrado abaixo.

7. Crie alguns arquivos:
   • main/PfGettingStarted.gui
   • Selecione a pasta “main” -> new -> Gui File -> PfGettingStarted.gui.
   • main/PfGettingStarted.gui_script
   • Selecione a pasta “main” -> new -> Gui Script File -> PfGettingStarted.gui_script.
8. Conecte nossa nova GUI em main.collection.
   • Selecione main.collection para abri-lo.
   • No painel Outline:
     • Selecione Add Game Object (opcionalmente, renomeie para PfGui).
       • Selecione o novo objeto, Add Component From File…
         • PfGettingStarted.gui (criado acima).
   • O painel Outline exibindo main.collection deve ficar parecido com o exemplo mostrado abaixo.

​

Configurar sua primeira chamada à API

1. No editor do Defold, clique duas vezes em PfGettingStarted.gui_script.
2. Isso deve abrir o arquivo para edição de texto.
3. Atualize o conteúdo de PfGettingStarted.gui_script conforme mostrado abaixo.

local PlayFabClientApi = require("PlayFab.PlayFabClientApi")
local IPlayFabHttps = require("PlayFab.IPlayFabHttps")
local PlayFabHttps_Defold = require("PlayFab.PlayFabHttps_Defold")
IPlayFabHttps.SetHttp(PlayFabHttps_Defold) -- Assign the Defold-specific IHttps wrapper

PlayFabClientApi.settings.titleId = "144" -- Please change this value to your own titleId from PlayFab Game Manager

function init(self)
    local loginRequest = {
        -- See the API reference for LoginWithCustomID
        TitleId = PlayFabClientApi.settings.titleId,
        CustomId = "GettingStartedGuide",
        CreateAccount = true
    }
    PlayFabClientApi.LoginWithCustomID(loginRequest, OnLoginSuccess, OnLoginFailed)
end

function OnLoginSuccess(result)
    local pfTestOutput = gui.get_node("pfOutput")
    gui.set_text(pfTestOutput, "Congratulations, you made your first successful API call!")
end

function OnLoginFailed(error)
    local pfTestOutput = gui.get_node("pfOutput")
    local message = "Something went wrong with your first API call.\n"
    local message = message .. "Here's some debug information:\n"
    local message = message .. error.GenerateErrorReport()
    gui.set_text(pfTestOutput, message)
end

4. No editor do Defold, clique com o botão direito em PfGettingStarted.gui -> Open With -> Text Editor. Infelizmente, isso altera uma configuração interna do Defold, então:
   • Abra-o novamente: clique com o botão direito em PfGettingStarted.gui -> Open With -> GUI Editor. Isso restaura o padrão normal.
   • Selecione a guia de edição de texto de PfGettingStarted.gui.
   • Atualize o conteúdo de texto de PfGettingStarted.gui conforme mostrado abaixo.

script: "/main/PfGettingStarted.gui_script"
fonts {
  name: "system_font"
  font: "/builtins/fonts/system_font.font"
}
background_color {
  x: 0.0
  y: 0.0
  z: 0.0
  w: 1.0
}
nodes {
  position {
    x: 100.0
    y: 620.0
    z: 0.0
    w: 1.0
  }
  rotation {
    x: 0.0
    y: 0.0
    z: 0.0
    w: 1.0
  }
  scale {
    x: 1.0
    y: 1.0
    z: 1.0
    w: 1.0
  }
  size {
    x: 1080.0
    y: 520.0
    z: 0.0
    w: 1.0
  }
  color {
    x: 1.0
    y: 1.0
    z: 1.0
    w: 1.0
  }
  type: TYPE_TEXT
  blend_mode: BLEND_MODE_ADD
  text: "Logging in..."
  font: "system_font"
  id: "pfOutput"
  xanchor: XANCHOR_LEFT
  yanchor: YANCHOR_TOP
  pivot: PIVOT_NW
  outline {
    x: 1.0
    y: 1.0
    z: 1.0
    w: 1.0
  }
  shadow {
    x: 1.0
    y: 1.0
    z: 1.0
    w: 1.0
  }
  adjust_mode: ADJUST_MODE_FIT
  line_break: false
  layer: ""
  inherit_alpha: true
  clipping_mode: CLIPPING_MODE_NONE
  clipping_visible: true
  clipping_inverted: false
  alpha: 1.0
  outline_alpha: 1.0
  shadow_alpha: 1.0
  template_node_child: false
  text_leading: 1.0
  text_tracking: 0.0
  size_mode: SIZE_MODE_AUTO
}
material: "/builtins/materials/gui.material"
adjust_reference: ADJUST_REFERENCE_PARENT
max_nodes: 512

​

Concluir e executar

​

Desconstruir o código

• PfGettingStarted.gui
  • Nossas instruções para PfGettingStarted.gui visam a praticidade, não o ensino. Este arquivo é uma definição de GUI que adiciona uma caixa de texto à tela e a vincula ao nosso outro script: PfGettingStarted.gui_script. Normalmente, você NÃO editaria esses arquivos em formato de texto.
  • Para obter instruções adequadas sobre como criar widgets de GUI no Defold, leia este guia:
  • GUI scenes in Defold
• PfGettingStarted.gui_script
  • Instruções require e configuração.
    • PlayFabClientApi permite fazer chamadas à API de cliente — é por isso que você está aqui.
    • IPlayFabHttps e PlayFabHttps_Defold:
      • Os plug-ins do PlayFab para Defold são criados sobre o PlayFab LuaSdk. A linguagem Lua não tem um módulo HTTPS adequado. Cada mecanismo de jogo que usa Lua implementa o seu próprio. Essas duas variáveis informam ao PlayFabSdk como acessar HTTPS. Você só precisa fazer isso uma vez no projeto, na primeira cena. Fora isso, é um código clichê obrigatório
  • PlayFabClientApi.settings.titleId = "144"
    • Todo projeto que usa o PlayFab deve criar um título exclusivo no site do PlayFab, que chamamos de Game Manager. Encontre seu titleId no Game Manager e substitua 144 pelo seu titleId.
  • function init(self)
    • Função do Defold — é chamada quando a GUI é inicializada.
  • local loginRequest = { TitleId = PlayFabClientApi.settings.titleId, CustomId = "GettingStartedGuide", CreateAccount = true }
    • 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
  • PlayFabClientApi.LoginWithCustomID(loginRequest, OnLoginSuccess, OnLoginFailed)
    • Isso executa a chamada à API usando a requisição e fornece funções de callback para as condições de sucesso e falha.
  • function OnLoginSuccess(result)
    • O objeto result de muitos callbacks de sucesso da API conterá as informações solicitadas.
    • LoginResult contém 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.
  • function OnLoginFailed(error)
    • 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
  • local pfTestOutput = gui.get_node("pfOutput")
    • Esta é outra função de GUI do Defold. Ela busca o objeto de GUI pfOutput definido no nosso arquivo PfGettingStarted.gui e atribui a ele o texto a ser exibido ao usuário.