Información general de Multiplayer Session Directory

• Sesiones de MPSD
• Control de notificaciones de cambios de MPSD y detección de desconexiones
• Identificadores de MPSD para las sesiones
• Sincronización de las actualizaciones de sesión
• Llamar a MPSD
• Multiplayer Session Explorer

​

Sesiones de MPSD

• La crean y administran los títulos.
• Tiene un URI único. Para obtener más información, consulte URI de Session Directory.
• Permite la conectividad entre los usuarios, denominados miembros de la sesión.
• Almacena datos que hacen posible el juego, como atributos por miembro, configuración del juego, información de arranque (bootstrapping) e información del servidor de juego.

​

Control de notificaciones de cambios de MPSD y detección de desconexiones

• Enviar notificaciones breves (avisos o “shoulder taps”) cuando se producen cambios de sesión, en función de las suscripciones a eventos que inician los títulos.
• Detectar desconexiones de usuarios.
• Establecer usuarios como inactivos y luego quitarlos de la sesión, en función de la detección de desconexiones.

​

Establecer conexiones de usuarios

1. El título llama a XblMultiplayerSetSubscriptionsEnabled. Este método indica a XSAPI que el cliente pretende usar una conexión RTA con fines multijugador.
2. Cuando el título realiza su primera llamada a XblMultiplayerWriteSessionAsync o XblMultiplayerWriteSessionByHandleAsync, con el usuario actual establecido en el estado Activo, se crea una conexión y se enlaza a MPSD.

​

Suscribirse a los cambios de sesión

​

Controlar los avisos

​

Controlar las notificaciones de cambios de estado de la conexión

• Controlador XblMultiplayerSessionSubscriptionLostHandler: se desencadena cuando se pierde la conexión del título con MPSD mediante el servicio RTA. Cuando se produce este evento, el título debe cerrar el modo multijugador.
• Controlador XblRealTimeActivityConnectionStateChangeHandler: se desencadena ante un cambio temporal en el estado de la conexión del título con el servicio RTA. El título no está obligado a realizar ninguna acción al recibir este evento, pero el evento puede ser útil con fines de diagnóstico.

​

Desconectar clientes

​

Detección de desconexiones

​

Controlar las reconexiones de RTA

void* context{ nullptr };
XblFunctionContext connectionIdChangedFunctionContext = XblMultiplayerAddConnectionIdChangedHandler(
    xblContextHandle,
    [](void* context) {
        XblMultiplayerSessionHandle sessionHandle; // Retrieve the MPSD session to update
        XblMultiplayerSessionCurrentUserSetStatus(sessionHandle, XblMultiplayerSessionMemberStatus::Active);

        auto asyncBlock = std::make_unique<XAsyncBlock>();
        asyncBlock->queue = queue;
        asyncBlock->context = nullptr;
        asyncBlock->callback = [](XAsyncBlock* asyncBlock)
        {
            std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock };

            XblMultiplayerSessionHandle sessionHandle;
            HRESULT hr = XblMultiplayerWriteSessionResult(asyncBlock, &sessionHandle);
            if (SUCCEEDED(hr))
            {
                // If the write call succeeds, the connection ID has been updated and no further action is needed.
            }
            else
            {
                // If the write call fails, it's likely that the user has been removed from the session.
            }
        };

        auto hr = XblMultiplayerWriteSessionAsync(xblContextHandle, sessionHandle, XblMultiplayerSessionWriteMode::UpdateExisting, asyncBlock.get());
        if (SUCCEEDED(hr))
        {
            asyncBlock.release();
        }
    }, 
    context);

​

Identificadores de MPSD para las sesiones

​

Tipos de identificadores

​

Identificadores de invitación

​

Crear un identificador de invitación

​

Crear un identificador de actividad

​

Usar identificadores

1. Obtener el id. de identificador a partir de los parámetros de activación del título.
2. Crear un objeto de sesión de MPSD local y, a continuación, unirse a él como activo.
3. Escribir la sesión, pasando el identificador adecuado.

​

Sincronización de las actualizaciones de sesión

• Un árbitro actualiza las partes compartidas de la sesión. Si su implementación implica un único árbitro, puede evitar el uso de actualizaciones sincronizadas para la mayoría de las operaciones de escritura. El título puede evitar la sincronización en los casos siguientes.
  • Cualquier actualización que el árbitro realice en las partes compartidas de la sesión, a menos que estén relacionadas con la comunicación de la identidad del árbitro
  • Cualquier actualización que un título realice en el área de miembro dentro de la sesión

  [!NOTE] Aunque los tipos de actualización mencionados anteriormente no necesitan sincronización, sigue siendo importante sincronizar cualquier actualización de la propiedad XblMultiplayerSessionProperties::HostDeviceToken. Esta propiedad se usa para comunicar la identidad del árbitro, por ejemplo, como parte de la migración del árbitro.

• Todos los clientes actualizan las partes compartidas de la sesión. En este caso, todas las actualizaciones de las partes compartidas de la sesión deben sincronizarse. Sin embargo, los títulos aún pueden escribir en sus propias áreas de miembro sin sincronización.

​

Actualizar la sincronización de sesiones mediante la API multijugador

• XblMultiplayerWriteSessionAsync
• XblMultiplayerWriteSessionByHandleAsync

​

Actualizar la sincronización de sesiones mediante la API REST multijugador

​

Llamar a MPSD

• Se recomienda usar la API multijugador, que contiene clases que actúan como contenedores de la funcionalidad RESTful. Para obtener más información, consulte las funciones con el prefijo XblMultiplayer. Para el emparejamiento de SmartMatch, use la API de emparejamiento, representada por las funciones con el prefijo XblMatchmaking.
• Use llamadas HTTP estándar directas a las API REST de multijugador y emparejamiento que se incluyen en la Referencia RESTful de los servicios de XBOX. Los URI aplicables se describen en las secciones URI de Session Directory (para multijugador) y URI de emparejamiento (para el emparejamiento). Los objetos JSON relacionados se describen en la sección Referencia de objetos de notación de objetos JavaScript (JSON).

​

Usar la API multijugador para llamar a MPSD

​

Usar la API REST multijugador para interactuar con MPSD

​

Consultar sesiones y plantillas de sesión (REST)

​

Consultar información básica de sesión

​

Consultar plantillas de sesión

• /serviceconfigs//sessiontemplates
• /serviceconfigs//sessiontemplates/

​

Consultar el estado de la sesión

• /serviceconfigs//sessions
• /serviceconfigs//sessiontemplates//sessions

​

Multiplayer Session Explorer

​

Acceder a Multiplayer Session Explorer

​

Abrir la página principal

1. Abra la página principal de la herramienta. Muestra el contexto de seguridad (usuario que ha iniciado sesión y sandbox) y una lista de los SCID del sandbox.
2. Presione el botón Menu para anclar esta página a Inicio y así no tener que volver a escribir el URI.

​

Mostrar las sesiones y plantillas disponibles

1. Seleccione un SCID en la herramienta para mostrar una lista de las sesiones de ese SCID que incluyen al usuario que ha iniciado sesión como miembro.
2. En esta misma página, puede seleccionar el SCID y mostrar las plantillas de sesión y las cadenas de localización de la configuración de servicio del SCID. Estos elementos se ingieren a través del Partner Center.

​

Mostrar el contenido completo de una sesión

• La llamada GET podría estar usando una versión de contrato anterior en el encabezado X-Xbl-Contract-Version. Multiplayer Session Explorer siempre muestra la sesión con la versión de contrato más actualizada.
• Cuando se solicita una sesión normalmente mediante GET, se pueden desencadenar transformaciones y efectos secundarios, como tiempos de espera expirados. Multiplayer Session Explorer muestra una instantánea de la sesión tal como está almacenada, sin ejecutar ninguna lógica, transformación ni efecto secundario.
• El campo del objeto JSON nextTimer no está presente en las sesiones de MPSD porque se calcula al mismo tiempo que los efectos secundarios.

​

Consulte también

• La sección Información general de las sesiones en el tema Temas avanzados de sesión multijugador
• Códigos de estado de sesión multijugador
• La sección Actualizar una sesión de MPSD en el tema Tareas multijugador
• La sección Unirse a una sesión de MPSD desde una activación del título en el tema Tareas multijugador
• La sección Suscribirse a las notificaciones de cambios de sesión de MPSD en el tema Tareas multijugador
• Información general del emparejamiento