Skip to main content

Inicio rápido: biblioteca cliente de PlayFab para C# en Unity

Comience a usar la biblioteca cliente de PlayFab para C# en Unity. Siga los pasos para instalar el paquete y probar código de ejemplo para una tarea básica. Este inicio rápido le ayuda a realizar su primera llamada a la API de PlayFab en el motor de Unity.

Requisitos

El SDK de PlayFab para Unity es compatible con el editor de Unity versión 5.3 (publicada en diciembre de 2015) y posteriores.
  • Un proyecto de Unity de cualquiera de los siguientes tipos:
  • El SDK de PlayFab para Unity.

Descargar e instalar el SDK de PlayFab

Puede usar el paquete PlayFab Editor Extensions para instalar el SDK o instalar el SDK directamente. Las PlayFab Editor Extensions son un complemento independiente de Unity que simplifica la instalación del SDK y la configuración de algunos ajustes de PlayFab para su título. Para obtener información sobre cómo instalar el SDK sin usar las PlayFab Editor Extensions, consulte Instalación del SDK de PlayFab sin las Editor Extensions para Unity.
  1. Descargue el paquete de recursos PlayFab Unity Editor Extensions.
  2. Abra su proyecto de Unity.
  3. Vaya a la ubicación donde descargó el archivo y haga doble clic en el archivo PlayFabEditorExtensions.UnityPackage para abrir el cuadro de diálogo Import Unity Package en el editor de Unity.
  4. Para importar las PlayFab Unity Editor Extensions en su proyecto, seleccione Import.
  5. Cuando finalice la importación, el panel de PlayFab Unity Editor Extensions debería abrirse automáticamente mostrando el cuadro de diálogo de instalación del SDK.
Si el panel no se abrió, o si lo cierra y desea volver a abrirlo, puede hacerlo seleccionando Window > PlayFab > Editor Extensions
6. Seleccione Install PlayFab SDK para importar automáticamente el SDK en su proyecto o actualizar la versión que esté instalada actualmente.

Establecer la configuración del título

Antes de poder realizar una llamada a la API, debe crear un PlayFabSharedSettings.asset y especificar el Title ID que recibirá la llamada. Para establecer el Title ID:
  1. Seleccione PlayFab > MakePlayFabSharedSettings, lo que debería crear el recurso de configuración y abrirlo en el panel Inspector.
  2. Establezca su Title ID en el inspector.
  3. A partir de ahora, en cualquier momento, también puede ver y cambiar el Title ID actual desde la pestaña Settings del panel de las Editor Extensions.
La Developer Secret Key no está establecida de forma predeterminada. Si va a crear una compilación de servidor, asegúrese de proporcionar la clave secreta en el PlayFabSharedSettings.asset. La Developer Secret Key se establece automáticamente en la clave secreta predeterminada del título. Para obtener más información sobre las claves secretas, consulte Administración de claves secretas. De lo contrario, asegúrese de que la clave secreta no esté establecida al compilar el cliente del juego. Para obtener más información sobre las claves secretas, consulte Administración de claves secretas.
Las extensiones le permiten personalizar el transporte HTTP que se usa para realizar las solicitudes a PlayFab. El valor predeterminado recomendado es Unity Web Request. Existen otras opciones para ofrecer compatibilidad con versiones anteriores del motor o con implementaciones HTTP específicas del juego.

Realizar su primera llamada a la API

Esta parte de la guía proporciona los pasos mínimos para realizar su primera llamada a la API de PlayFab. Este ejemplo no proporciona ninguna GUI ni información en pantalla. La confirmación se muestra en el registro de la consola.
  1. Si su proyecto de Unity aún no tiene una carpeta Scripts (las plantillas HDRP y LWRP/URP tienen una de forma predeterminada), haga clic con el botón derecho en la carpeta Assets del panel Project y seleccione Create > Folder.
  2. En la ventana Assets, asigne a la carpeta el nombre Scripts.
  3. Haga clic con el botón derecho en la carpeta Scripts y seleccione Create > C# Script.
  4. Asigne al script el nombre PlayFabLogin.
  5. Haga doble clic en el archivo para abrirlo en un editor de código.
  6. En su editor de código, reemplace el contenido de PlayFabLogin.cs por el código proporcionado y guarde el archivo.
El código proporcionado no debe usarse con títulos móviles. Es solo un ejemplo y muestra cómo iniciar sesión con un CustomID. Para implementar el inicio de sesión en un título móvil, use
LoginWithAndroidDeviceID, LoginWithIOSDeviceID o alguna forma de inicio de sesión social, como LoginWithFacebook. 7. En el panel Hierarchy, haga clic con el botón derecho en su escena y, después, seleccione Create Empty (o Game Object > Create Empty en versiones anteriores de Unity). 8. Seleccione el nuevo Game Object y, en el panel Inspector, seleccione Add Component. 9. En el menú desplegable de componentes, seleccione Scripts > PlayFabLogin. Para obtener más información sobre la creación y el uso de scripts en el editor de Unity, consulte Creating and Using Scripts en la documentación de Unity.

Finalizar y ejecutar

Ya está listo para probar este ejemplo.
  • Asegúrese de guardar todos los archivos y volver al editor de Unity
  • Presione el botón Play en la parte superior del editor
Debería ver el siguiente mensaje en el panel de la consola de Unity.
Como alternativa, puede iniciar sesión en PlayFab, ir al título en Game Manager y seleccionar la pestaña PlayStream Monitor. Cada vez que quita el foco del título de Unity que se está ejecutando activamente, se genera un evento que puede ver y confirmar en el PlayStream Monitor.
Para obtener una lista de todas las llamadas a la API de cliente disponibles, consulte Referencias de las API de PlayFab.

Pasos siguientes

Este inicio rápido muestra un procedimiento simplificado para autenticar a un usuario. Para obtener más información sobre la autenticación de usuarios, consulte Conceptos básicos y procedimientos recomendados de inicio de sesión. Aprenda a enlazar una cuenta a varios dispositivos y mecanismos de inicio de sesión: Inicio rápido de vinculación de cuentas.
Última modificación el 28 de agosto de 2026