Tutorial: Implementación de compilaciones mediante PowerShell/API

En este tema se describe cómo implementar o crear compilaciones para máquinas virtuales con sistema operativo Windows en PowerShell en un dispositivo de desarrollo con Windows 10, basándose en el ejemplo Windows Runner de C#.

Para usar y ver los servidores de PlayFab Multiplayer Servers, debe habilitar la característica. Se recomienda usar el método de Game Manager para habilitar esta característica. Para obtener instrucciones, consulte Habilitación de la característica PlayFab Server.

Requisitos previos

Asegúrese de haber completado los pasos siguientes.

1. Obtención del identificador del título y la clave secreta de desarrollador

Obtenga el identificador del título de PlayFab
- Inicie sesión en su cuenta de desarrollador en PlayFab.com
- En Game Manager, vaya a la página My Studios and Titles. Busque su título de juego y obtenga el identificador del título de juego de PlayFab
Obtenga la clave secreta de desarrollador para el título
- En Game Manager, seleccione su título > configuración (icono de engranaje)
- Seleccione Title settings y, después, la pestaña Secret Keys para obtener la clave secreta de desarrollador

Para obtener más información sobre las claves secretas, consulte Administración de claves secretas

2. Instalación del módulo de PowerShell de PlayFab Multiplayer

Abra Windows PowerShell como administrador y ejecute el comando siguiente para instalar el módulo de API PlayFabMultiplayer. Este nuevo módulo de API PlayFabMultiplayer reemplaza al módulo de PowerShell Multiplayer en desuso. Si instaló anteriormente el módulo PlayFab Multiplayer Powershell, desinstálelo con el comando siguiente. Para quienes realicen la transición al nuevo módulo, consulte Asignación de comandos para encontrar los nuevos comandos equivalentes.

Uninstall-Package PlayFabMultiplayer

Tanto los comandos como los argumentos son diferentes en este nuevo módulo. Para obtener documentación detallada sobre cada comando, consulte la documentación de los cmdlets.

Install-Module -Name PlayFabMultiplayerApi

Antes de instalar el módulo, puede que primero necesite establecer la directiva de ejecución mediante Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser. Para obtener más información, consulte Directivas de ejecución de PowerShell.

3. Obtención de un EntityToken para el título

En la ventana de PowerShell, ejecute el comando siguiente con su identificador de título y la clave de desarrollador asociada:

Set-PfTitle -TitleID "mytitleID" -SecretKey "mysecretkey"

4. Carga de recursos

Cuando implementa servidores de Windows, usaría el contenedor de Windows administrado. Lo único que tiene que hacer es cargar la compilación del servidor de juegos de PlayFab Multiplayer como un recurso. Actualice el valor de la marca FilePath con la ubicación del archivo local winrunnerSample.zip. Si no sabe dónde está este archivo, siga las instrucciones que se indican aquí para obtenerlo.

New-PfAsset -FilePath C:\windowsRunnerCSharp.zip -AssetName windowsRunnerCSharp.zip

5. Creación de una compilación

Ahora que el recurso está cargado, podemos crear una compilación. Ejecute los comandos siguientes. El código siguiente usa la máquina virtual Standard_D2as_v4 en la región EastUS. Reemplace las cadenas según la máquina virtual y la región que quiera usar.

$vmSize = "Standard_D2as_v4"

$regions = @( @{ StandbyServers = 1; MaxServers = 1; Region = 'EastUS'; ScheduledStandbySettings = $NULL } )

$ports = @( @{ Name = 'game_port'; Num = 3600; Protocol = 'TCP' } )

$gameAssets = @( @{ FileName = 'windowsRunnerCSharp.zip'; MountPath = 'C:\Assets' } )

$buildResponse = New-PfBuild -BuildName PSTest_build -ContainerFlavor ManagedWindowsServerCore -StartMultiplayerServerCommand 'C:\Assets\WindowsRunnerCSharp.exe' -GameAssetReferences $gameAssets -VMSize $vmSize -MultiplayerServerCountPerVM 1 -Ports $ports -RegionConfigurations $regions

# All PlayFabMultiplayerApi cmdlets return objects, so we can pass the returned object to ConvertTo-Json for human readability.
$buildResponse | ConvertTo-Json -depth 5

Comprobación de que la compilación es correcta

En unos segundos, verá la compilación creada a través de PowerShell o de la API ListBuildSummaries. También puede ejecutar el comando siguiente para comprobar que la compilación se implementó correctamente.

Get-PfBuild | ConvertTo-Json -depth 5

XBOX Services

PlayFab

Tutorial: Implementación de compilaciones mediante PowerShell/API

Requisitos previos

1. Obtención del identificador del título y la clave secreta de desarrollador

2. Instalación del módulo de PowerShell de PlayFab Multiplayer

3. Obtención de un EntityToken para el título

4. Carga de recursos

5. Creación de una compilación

Comprobación de que la compilación es correcta

Consulte también

​Requisitos previos

​1. Obtención del identificador del título y la clave secreta de desarrollador

​2. Instalación del módulo de PowerShell de PlayFab Multiplayer

​3. Obtención de un EntityToken para el título

​4. Carga de recursos

​5. Creación de una compilación

​Comprobación de que la compilación es correcta

​Consulte también

Requisitos previos

1. Obtención del identificador del título y la clave secreta de desarrollador

2. Instalación del módulo de PowerShell de PlayFab Multiplayer

3. Obtención de un EntityToken para el título

4. Carga de recursos

5. Creación de una compilación

Comprobación de que la compilación es correcta

Consulte también