PartyDirectPeerConnectivityOptions - XBOX Game Development Documentation

Marcas que controlan el intento de uso de la conectividad directa de punto a punto entre los dispositivos de una red.

Sintaxis

enum class PartyDirectPeerConnectivityOptions  : int32_t  
{  
    None = 0x0,  
    SamePlatformType = 0x1,  
    DifferentPlatformType = 0x2,  
    AnyPlatformType = SamePlatformType | DifferentPlatformType,  
    SameEntityLoginProvider = 0x4,  
    DifferentEntityLoginProvider = 0x8,  
    AnyEntityLoginProvider = SameEntityLoginProvider | DifferentEntityLoginProvider,  
    OnlyServers = 0x10,  
}  

Constantes

Constante	Descripción
None	No se especifica ninguna marca. La ausencia de marcas significa que no se permite ningún intento de conexión directa entre pares. Todos los mensajes de punto de conexión y los datos de chat entre dispositivos se transmitirán siempre a través de servidores de retransmisión transparentes en la nube, y nunca se intercambiará información de direcciones IP.
SamePlatformType	Se pueden intentar conexiones directas de punto a punto entre dispositivos del mismo tipo de plataforma. Un par de dispositivos intentará establecer conexiones directas de punto a punto si se identifican como poseedores del mismo tipo de plataforma de hardware u OS (por ejemplo, equipos Windows, consolas de juegos XBOX, dispositivos móviles basados en iOS) asociada a la biblioteca de Party específica que usan. Tenga en cuenta que esta marca no permite por sí sola ningún intento de conectividad directa de punto a punto. Debe combinarse con una o ambas de las marcas `SameEntityLoginProvider` y `DifferentEntityLoginProvider`. Esta marca no se puede combinar con la marca `OnlyServers` en la estructura PartyNetworkConfiguration. Puede combinarse con `OnlyServers` como parte del valor PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask.
DifferentPlatformType	Se pueden intentar conexiones directas de punto a punto entre dispositivos con tipos de plataforma diferentes. Un par de dispositivos intentará establecer conexiones directas de punto a punto si se identifican como poseedores de tipos diferentes de plataformas de hardware u OS (por ejemplo, equipos Windows, consolas de juegos XBOX, dispositivos móviles basados en iOS) asociadas a las bibliotecas de Party específicas que usa cada dispositivo. Tenga en cuenta que esta marca no permite por sí sola ningún intento de conectividad directa de punto a punto. Debe combinarse con una o ambas de las marcas `SameEntityLoginProvider` y `DifferentEntityLoginProvider`. Esta marca no se puede combinar con la marca `OnlyServers` en la estructura PartyNetworkConfiguration. Puede combinarse con `OnlyServers` como parte del valor PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask.
AnyPlatformType	Se pueden intentar conexiones directas de punto a punto entre dispositivos independientemente de sus tipos de plataforma. Esta marca es equivalente a ```SamePlatformType	DifferentPlatformType```.
SameEntityLoginProvider	Se pueden intentar conexiones directas de punto a punto entre dispositivos que tienen identificadores de entidad de PlayFab de usuarios autenticados que iniciaron sesión con el mismo proveedor. Un dispositivo que autentica inicialmente a un usuario local en la red intentará establecer conexiones directas de punto a punto con los dispositivos remotos que tengan al menos un identificador de entidad de PlayFab de usuario autenticado que haya iniciado sesión con el mismo proveedor (por ejemplo, XBOX Live, Facebook, iOS, Google) que el usuario que se está autenticando. Tenga en cuenta que esta marca no permite por sí sola ningún intento de conectividad directa de punto a punto. Debe combinarse con una o ambas de las marcas `SamePlatformType` y `DifferentPlatformType`. Esta marca no se puede combinar con la marca `OnlyServers` en la estructura PartyNetworkConfiguration. Puede combinarse con `OnlyServers` como parte del valor PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask.
DifferentEntityLoginProvider	Se pueden intentar conexiones directas de punto a punto entre dispositivos con identificadores de entidad de PlayFab de usuarios autenticados que iniciaron sesión con proveedores diferentes. Un dispositivo que autentica inicialmente a un usuario local en la red intentará establecer conexiones directas de punto a punto con los dispositivos remotos que no tengan ningún identificador de entidad de PlayFab de usuario autenticado que haya iniciado sesión con el mismo proveedor (por ejemplo, XBOX Live, Facebook, iOS, Google) que el usuario que se está autenticando. Tenga en cuenta que esta marca no permite por sí sola ningún intento de conectividad directa de punto a punto. Debe combinarse con una o ambas de las marcas `SamePlatformType` y `DifferentPlatformType`. Esta marca no se puede combinar con la marca `OnlyServers` en la estructura PartyNetworkConfiguration. Puede combinarse con `OnlyServers` como parte del valor PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask.
AnyEntityLoginProvider	Se pueden intentar conexiones directas de punto a punto entre dispositivos independientemente del proveedor usado para iniciar sesión con los identificadores de entidad de PlayFab de los usuarios autenticados. Esta marca es equivalente a ```SameEntityLoginProvider	DifferentEntityLoginProvider```.
OnlyServers	Se pueden intentar conexiones directas de punto a punto entre dispositivos si al menos uno de los dispositivos tiene un usuario autenticado con un tipo de entidad de PlayFab `game_server`. Un dispositivo que autentica inicialmente a un usuario local en la red intentará establecer conexiones directas de punto a punto con los dispositivos remotos si el usuario local o un usuario del dispositivo remoto es de tipo de entidad de PlayFab `game_server`, tal como se especificó en PartyManager::CreateLocalUserWithEntityType(). En otras palabras, los dispositivos de los jugadores nunca se conectarán directamente entre sí, solo a los dispositivos de servidor. Los dispositivos de servidor intentarán conectarse directamente a todos los dispositivos de jugadores y a los demás dispositivos de servidor. Esta marca no se puede combinar con ninguna de las marcas `SamePlatformType`, `DifferentPlatformType`, `SameEntityLoginProvider` o `DifferentEntityLoginProvider` en la estructura PartyNetworkConfiguration. Puede combinarse con esas marcas como parte del valor PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask.

Comentarios

Como parte de la autenticación correcta de un usuario inicial en una red, un dispositivo puede intentar establecer conexiones directas de punto a punto con otros dispositivos que ya participan en la red, cuando lo permitan estas marcas declaradas en la estructura PartyNetworkConfiguration de la red. En los intentos que tengan éxito, los mensajes de punto de conexión y los datos de chat entre los dispositivos se transmitirán mediante esas conexiones directas. En los intentos que fallen debido a incompatibilidades del entorno entre los dispositivos, toda la comunicación entre esos dispositivos se transmitirá en su lugar a través de servidores de retransmisión transparentes en la nube. Si estas marcas no permiten que los dispositivos intenten conexiones directas entre pares, nunca intercambiarán información de direcciones IP y siempre transmitirán los mensajes de punto de conexión y los datos de chat a través de servidores de retransmisión transparentes en la nube.

Puede determinar si el dispositivo local estableció realmente una conexión directa de punto a punto con un dispositivo remoto específico llamando a PartyNetwork::GetDeviceConnectionType().

Una conectividad directa entre pares correcta puede proporcionar una latencia menor entre algunos dispositivos, aunque intentar establecerla también requiere que los usuarios revelen las direcciones IP de sus dispositivos a otros, lo que puede ser un problema de privacidad o permitir que usuarios malintencionados ataquen potencialmente los dispositivos y las conexiones a Internet de otros usuarios fuera del título. También puede no estar permitida en determinadas plataformas por motivos de directivas. Asegúrese de usar las marcas adecuadas para sus objetivos de rendimiento y seguridad.

Además del valor de PartyNetworkConfiguration::directPeerConnectivityOptions de una red específica, un dispositivo puede restringir aún más de forma opcional las marcas para todas las redes en las que se autentique usando PartyManager::SetOption() para establecer PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask. Todas las marcas se evalúan mediante una operación AND bit a bit. Es decir, una marca determinada solo está en vigor para un par de dispositivos de una red concreta si está habilitada en tres lugares: la estructura PartyNetworkConfiguration de la red y las opciones de máscara local respectivas de ambos dispositivos. Aunque la red de Party permita la conectividad directa entre pares de la forma correspondiente, cualquiera de los dispositivos puede excluirse unilateralmente de la divulgación de la dirección IP y de los intentos de conexión directa entre ellos si no habilita la marca. El valor de PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask permite de manera predeterminada todas las conexiones directas entre pares habilitadas por las redes, por lo que solo necesita configurarlo si tiene requisitos específicos del dispositivo para impedir parte o la totalidad de la conectividad directa entre pares que lo implique.

Para evitar un consumo excesivo de recursos, la biblioteca de Party también impedirá internamente que un dispositivo determinado intente establecer más de un número máximo configurado de conexiones directas entre pares en todas las redes en las que participa actualmente, incluso si estas marcas lo permiten. Esto no afecta a la capacidad del dispositivo de participar en redes grandes o múltiples con más dispositivos remotos. La comunicación con los dispositivos adicionales simplemente se transmitirá a través de servidores de retransmisión transparentes en la nube. Para modificar ese número máximo de conexiones directas entre pares, use PartyManager::SetOption() para establecer PartyOption::LocalDeviceMaxDirectPeerConnections.

Se recomienda no exigir activamente la disponibilidad de una conexión directa de punto a punto para un par de dispositivos determinado (es decir, no llame a PartyNetwork::LeaveNetwork() si PartyNetwork::GetDeviceConnectionType() notifica un valor distinto de PartyDeviceConnectionType::DirectPeerConnection), ya que el método de transmisión subyacente específico en uso no altera la capacidad lógica general de comunicarse. Si el diseño de su juego tiene requisitos estrictos de latencia máxima de mensajes que favorecen la conectividad directa entre pares, es mejor actuar en función de las observaciones concretas actuales de esa latencia, notificadas por la estadística PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds, en lugar de hacer suposiciones abstractas basadas en el mecanismo de transmisión. De lo contrario, podría perjudicar continuamente a los usuarios que intentan jugar con el mismo grupo de amigos y que siempre necesitan usar servidores de retransmisión transparentes en la nube cercanos debido a factores del entorno fuera de su control.

Requisitos

Encabezado: Party.h

Consulte también

Miembros de Party
PartyNetworkConfiguration
PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask
PartyManager::SetOption
PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds
PartyLocalEndpoint::GetEndpointStatistics

​Sintaxis

​Constantes

​Comentarios

​Requisitos

​Consulte también

Sintaxis

Constantes

Comentarios

Requisitos

Consulte también