Sintaxis
enum class PartyOption : uint32_t
{
LocalUdpSocketBindAddress = 0,
LocalDeviceDirectPeerConnectivityOptionsMask = 1,
TextChatFilterLevel = 2,
LocalDeviceMaxDirectPeerConnections = 3,
RegionUpdateConfiguration = 4,
RegionQualityMeasurementConfiguration = 5,
}
Constantes
| Constante | Descripción | ||
|---|---|---|---|
| LocalUdpSocketBindAddress | Una opción que se usa para configurar cómo se enlaza la biblioteca de Party a un socket UDP. Para invalidar esta opción, llame a PartyManager::SetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero opcional a una estructura PartyLocalUdpSocketBindAddressConfiguration para el valor. Si se proporciona un puntero PartyLocalUdpSocketBindAddressConfiguration nulo, se restaura la configuración predeterminada. Para consultar esta opción, llame a PartyManager::GetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero a una estructura PartyLocalUdpSocketBindAddressConfiguration de salida para el valor. Es seguro y recomendable invalidar o consultar esta opción antes de inicializar la biblioteca de Party. La invalidación de la configuración de la dirección de enlace del socket UDP local surtirá efecto la próxima vez que se inicialice la biblioteca de Party. No modifica ningún enlace de socket de la biblioteca de Party que ya se haya inicializado. De forma similar, la consulta recupera la configuración que se usará con la próxima inicialización de la biblioteca de Party, no el valor activamente en uso si ya está inicializada. | ||
| LocalDeviceDirectPeerConnectivityOptionsMask | Una opción para restringir la conectividad directa entre pares permitida entre el dispositivo local y otros dispositivos en redes que permiten intentar dichas conexiones. Al autenticar correctamente un usuario local inicial en una red con un campo PartyNetworkConfiguration::directPeerConnectivityOptions establecido en un valor distinto de PartyDirectPeerConnectivityOptions::None, o cuando un dispositivo remoto se autentica en dicha red, es posible que se intente la conectividad directa entre pares entre este dispositivo local y los dispositivos remotos de la red. Las marcas configuradas por esta opción se pueden usar para restringir aún más los tipos específicos de dispositivos remotos que tienen permitido involucrar al dispositivo local en estos intentos. Todas las marcas se evalúan mediante una operación AND bit a bit. Es decir, una marca determinada solo está realmente 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 respectivas opciones de máscara local de ambos dispositivos. Incluso si la red de Party permite la conectividad directa entre pares de la forma correspondiente, cualquiera de los dispositivos puede excluirse unilateralmente de la divulgación de direcciones IP y de los intentos de conexión directa entre ellos al no habilitar la marca cuando se invalida esta opción. La conectividad directa entre pares es compatible con las versiones de la biblioteca para Windows, Microsoft Game Core, PlayStation®, Switch, Linux y macOS. En esas plataformas, el valor predeterminado de la máscara del dispositivo local cuando aún no se ha establecido es ```PartyDirectPeerConnectivityOptions::AnyPlatformType | PartyDirectPeerConnectivityOptions::AnyEntityLoginProvider | PartyDirectPeerConnectivityOptions::OnlyServers. Esto significa que dichos dispositivos no restringen ninguna conectividad directa entre pares permitida por la [PartyNetworkConfiguration](/services/playfab/multiplayer/networking/reference/structs/partynetworkconfiguration) de una red hasta que se invalide explícitamente para que sea menos permisiva. Para todas las demás versiones de la biblioteca, el valor predeterminado de la máscara del dispositivo local es PartyDirectPeerConnectivityOptions::None``` y no se puede cambiar; el intento de cambiarlo mediante PartyManager::SetOption fallará. Esto significa que dichos dispositivos nunca intentarán la conectividad directa entre pares. Para invalidar esta opción, llame a PartyManager::SetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero opcional a una variable PartyDirectPeerConnectivityOptions que contenga todas las marcas de opción deseadas. Si se proporciona un puntero PartyDirectPeerConnectivityOptions nulo, se restauran las opciones predeterminadas. Para consultar esta opción, llame a PartyManager::GetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero a una variable PartyDirectPeerConnectivityOptions en la que se deben escribir las marcas de opción configuradas actualmente. Se recomienda invalidar o consultar esta opción cuando no esté conectado a ninguna red. El valor configurado surte efecto la próxima vez que este dispositivo autentique un usuario inicial en una red nueva. No altera la configuración que ya se está usando para participar en redes existentes. De forma similar, la consulta recupera el valor configurado actualmente que se usará con las redes futuras, y no los valores usados con las redes existentes. También es seguro invalidar o consultar esta opción antes de inicializar la biblioteca de Party. |
| TextChatFilterLevel | Una opción para ajustar el nivel al que se filtrará el texto de chat. Esta característica solo se aplica al texto de chat entrante detectado como inglés. El nivel de filtro no se puede cambiar para otros idiomas. El nivel de filtro se aplicará al texto de chat entrante para todos los controles de chat locales del cliente. El filtrado debe habilitarse con PartyLocalChatControl::SetTextChatOptions para al menos un control de chat local para que esto tenga efecto en el texto de chat. Para invalidar esta opción, llame a PartyManager::SetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero opcional a una variable PartyTextChatFilterLevel que contenga el nivel de filtro deseado. Si se proporciona un puntero PartyTextChatFilterLevel nulo, se restaura el nivel predeterminado. Para consultar esta opción, llame a PartyManager::GetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero a una variable PartyTextChatFilterLevel en la que se debe escribir el nivel de filtro configurado actualmente. Es seguro invalidar o consultar esta opción en cualquier momento, incluso antes de inicializar la biblioteca de Party. El establecimiento de un nuevo valor surtirá efecto inmediatamente. | ||
| LocalDeviceMaxDirectPeerConnections | Una opción para configurar el número máximo de conexiones directas entre pares que este dispositivo intenta establecer con otros dispositivos. Al autenticar correctamente un usuario local inicial en una red con un campo PartyNetworkConfiguration::directPeerConnectivityOptions establecido en un valor distinto de PartyDirectPeerConnectivityOptions::None, los dispositivos pueden intentar la conectividad directa entre pares entre sí. Para evitar un consumo excesivo de recursos, la biblioteca de Party impedirá internamente que un dispositivo determinado intente establecer más conexiones directas entre pares que este máximo en todas las redes en las que participa actualmente. Esto no afecta a la capacidad del dispositivo para participar en redes grandes o múltiples con dispositivos remotos adicionales, simplemente define el número de oportunidades para que los mensajes de punto de conexión y los datos de chat entre los dispositivos se transmitan mediante esas conexiones directas en lugar de a través de servidores de retransmisión en la nube transparentes. Puede determinar si el dispositivo local estableció realmente una conexión directa entre pares con un dispositivo remoto específico de una red llamando a PartyNetwork::GetDeviceConnectionType(). El valor predeterminado de esta opción es c_maxDirectPeerConnectionsPerDevice, aunque cuando se usa la configuración predeterminada, el valor solo se aplica al autenticar un usuario local con un tipo de entidad de PlayFab de title_player_account. En cambio, al autenticar un usuario local con un tipo de entidad de PlayFab de game_server con la configuración de opción predeterminada, no hay un número máximo de conexiones directas entre pares. Para invalidar este valor independientemente del tipo de entidad de PlayFab, llame a PartyManager::SetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero opcional a una variable uint32_t para el valor. Si se proporciona un puntero uint32_t nulo, se restauran el valor y el comportamiento predeterminados. Para consultar esta opción, llame a PartyManager::GetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero a una variable uint32_t en la que se debe escribir el valor configurado actualmente. Es seguro invalidar o consultar esta opción en cualquier momento, incluso antes de inicializar la biblioteca de Party. El establecimiento de un nuevo valor surtirá efecto para todas las redes a las que se una después de cambiar el valor. | ||
| RegionUpdateConfiguration | Una opción que se usa para configurar cuándo la biblioteca de Party realiza actualizaciones automáticas de detección de regiones y de medición de calidad de conexión. Para invalidar esta opción, llame a PartyManager::SetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero opcional a una estructura PartyRegionUpdateConfiguration para el valor. Si se proporciona un puntero PartyRegionUpdateConfiguration nulo, se restaura la configuración predeterminada. Para consultar esta opción, llame a PartyManager::GetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero a una estructura PartyRegionUpdateConfiguration de salida para el valor. Es seguro invalidar o consultar esta opción en cualquier momento, incluso antes de inicializar la biblioteca de Party. La invalidación de la configuración de actualización de regiones surtirá efecto inmediatamente. | ||
| RegionQualityMeasurementConfiguration | Una opción que se usa para un control detallado del comportamiento de medición de calidad de regiones de la biblioteca de Party. Para invalidar esta opción, llame a PartyManager::SetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero opcional a una estructura PartyRegionQualityMeasurementConfiguration para el valor. Si se proporciona un puntero PartyRegionQualityMeasurementConfiguration nulo, se restaura la configuración predeterminada. Para consultar esta opción, llame a PartyManager::GetOption pasando null para el parámetro de objeto, este valor para el parámetro de opción y un puntero a una estructura PartyRegionQualityMeasurementConfiguration de salida para el valor. Es seguro invalidar o consultar esta opción en cualquier momento, incluso antes de inicializar la biblioteca de Party. La invalidación de la configuración de medición de calidad de regiones surtirá efecto con la próxima actualización de regiones. |
Requisitos
Encabezado: Party.hConsulte también
Miembros de PartyPartyManager::SetOption
PartyManager::GetOption
PartyLocalUdpSocketBindAddressConfiguration
PartyNetworkConfiguration
PartyDirectPeerConnectivityOptions
PartyRegionUpdateConfiguration
PartyRegionQualityMeasurementConfiguration