​

Inicio rápido: biblioteca cliente de PlayFab para Unreal Engine

• Autenticación de jugadores.
• Administración de artículos virtuales y moneda.
• Creación de características sociales, como listas de amigos. Documentación de referencia de las API | Código fuente de la biblioteca | Unreal Marketplace

​

Requisitos previos

• Una cuenta de desarrollador de PlayFab.
• Una instalación de Visual Studio configurada para Unreal Engine. Para obtener información sobre la configuración de Visual Studio, consulte Setting Up Visual Studio for Unreal Engine.
• Una instalación de Unreal Engine. Para obtener información sobre la instalación de Unreal Engine, consulte la guía de instalación de Unreal Engine.
• Una instalación del complemento de PlayFab para Unreal. Puede instalar el complemento de Unreal desde el marketplace de Unreal Engine.

​

Crear un proyecto de Unreal

1. En Project Category, seleccione Games.
2. En Select Template, seleccione Blank.
3. En Project Settings, seleccione C++ o Blueprint.
4. Elija No Starter Content.
5. Elija un nombre para su proyecto, como MyProject.

​

Habilitar el complemento de PlayFab en su proyecto de Unreal

1. En el menú Settings, en Game Specific Settings, seleccione Plugins.
2. Habilite el complemento PlayFab y reinicie Unreal Engine según sea necesario.

​

Agregar PlayFab como dependencia de módulo en C++

1. En el menú View, abra el Solution Explorer, que muestra los archivos de su proyecto de C++.
2. En el Solution Explorer, vaya a Solution\Games\YourProjectName\Source y abra YourProjectName.Build.cs.
3. Agregue la siguiente línea:
   PrivateDependencyModuleNames.AddRange(new string[] { "PlayFab", "PlayFabCpp", "PlayFabCommon" });
   
4. Guarde los cambios.

​

Generar los archivos de proyecto de Visual Studio necesarios

1. Abra una ventana del explorador de archivos y vaya a la carpeta donde se encuentran los archivos de su proyecto.
2. En la carpeta raíz del proyecto, haga clic con el botón derecho en el archivo YourProjectName.uproject.
3. En el menú contextual, seleccione Generate Visual Studio project files.

​

Llamar a PlayFab con C++

​

Crear un nuevo Actor

1. En el menú File, seleccione New C++ Class.
2. En Parent Class, seleccione Actor.
3. Asigne a su actor el nombre LoginActor. Después de crear el Actor, Unreal Engine abre automáticamente su entorno de desarrollo de C++ y carga LoginActor.cpp y LoginActor.h.

4. Arrastre y suelte su nuevo Actor LoginActor desde el Content Browser hasta el panel Viewport. Ahora aparece en el panel “World Outliner”. Si no ve su LoginActor, seleccione el icono Show or hide the source panel. Después, seleccione el nombre de su proyecto bajo las clases de C++.

​

Agregar llamadas a la API de PlayFab a su LoginActor de C++

1. Reemplace el contenido de LoginActor.h por el código que se muestra:

#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. Reemplace el contenido de LoginActor.cpp por el código siguiente.

#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);
}

​

Finalizar y ejecutar con C++

1. Muestre el Output Log desde el menú Windows: seleccione Developer Tools y habilite Output Log.
2. En la barra de herramientas, seleccione Compile y espere a que Unreal Engine termine de compilar. Mientras se compila el código, Unreal muestra “Compiling C++ Code”.
3. Seleccione Play. Cuando se ejecuta el código, Unreal muestra lo siguiente en la ventana Output Log:

​

Llamar a PlayFab desde Blueprints de Unreal

​

Crear una estructura de Blueprint

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

• Seleccione el pin de salida de Event BeginPlay y arrástrelo a una ubicación libre del Event Graph. En el cuadro de diálogo Executable Actions, busque Set Play Fab Settings y selecciónelo para agregarlo a su Blueprint. En Set Play Fab Settings, si Game Title id está en blanco, establézcalo en el Title ID de su juego.
• Seleccione el pin de salida de Set Play Fab Settings y arrástrelo a una ubicación libre. En el cuadro de diálogo Executable Actions, busque Login with Custom ID y selecciónelo para agregarlo a su Blueprint.
• Seleccione el pin Request de Login with Custom ID y arrástrelo a una ubicación vacía. En Actions providing a(n) Client Login With Custom ID Request Structure, seleccione Make ClientLoginWithCustomIDRequest.
• En Make ClientLoginWithCustomIDRequest:
  • Seleccione Create Account.
  • Establezca el Custom Id en GettingStartedGuide.
• En Login with Custom ID, seleccione el pin On Success y arrástrelo a una ubicación vacía. En Actions providing a(n) Delegate, busque Add Custom Event y selecciónelo para agregarlo a su Blueprint.
  • Asígnele el nombre OnLogin.
• Seleccione el pin On Failure y arrástrelo a una ubicación vacía. En Actions providing a(n) Delegate, busque Add Custom Event y selecciónelo para agregarlo a su Blueprint.
  • Asígnele el nombre OnFailure.
• Seleccione el pin de salida de OnLogin y arrástrelo a una ubicación vacía. En el cuadro de diálogo Executable Actions, busque Print String y selecciónelo para agregarlo al Blueprint.
  • En Print String, establezca el valor de In String en “Congratulations, you made your first successful PlayFab API call using Blueprint!”.
• Seleccione el pin de salida de OnFailure y arrástrelo a una ubicación vacía. En el cuadro de diálogo Executable Actions, busque Print String y selecciónelo para agregarlo al Blueprint.
• Seleccione el pin Error de OnFailure y arrástrelo a una ubicación vacía. En el cuadro de diálogo Actions providing a(n) string, busque Break PlayFabError y selecciónelo para agregarlo al Blueprint. En el cuadro de diálogo Actions taking a(n) PlayFab error structure, busque Break PlayFabError y selecciónelo para agregarlo al Blueprint.
• Conecte el pin Error Message de Break PlayFabError al pin In String de la acción Print String de error.

​

Ejecutar una llamada a PlayFab con Blueprint

1. En la barra de herramientas, seleccione el botón Play.
2. Cuando se ejecuta el Blueprint, se muestra la siguiente salida en la ventana Viewport.

​

Más recursos

• Documentación de Unreal Engine sobre Blueprints Visual Scripting.
• Documentación de Unreal Engine.