Información general sobre Multiplayer Manager

​

Características principales

• Administración de sesiones y emparejamiento de los servicios XBOX sencillos
• Modelo de programación basado en estados y basado en eventos
• Garantiza las prácticas recomendadas de los servicios XBOX y el cumplimiento de los XR de multijugador
• Implementa los diagramas de flujo de multijugador de 2015

• No se admiten las sesiones grandes de MPSD (más de 100 miembros).
• Está destinada únicamente a diseños multijugador hospedados entre pares. Los títulos con servidores dedicados deben usar en su lugar el Servicio de actividad multijugador o las API del servicio multijugador y las llamadas de servicio a servicio (tema con NDA).

​

Información general

• Sesión de sala: una sesión persistente que se usa para administrar a los usuarios locales del dispositivo y a los amigos invitados que quieren jugar juntos. El grupo puede jugar al juego; por ejemplo, varias rondas, mapas y niveles. La sesión de sala hace un seguimiento de este grupo principal de amigos (incluidos los jugadores locales del dispositivo). Normalmente, este grupo se forma mientras el host puede estar navegando por los menús y charlando con los miembros del grupo para decidir a qué modo de juego quieren jugar.
• Sesión de juego: hace un seguimiento de los jugadores que están jugando una instancia específica del juego. Por ejemplo, una carrera, un mapa o un nivel. Puedes crear una nueva sesión de juego mediante XblMultiplayerManagerJoinGameFromLobby que incluya a los miembros de la sesión de sala. Cuando un miembro acepta una invitación, se agrega a la sala y a la sesión de juego (si hay espacio). Se pueden agregar jugadores adicionales a la sesión de juego si el emparejamiento está habilitado, pero esos jugadores adicionales no se agregan a la sesión de sala. Esto significa que, cuando el juego termina, los jugadores de la sesión de sala siguen juntos, mientras que los jugadores adicionales procedentes del emparejamiento no.
• XblMultiplayerManagerMember: representa a un usuario individual que ha iniciado sesión en un dispositivo local o remoto.
• XblMultiplayerManagerDoWork: garantiza que se mantengan las actualizaciones correctas del estado del juego entre el título y el servicio multijugador de los servicios XBOX. Para garantizar el mejor rendimiento, se debe llamar a XblMultiplayerManagerDoWork con frecuencia, por ejemplo, una vez por fotograma. XblMultiplayerManagerDoWork te proporciona una matriz de eventos de devolución de llamada XblMultiplayerEvent para que el juego los controle.

​

Máquina de estados

​

Subprocesos

​

Actualización del modelo basado en estados

​

Eventos y notificaciones

​

API de C plana

size_t eventCount{ 0 };
const XblMultiplayerEvent* events{ nullptr };
HRESULT hr = XblMultiplayerManagerDoWork(&events, &eventCount);
if (FAILED(hr))
{
    // Handle failure.
}

for (auto i = 0u; i < eventCount; ++i)
{
    switch (events[i].EventType)
    {
        case XblMultiplayerEventType::MemberJoined:
        {
            // Handle MemberJoined.
            size_t memberCount = 0;
            hr = XblMultiplayerEventArgsMembersCount(events[i].EventArgsHandle, &memberCount);
            assert(SUCCEEDED(hr));

            std::vector<XblMultiplayerManagerMember> members(memberCount);
            hr = XblMultiplayerEventArgsMembers(events[i].EventArgsHandle, memberCount, members.data());
            assert(SUCCEEDED(hr));
            ...

            break;
        }

        case XblMultiplayerEventType::SessionPropertyChanged:
        {
            // Handle SessionPropertyChanged.
            const char* changedProperty{ nullptr };
            hr = XblMultiplayerEventArgsPropertiesJson(events[i].EventArgsHandle, &changedProperty);
            assert(SUCCEEDED(hr));
            ...

            break;
        }
        ...
    }
}

• XblMultiplayerEvent
• XblMultiplayerEventArgsMembers
• XblMultiplayerEventArgsMembersCount
• XblMultiplayerEventArgsPropertiesJson
• XblMultiplayerEventType
• XblMultiplayerManagerDoWork
• XblMultiplayerManagerMember

​

Escenarios

• Habilitar el juego multijugador con amigos mediante Multiplayer Manager
• Buscar un juego multijugador mediante SmartMatch con Multiplayer Manager
• Enviar invitaciones de juego mediante Multiplayer Manager
• Controlar la activación de protocolo para iniciar un juego mediante Multiplayer Manager

​

Qué no hace Multiplayer Manager

• Juegos de servidor en línea persistentes, como los juegos multijugador masivos en línea (MMO) u otros tipos de juegos que requieren sesiones grandes (más de 100 jugadores en una sesión)
• Administración de sesiones de servidor a servidor
• Limitación de las llamadas a MPSD para cumplir la limitación de velocidad detallada
• Mezcla de las API del servicio multijugador y las API de Multiplayer Manager

​

Recursos