​

Início rápido: biblioteca de cliente do PlayFab para Unreal Engine

• Autenticação de jogadores.
• Gerenciamento de itens virtuais e moeda.
• Criação de recursos sociais, como listas de amigos. Documentação de referência da API | Código-fonte da biblioteca | Unreal Marketplace

​

Pré-requisitos

• Uma conta de desenvolvedor do PlayFab.
• Uma instalação do Visual Studio configurada para a Unreal Engine. Para obter informações sobre como configurar o Visual Studio, consulte Setting Up Visual Studio for Unreal Engine.
• Uma instalação da Unreal Engine. Para obter informações sobre como instalar a Unreal Engine, consulte o guia de instalação da Unreal Engine.
• Uma instalação do plug-in do PlayFab para Unreal. Você pode instalar o plug-in do Unreal no marketplace da Unreal Engine.

​

Criar um projeto do Unreal

1. Em Project Category, selecione Games.
2. Em Select Template, selecione Blank.
3. Em Project Settings, selecione C++ ou Blueprint.
4. Escolha No Starter Content.
5. Escolha um nome para o projeto, como MyProject.

​

Habilitar o plug-in do PlayFab no seu projeto do Unreal

1. No menu Settings, em Game Specific Settings, selecione Plugins.
2. Habilite o plug-in PlayFab e reinicie a Unreal Engine, se necessário.

​

Adicionar o PlayFab como dependência de módulo em C++

1. No menu Exibir, abra o Gerenciador de Soluções, que exibe os arquivos do projeto C++.
2. No Gerenciador de Soluções, navegue até Solution\Games\YourProjectName\Source e abra YourProjectName.Build.cs.
3. Adicione a seguinte linha:
   PrivateDependencyModuleNames.AddRange(new string[] { "PlayFab", "PlayFabCpp", "PlayFabCommon" });
   
4. Salve as alterações.

​

Gerar os arquivos de projeto do Visual Studio necessários

1. Abra uma janela do explorador de arquivos e navegue até a pasta em que os arquivos do projeto estão localizados.
2. Na pasta raiz do projeto, clique com o botão direito do mouse no arquivo YourProjectName.uproject.
3. No menu de contexto, selecione Generate Visual Studio project files.

​

Chamando o PlayFab com C++

​

Criar um novo Actor

1. No menu File, selecione New C++ Class.
2. Em Parent Class, selecione Actor.
3. Nomeie seu Actor como LoginActor. Depois que você cria o Actor, a Unreal Engine abre automaticamente seu ambiente de desenvolvimento C++ e carrega LoginActor.cpp e LoginActor.h.

4. Arraste e solte seu novo Actor LoginActor do Content Browser no painel Viewport. Ele agora aparece no painel “World Outliner”. Se você não vir seu LoginActor, selecione o ícone Show or hide the source panel. Em seguida, selecione o nome do seu projeto em C++ classes.

​

Adicionar chamadas à API do PlayFab ao seu LoginActor em C++

1. Substitua o conteúdo de LoginActor.h pelo código mostrado:

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "PlayFab.h"
#include "Core/PlayFabError.h"
#include "Core/PlayFabClientDataModels.h"
#include "LoginActor.generated.h"

UCLASS()
class ALoginActor : public AActor
{
    GENERATED_BODY()
public:
    ALoginActor();
    virtual void BeginPlay() override;
    void OnSuccess(const PlayFab::ClientModels::FLoginResult& Result) const;
    void OnError(const PlayFab::FPlayFabCppError& ErrorResult) const;

    virtual void Tick(float DeltaSeconds) override;
private:
    PlayFabClientPtr clientAPI = nullptr;
};

2. Substitua o conteúdo de LoginActor.cpp pelo código a seguir.

#include "LoginActor.h"
#include "Core/PlayFabClientAPI.h"

ALoginActor::ALoginActor()
{
    PrimaryActorTick.bCanEverTick = true;
}

void ALoginActor::BeginPlay()
{
    Super::BeginPlay();
    
    GetMutableDefault<UPlayFabRuntimeSettings>()->TitleId = TEXT("144");
    
    clientAPI = IPlayFabModuleInterface::Get().GetClientAPI();

    PlayFab::ClientModels::FLoginWithCustomIDRequest request;
    request.CustomId = TEXT("GettingStartedGuide");
    request.CreateAccount = true;

    clientAPI->LoginWithCustomID(request,
        PlayFab::UPlayFabClientAPI::FLoginWithCustomIDDelegate::CreateUObject(this, &ALoginActor::OnSuccess),
        PlayFab::FPlayFabErrorDelegate::CreateUObject(this, &ALoginActor::OnError)
    );
}

void ALoginActor::OnSuccess(const PlayFab::ClientModels::FLoginResult& Result) const
{
    UE_LOG(LogTemp, Log, TEXT("Congratulations, you made your first successful API call!"));
}

void ALoginActor::OnError(const PlayFab::FPlayFabCppError& ErrorResult) const
{
    UE_LOG(LogTemp, Error, TEXT("Something went wrong with your first API call.\nHere's some debug information:\n%s"), *ErrorResult.GenerateErrorReport());
}

void ALoginActor::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);
}

​

Concluir e executar com C++

1. Exiba o Output Log: no menu Windows, selecione Developer Tools e habilite Output Log.
2. Na barra de ferramentas, selecione Compile e aguarde a Unreal Engine terminar a compilação. Enquanto o código está sendo compilado, o Unreal exibe “Compiling C++ Code”.
3. Selecione Play. Quando o código for executado, o Unreal exibirá o seguinte na janela Output Log:

​

Chamando o PlayFab a partir de Blueprints do Unreal

​

Criar uma estrutura de Blueprint

• Set Play Fab Settings
• Login with Custom ID
• Make ClientLoginWithCustomIDRequest
• AddCustomEvent x 2
• Break PlayFabError
• Print String x 2

• Selecione o pino de saída em Event BeginPlay e arraste-o para um local livre no Event Graph. Na caixa de diálogo Executable Actions, pesquise Set Play Fab Settings e selecione-a para adicioná-la ao Blueprint. Em Set Play Fab Settings, se Game Title id estiver em branco, defina-o como o Title ID do seu jogo.
• Selecione o pino de saída em Set Play Fab Settings e arraste-o para um local livre. Na caixa de diálogo Executable Actions, pesquise Login with Custom ID e selecione-a para adicioná-la ao Blueprint.
• Selecione o pino Request em Login with Custom ID e arraste-o para um local vazio. Em Actions providing a(n) Client Login With Custom ID Request Structure, selecione Make ClientLoginWithCustomIDRequest.
• Em Make ClientLoginWithCustomIDRequest:
  • Selecione Create Account.
  • Defina Custom Id como GettingStartedGuide.
• Em Login with Custom ID, selecione o pino On Success e arraste-o para um local vazio. Em Actions providing a(n) Delegate, pesquise Add Custom Event e selecione-o para adicioná-lo ao Blueprint.
  • Nomeie-o como OnLogin.
• Selecione o pino On Failure e arraste-o para um local vazio. Em Actions providing a(n) Delegate, pesquise Add Custom Event e selecione-o para adicioná-lo ao Blueprint.
  • Nomeie-o como OnFailure.
• Selecione o pino de saída em OnLogin e arraste-o para um local vazio. Na caixa de diálogo Executable Actions, pesquise Print String e selecione-a para adicioná-la ao Blueprint.
  • Em Print String, defina o valor de In String como “Congratulations, you made your first successful PlayFab API call using Blueprint!”.
• Selecione o pino de saída de OnFailure e arraste-o para um local vazio. Na caixa de diálogo Executable Actions, pesquise Print String e selecione-a para adicioná-la ao Blueprint.
• Selecione o pino Error em OnFailure e arraste-o para um local vazio. Na caixa de diálogo Actions providing a(n) string, pesquise Break PlayFabError e selecione-a para adicioná-la ao Blueprint. Na caixa de diálogo Actions taking a(n) PlayFab error structure, pesquise Break PlayFabError e selecione-a para adicioná-la ao Blueprint.
• Conecte o pino Error Message de Break PlayFabError ao pino In String da Action Print String de falha.

​

Executar uma chamada ao PlayFab com Blueprint

1. Na barra de ferramentas, selecione o botão Play.
2. Quando o Blueprint for executado, a seguinte saída será mostrada na janela Viewport.

​

Mais recursos

• Documentação da Unreal Engine sobre Blueprints Visual Scripting.
• Documentação da Unreal Engine.