Plantillas de sesión multijugador

En este tema se describen las plantillas de sesión multijugador y se proporcionan ejemplos de plantillas que puede copiar y modificar para sus sesiones multijugador. Una plantilla de sesión multijugador es un modelo para crear una sesión multijugador. Todas las sesiones deben crearse a partir de una plantilla predefinida. Una plantilla define constantes que son las mismas para cualquier sesión que se cree a partir de la plantilla. Cuando crea una sesión a partir de una plantilla, puede agregar y modificar datos adicionales de la sesión. Sin embargo, no puede modificar las constantes definidas en la plantilla. Para obtener más información, consulte la sección Información general de las sesiones en Temas avanzados de sesión multijugador. Puede obtener la lista de plantillas de sesión que se aplican a un identificador de configuración de servicio (SCID) y el contenido de plantillas de sesión específicas desde Multiplayer Session Directory (MPSD).

Acerca de las plantillas de sesión

Una plantilla de sesión para crear o modificar una sesión usa el mismo formato que una solicitud HTTP PUT. La diferencia es que la plantilla solo define constantes. No se definen miembros, servidores ni propiedades. Se puede definir cualquier constante de sesión, incluida una sección personalizada y toda la gama de constantes del sistema.

Versiones de las plantillas de sesión

Las plantillas de sesión definidas en este tema se construyen con la versión de contrato de plantilla 107. Cuando las use para crear una plantilla nueva, asegúrese de que la versión de contrato especificada sea 107. Si usa la API de Servicios de XBOX (XSAPI) y observa las solicitudes resultantes en el depurador, es posible que note que las solicitudes usan la versión de contrato de plantilla 105. MPSD “actualiza” de forma efectiva estas solicitudes a la versión 107 en tiempo de ejecución.

Puede usar en la solicitud una versión de contrato distinta de la de la plantilla de sesión.

Si es necesario, puede cambiar una plantilla de sesión de la versión 104 o 105 a la versión 107. Volver al principio de este tema.

Valores predeterminados de las plantillas de sesión

Cada sesión creada a partir de una plantilla de sesión comienza como una copia de la plantilla. Los valores que no se especifican en la plantilla se pueden especificar cuando se crea la sesión. En algunos casos se proporcionan valores predeterminados cuando no se establece ningún otro valor. El conjunto predeterminado de tiempos de espera para la versión de contrato 107 se muestra en el ejemplo siguiente.

    {
      "constants": {
        "system": {
          "reservedRemovalTimeout": 30000,
          "inactiveRemovalTimeout": 0,
          "readyRemovalTimeout": 180000,
          "sessionEmptyTimeout": 0
        }
      }
    }

Puede forzar que un valor permanezca sin establecer especificando null. Esto invalida cualquier configuración predeterminada e impide que el valor se establezca al crear la sesión. Por ejemplo, para quitar sessionEmptyTimeout, de modo que incluso las sesiones vacías continúen indefinidamente, agregue lo siguiente a la plantilla de sesión.

    {
      "constants": {
        "system": {
          "sessionEmptyTimeout": null
        }
      }
    }

Las constantes que se establecen a través de una plantilla no se pueden cambiar mediante escrituras en MPSD. Para cambiar los valores, debe crear y enviar una plantilla nueva con los cambios necesarios.

Volver al principio de este tema.

Ejemplos de plantillas de sesión

En esta sección se proporcionan ejemplos de plantillas de sesión para diversos fines y topologías de red. Puede realizar los cambios necesarios en la plantilla adecuada y pegarla en su configuración de servicio.

Sesión de sala de espera estándar

Use esta plantilla para crear una sesión de sala de espera (lobby) para su juego.

Cambie el valor de maxMembersCount al número máximo de jugadores que quiere admitir en su sesión de sala de espera.
Si su título no admite que jugadores de plataformas distintas (como una consola XBOX y un equipo Windows) jueguen juntos, puede quitar el elemento crossPlay.
También puede cambiar los demás valores. Los valores siguientes son un buen punto de partida si no está seguro de lo que necesita.

{
   "constants": {
        "system": {
            "version": 1,
            "maxMembersCount": 8,
            "visibility": "open",
            "capabilities": {
                "connectivity": true,
                "connectionRequiredForActiveMembers": true,
                "crossPlay": true,
                "userAuthorizationStyle": true
            },
        },
        "custom": {}
    }
}

Sesión de juego estándar sin emparejamiento

Use esta plantilla para crear una sesión de juego para su juego si este no incluye emparejamiento anónimo y no requiere más de 100 miembros. Esta plantilla solo agrega dos valores nuevos a los que se especifican en la plantilla de sesión de sala de espera estándar.

constants.system.inviteProtocol : "game"
constants.system.capabilities.gameplay : true

{
   "constants": {
        "system": {
            "version": 1,
            "maxMembersCount": 8,
            "visibility": "open",
            "inviteProtocol": "game",
            "capabilities": {
                "connectivity": true,
                "connectionRequiredForActiveMembers": true,
                "gameplay" : true,
                "crossPlay": true,
                "userAuthorizationStyle": true
            }
        },
        "custom": {}
    }
}

Agregar emparejamiento a una plantilla de sesión de juego, donde las comprobaciones de calidad de servicio (QoS) las controla el servicio Multijugador

Para habilitar el emparejamiento en su juego, especifique valores para memberInitialization en su plantilla de sesión de juego. Cuando cree su tolva (hopper) de SmartMatch, use la plantilla siguiente como plantilla de sesión de destino para su tolva.

{
   "constants": {
        "system": {
            "memberInitialization": {
               "joinTimeout": 20000,
               "measurementTimeout": 15000,
               "membersNeededToStart": 2
            }
        }
    }
}

Agregar emparejamiento a una sesión de juego, donde las comprobaciones de QoS las controla un centro de datos administrado por el título

{
   "constants": {
        "system": {
            "peerToHostRequirements": {  
                "latencyMaximum": 250,
                "bandwidthDownMinimum": 256,
                "bandwidthUpMinimum": 256,
                "hostSelectionMetric": "latency"
            },
            "memberInitialization": {
               "joinTimeout": 15000,
               "measurementTimeout": 15000,
               "membersNeededToStart": 2
            }
        },
        "custom": {}
    }
}

Plantilla de sesión básica para sesión de juego cliente/servidor

Use la plantilla siguiente para un título en el que los clientes se conectan a un servidor hospedado por un tercero en lugar de usar comunicación de punto a punto.

    {
      "constants": {
        "system": {
          "version": 1,
          "maxMembersCount": 12,
          "visibility": "open",
          "inviteProtocol": "game",
          "capabilities": {
            "connectionRequiredForActiveMembers": true,
            "gameplay": true,
          },
        },
        "custom": {}
      }
    }

Plantilla de sesión de sala de espera o de vale de SmartMatch para redes basadas en pares

Use la plantilla siguiente para crear una sesión de sala de espera o una sesión de vale de SmartMatch para enviar a un grupo de jugadores al emparejamiento. Esta plantilla está pensada para clientes que usan una topología de red de punto a punto o de punto a host. No configura una sesión de juego.

    {
      "constants": {
        "system": {
          "version": 1,
          "maxMembersCount": 10,
          "visibility": "open",
          "capabilities": {
            "connectionRequiredForActiveMembers": true,
          },
          "memberInitialization": {
            "membersNeededToStart": 1
          },
        },
        "custom": {}
      }
    }

Volver al principio de este tema.

Plantillas de QoS

Si su juego usa emparejamiento y evalúa la QoS, debe agregar algunas constantes a la plantilla de sesión para indicar a MPSD que se coordine con el cliente para administrar a los usuarios que se unen a la sesión. Esta coordinación valida la calidad del estado de la conexión antes de informar a los usuarios de que el juego está listo para comenzar. En el caso de los juegos cliente/servidor, la coordinación valida la calidad de la conexión antes de que un grupo de jugadores entre en el emparejamiento.

Plantilla de sesión de juego de punto a host con QoS

Use la plantilla siguiente para crear una sesión de juego de punto a host con QoS.

    {
      "constants": {
        "system": {
          "version": 1,
          "maxMembersCount": 12,
          "visibility": "open",
          "inviteProtocol": "game",
          "capabilities": {
            "connectivity": true,
            "connectionRequiredForActiveMembers": true,
            "gameplay" : true
          },
          "memberInitialization": {
            "membersNeededToStart": 2
          },
          "peerToHostRequirements": {
            "latencyMaximum": 350,
            "bandwidthDownMinimum": 1000,
            "bandwidthUpMinimum": 1000,
            "hostSelectionMetric": "latency"
          }
        },
        "custom": { }
      }
    }

Plantilla de sesión de juego de punto a punto con QoS

Use la plantilla siguiente para crear una sesión de juego de punto a punto con QoS.

    {
    "constants": {
      "system": {
        "version": 1,
        "maxMembersCount": 12,
        "visibility": "open",
        "inviteProtocol": "game",
        "capabilities": {
          "connectivity": true,
          "connectionRequiredForActiveMembers": true,
          "gameplay" : true
        },
        "memberInitialization": {
          "membersNeededToStart": 2
        },
        "peerToPeerRequirements": {
          "latencyMaximum": 250,
          "bandwidthMinimum": 10000
        }
      },
      "custom": { }
     }
    }

Plantilla de sesión de sala de espera o de emparejamiento cliente/servidor con QoS

Use la plantilla siguiente para crear una sesión de sala de espera o una sesión de emparejamiento mediante QoS. Esta plantilla no debe usarse para configurar una sesión de juego.

    {
      "constants": {
        "system": {
          "version": 1,
          "maxMembersCount": 12,
          "visibility": "open",
          "memberInitialization": {
            "membersNeededToStart": 1
          }
        },
        "custom": {}
      }
    }

Plantilla de sesión para juego multiplataforma entre XBOX One y Windows 10

Use la plantilla siguiente para habilitar el modo multijugador multiplataforma entre XBOX One (o posterior) y Windows 10.

La funcionalidad opcional crossPlay admite interacciones como invitaciones y unirse a una partida en curso entre plataformas.
La funcionalidad userAuthorizationStyle habilita el acceso a Windows 10.

    {
      "constants": {
        "system": {
          "capabilities": {
            "crossPlay": true,
            "userAuthorizationStyle": true
          },
        },
        "custom": {}
      }
    }

Última modificación el 28 de agosto de 2026

Temas relacionados

Roles de multijugador Configuración del servicio Multijugador Temas avanzados de las sesiones multijugador Preguntas frecuentes y solución de problemas de multijugador Conceptos del Directorio de sesiones multijugador (MPSD)

⌘I

XBOX Services

PlayFab

Acerca de las plantillas de sesión

Versiones de las plantillas de sesión

Valores predeterminados de las plantillas de sesión

Ejemplos de plantillas de sesión

Sesión de sala de espera estándar

Sesión de juego estándar sin emparejamiento

Agregar emparejamiento a una plantilla de sesión de juego, donde las comprobaciones de calidad de servicio (QoS) las controla el servicio Multijugador

Agregar emparejamiento a una sesión de juego, donde las comprobaciones de QoS las controla un centro de datos administrado por el título

Plantilla de sesión básica para sesión de juego cliente/servidor

Plantilla de sesión de sala de espera o de vale de SmartMatch para redes basadas en pares

Plantillas de QoS

Plantilla de sesión de juego de punto a host con QoS

Plantilla de sesión de juego de punto a punto con QoS

Plantilla de sesión de sala de espera o de emparejamiento cliente/servidor con QoS

Plantilla de sesión para juego multiplataforma entre XBOX One y Windows 10

​Acerca de las plantillas de sesión

​Versiones de las plantillas de sesión

​Valores predeterminados de las plantillas de sesión

​Ejemplos de plantillas de sesión

​Sesión de sala de espera estándar

​Sesión de juego estándar sin emparejamiento

​Agregar emparejamiento a una plantilla de sesión de juego, donde las comprobaciones de calidad de servicio (QoS) las controla el servicio Multijugador

​Agregar emparejamiento a una sesión de juego, donde las comprobaciones de QoS las controla un centro de datos administrado por el título

​Plantilla de sesión básica para sesión de juego cliente/servidor

​Plantilla de sesión de sala de espera o de vale de SmartMatch para redes basadas en pares

​Plantillas de QoS

​Plantilla de sesión de juego de punto a host con QoS

​Plantilla de sesión de juego de punto a punto con QoS

​Plantilla de sesión de sala de espera o de emparejamiento cliente/servidor con QoS

​Plantilla de sesión para juego multiplataforma entre XBOX One y Windows 10

Acerca de las plantillas de sesión

Versiones de las plantillas de sesión

Valores predeterminados de las plantillas de sesión

Ejemplos de plantillas de sesión

Sesión de sala de espera estándar

Sesión de juego estándar sin emparejamiento

Agregar emparejamiento a una plantilla de sesión de juego, donde las comprobaciones de calidad de servicio (QoS) las controla el servicio Multijugador

Agregar emparejamiento a una sesión de juego, donde las comprobaciones de QoS las controla un centro de datos administrado por el título

Plantilla de sesión básica para sesión de juego cliente/servidor

Plantilla de sesión de sala de espera o de vale de SmartMatch para redes basadas en pares

Plantillas de QoS

Plantilla de sesión de juego de punto a host con QoS

Plantilla de sesión de juego de punto a punto con QoS

Plantilla de sesión de sala de espera o de emparejamiento cliente/servidor con QoS

Plantilla de sesión para juego multiplataforma entre XBOX One y Windows 10