El soporte para las plataformas XDK y Windows 7 finalizó el 1 de agosto de 2023. No se publicarán nuevas actualizaciones de la biblioteca PlayFab Party para esas plataformas. Los servicios de red y voz de PlayFab Party siguen funcionando sin impacto alguno para los títulos que actualmente usan las versiones de Windows 7 o XDK de la biblioteca PlayFab Party.
El soporte para las plataformas Android de 32 bits (arm7 y x86) finalizó el 19 de octubre de 2023. No se publicarán nuevas actualizaciones de la biblioteca PlayFab Party para esas plataformas. Los servicios de red y voz de PlayFab Party seguirán funcionando sin impacto alguno para los títulos que actualmente usan la biblioteca PlayFab Party en plataformas Android de 32 bits.
1.10.25
24 de julio de 2026Correcciones de errores
- GDK: Se mejoró la resiliencia ante fallos en la consulta del puerto multijugador preferido en PC. Los fallos recuperables recurrirán a la selección de puertos efímeros en PC. Los títulos que quieran un control más estricto sobre la selección de puertos en GDK PC pueden usar
PartyLocalUdpSocketBindAddressConfigurationpara definir políticas alternativas de selección de puertos. - GDK: Se proporcionan valores de
PartyErrormás claros en caso de fallos internos inesperados del entorno de ejecución del GDK.
1.10.24
20 de julio de 2026Correcciones de errores
- Se corrigió que los flujos de voz de manipulación de audio no produjeran búferes cuando el título aún no había configurado una salida de audio.
- Android: Se corrigió un fallo que podía producirse durante la creación de subprocesos trabajadores cuando fallaba el establecimiento de la afinidad de CPU del subproceso.
- Apple: Se corrigió que el micrófono y la captura de audio no se recuperaran después de que la aplicación perdiera y recuperara el foco de audio.
- Linux: Se corrigió el estancamiento de las solicitudes de voz a texto y otras solicitudes HTTP.
1.10.23
5 de junio de 2026Correcciones de errores
- Linux: Se corrigieron las solicitudes HTTPS para que verifiquen las credenciales TLS del servidor.
- Android: Se corrigió una posible fuga de memoria durante PartyCleanup al usar NDK 25 o anterior.
- Se corrigieron las conexiones Websocket para que verifiquen las credenciales TLS del servidor.
1.10.22
15 de mayo de 2026Correcciones de errores
- Se corrigió un problema por el cual el cambio de dispositivo de audio podía fallar en macOS al estar conectado a una red de Party.
1.10.21
13 de mayo de 2026- Se actualizó el conjunto de herramientas de plataforma de Windows utilizado para compilar la biblioteca de v142 a v143.
Correcciones de errores
- Se corrigió una posible pérdida de voz al hacer la transición entre redes mientras la manipulación de audio está activa.
- Se corrigió la falta de la transcripción final de voz a texto cuando hay un flujo de captura de manipulación de audio activo.
- Se corrigió un posible fallo durante el cierre cuando la cola de tareas del proceso se eliminaba antes de que Party terminara de apagarse.
- Android: Se corrigió un posible fallo al llamar a
PartyManager::Initializeinmediatamente después dePartyManager::Cleanup. - Android: Se corrigió una fuga de memoria en
PartyManager::Cleanup. - Apple: Se restauró el soporte de arm64 (Apple Silicon) en el binario universal de macOS, que se había eliminado involuntariamente en una versión anterior.
- Se corrigió un posible use-after-free por el cual los objetos internos de seguimiento HTTP podían eliminarse antes de que se completara la tarea asincrónica subyacente.
- Linux: Se evitaron posibles fallos causados por bibliotecas estáticas sobrescritas cuando varios objetos compartidos enlazan la misma dependencia.
1.10.20
29 de abril de 2026- PlayStation®5: Se corrigió el análisis de respuestas HTTP para propagar correctamente los valores JSON nulos.
1.10.19
22 de abril de 2026- Nintendo Switch 2: Se actualizó la compatibilidad con Nintendo SDK 22 eliminando las API obsoletas de códigos de idioma y resolviendo un problema de compilación de C++20.
1.10.18
26 de marzo de 2026- Se mejoró el hardening del enlazador de Linux para PlayFab Party.
1.10.17
23 de febrero de 2026- Android: Se corrigió que los micrófonos Bluetooth no funcionaran.
- Linux: Se eliminó SafeStack.
- Apple: Se ocultaron los símbolos de OpenSSL de Party.
- Nintendo Switch 2: Se resolvió un error de conexión TCP cuando cambia la IP.
1.10.16
2 de febrero de 2026- GDK: Se añadió compatibilidad con entornos que usan GRTS in-proc.
- GDK: Se añadió compatibilidad con
PartyAudioDeviceSelectionType::SystemDefault.
Correcciones de errores
- Se corrigió un posible fallo en escenarios de transición entre varias redes.
1.10.15
17 de diciembre de 2025- Nintendo Switch 2: Se añadió un tiempo de espera de 10 segundos para las solicitudes web.
1.10.14
9 de diciembre de 2025- Se cambió el comportamiento de PartyStatusChangeResult de
PartyNetwork::CreateEndpointpara devolverPartyServiceErroren errores transitorios que se producen antes de que expire el token, y devolverUserNotAuthorizedsolo cuando el token ha expirado. - Android: Se añadió compatibilidad con tamaños de página de 16 KB para cumplir con los nuevos requisitos de tamaño de página de Android.
1.10.13
14 de octubre de 2025- Se corrigió un problema que causaba que el micrófono no funcionara correctamente en iOS 26.
- Apple: Se añadió compatibilidad con Arm64.xcframework en iOS.
1.10.12
6 de octubre de 2025- Se cambió el comportamiento de PartyStatusChangeResult de
PartyNetwork::CreateEndpointpara devolverPartyServiceErroren errores transitorios que se producen antes de que expire el token, y devolverUserNotAuthorizedsolo cuando el token ha expirado. - Android: Se añadió compatibilidad con tamaños de página de 16 KB para cumplir con los nuevos requisitos de tamaño de página de Android.
- Apple: Se añadió compatibilidad con compilaciones de simulador Arm64 en iOS.
Correcciones de errores
- Se corrigió un problema por el cual la biblioteca puede fallar cuando se llama a PartyManager::Cleanup.
- Apple: Se añadió lógica de reintento para la recuperación del foco del micrófono después de interrupciones en iOS.
- Apple: Se corrigió una fuga de memoria que podía producirse durante el chat de voz y la transcripción de Party.
- Apple: Se corrigió un posible bloqueo en PartyLocalChatControl cuando varios jugadores remotos están conectados desde distintas plataformas.
- Apple: Se añadió compatibilidad con compilaciones de simulador Arm64 en iOS.
1.10.9
11 de marzo de 2025- Nintendo Switch: Corrección de un fallo al cargar las DLL de la variante de distribución (shipping) de la biblioteca con el registro habilitado.
1.10.8
24 de enero de 2025- PlayStation®4 y PlayStation®5: Se resolvió un fallo relacionado con el enmascaramiento de palabras malsonantes en las plataformas PlayStation.
1.10.6
10 de diciembre de 2024- PlayStation®4 y PlayStation®5: Se resolvieron advertencias y errores de compilación para la integración con C++14 y versiones posteriores.
1.10.5
18 de noviembre de 2024- Se corrigió un problema por el cual el chat de voz a veces no funcionaba para los usuarios que permanecían en una red de Party después de que otros usuarios se reincorporaran y salieran varias veces.
- Se corrigió un problema por el cual PartyLocalEndpoint::GetEndpointStatistics notificaba valores incorrectos para PartyEndpointStatistic::CurrentlyQueuedSendMessages y PartyEndpointStatistic::CurrentlyQueuedSendMessageBytes cuando se usaba con conexiones directas entre pares.
- Se corrigieron enlaces simbólicos rotos del framework en macOS.
- Se mejoró el manejo de excepciones de registro para plataformas distintas de Windows durante la recopilación de registros del SDK.
1.10.4
12 de noviembre de 2024- PlayStation®4 y PlayStation®5: Se resolvieron fallos relacionados con operaciones de mutex y cambios de estado de puntos de conexión durante la creación y la destrucción.
1.10.3
14 de octubre de 2024- Se añadió compatibilidad con hasta 128 dispositivos por red. Para más información, consulta Redes escalables.
- Se aumentó
c_maxNetworkConfigurationMaxDeviceCountde 32 a 128. - Se actualizaron los diagnósticos internos.
- Se actualizó la configuración de compilación para el endurecimiento de la seguridad.
- Se corrigió un problema con símbolos expuestos de OpenSSL en la plataforma macOS.
1.10.2
18 de septiembre de 2024Correcciones de errores
- Se corrigió un problema por el cual la biblioteca podía fallar al establecer conexiones directas entre pares en redes con tres o más dispositivos.
1.10.0
5 de agosto de 2024- Se añadió compatibilidad con entidades
game_server, de modo que los servidores puedan conectarse a redes de Party a través del SDK y ser identificados de forma segura por los clientes del juego. Después de autenticar una entidadgame_servermedianteAuthenticateGameServerWithCustomId, esta puede añadirse como usuario local a través de PartyManager::CreateLocalUserWithEntityType. - Se añadieron métodos para determinar el tipo de entidad asociado a cada entidad de la biblioteca. Para más información, consulta PartyLocalUser::GetEntityType, PartyEndpoint::GetEntityType y PartyChatControl::GetEntityType.
- Se añadió una opción de conectividad directa entre pares que habilita las conexiones directas entre entidades
title_playerygame_servermientras impide las conexiones directas entre entidadestitle_playery otras entidadestitle_player. Para más información, consulta PartyDirectPeerConnectivityOptions::OnlyServers. - Se añadieron métodos para recuperar una lista conveniente de puntos de conexión según filtros. Para más información, consulta PartyNetwork::GetEndpointsByUserType.
- Se actualizaron las asignaciones de memoria de las bibliotecas de terceros usadas en PlayFab Party en PlayStation®4 y PlayStation®5 que usaban asignadores predeterminados para que usen las devoluciones de llamada de memoria de Party. Los títulos que usan PartyManager::SetMemoryCallbacks para configurar funciones de asignación de memoria específicas del título ahora verán y tendrán control sobre estas asignaciones.
Correcciones de errores
- Se corrigió un problema por el cual la biblioteca podía fallar en Windows o XBOX mientras el proceso está finalizando.
- Se abordaron fallos espurios de conexión directa entre pares después de que un intento de conexión anterior fallara en ciertos casos en plataformas distintas de Windows.
- Se corrigió un problema por el cual el evento DestroyNetwork no se activaba durante la creación y destrucción repetidas de redes de Party.
Problemas conocidos
- La biblioteca puede fallar ocasionalmente al establecer conexiones directas entre pares en redes con tres o más dispositivos.
1.9.5
3 de mayo de 2024- Se abordaron errores fatales intermitentes notificados en PartyRegionsChangedStateChange y otras operaciones por dispositivos Windows que usan características como el uso compartido de conexión.
- Se corrigió un posible fallo en Windows y XBOX si el proceso se cierra poco después de empezar a usar Party.
- Se corrigió un error por el cual los recursos de
PartyChatControla veces no se liberaban después de llamar a PartyLocalDevice::DestroyChatControl y solo se liberaban después de llamar a PartyManager::Cleanup. - Android: Se resolvió un error de clase duplicada cuando Party y Multiplayer se usan en la misma aplicación.
1.9.4
20 de marzo de 2024- Se corrigió un error por el cual
PartyLocalDevice::CreateChatControlfallaba en PlayStation®4 y PlayStation®5 cuando el ucraniano está establecido como idioma de la consola.
1.9.3
14 de marzo de 2024- Se corrigió un posible error de use-after-free cuando la conversión de voz a texto está habilitada.
- Se corrigió un posible fallo cuando las conexiones directas entre pares están habilitadas.
- Se mejoraron los diagnósticos internos.
1.9.2
5 de marzo de 2024- Se corrigió un error de reproducción de audio en la plataforma Linux. Los clientes de Linux ahora pueden oír plenamente a los clientes de otras plataformas.
1.9.1
5 de febrero de 2024- Se añadieron
PartyOption::RegionUpdateConfigurationyPartyOption::RegionQualityMeasurementConfigurationpara un control avanzado sobre cuándo y cómo la biblioteca Party realiza el descubrimiento automático de regiones y las mediciones de calidad de conexión.
1.8.11
13 de noviembre de 2023- Se corrigió un error por el cual podía producirse un fallo cuando un cliente intenta abandonar una red en Nintendo Switch.
1.8.10
19 de octubre de 2023 Esta versión actualiza la versión mínima del SDK y la versión de destino del SDK para las plataformas Apple y Android de PlayFab Party. Para las plataformas Apple, seguimos las directrices de Xcode de Apple con la publicación de Xcode 15.- iOS
- El Minimum Deployment Target se aumentó de iOS 10 a iOS 12.
- La Target Deployment Version se aumentó de iOS 16 a iOS 17.
- macOS
- La Target Deployment Version se aumentó de macOS 13.3 a macOS 14.
- El Minimum Deployment Target se redujo de macOS 12.3 a macOS 10.13 en la versión v.1.8.8.
- Android
- La Minimum SDK Version se aumentó de Android API 19 a Android API 21.
- La Target SDK Version se aumentó de Android API 28 a Android API 34.
- La Compile SDK Version se aumentó de Android API 28 a Android API 34.
- El soporte para las plataformas Android de 32 bits (arm7 y x86) finalizó el 19 de octubre de 2023. No se publicarán nuevas actualizaciones de la biblioteca PlayFab Party para esas plataformas. Los servicios de red y voz de PlayFab Party seguirán funcionando sin impacto alguno para los títulos que actualmente usan la biblioteca PlayFab Party en plataformas Android de 32 bits.
1.8.9
20 de octubre de 2023- Se implementaron propiedades compartidas para puntos de conexión. Las propiedades compartidas pueden establecerse al crear un punto de conexión mediante
PartyNetwork::CreateEndpoint. Una propiedad compartida puede recuperarse usandoPartyEndpoint::GetSharedProperty. - Se mejoró el encolado de paquetes de audio para reducir la latencia percibida del audio del chat en algunos escenarios.
- Se actualizó la versión interna del códec Opus.
- Se corrigió un fallo de baja frecuencia.
- Se mejoraron los diagnósticos internos.
- Se eliminó el soporte para Windows 7.
1.8.5
28 de junio de 2023Correcciones de errores
- Se corrigió un error por el cual
PartyLocalChatControl::SetAudioRenderVolumeno funcionaba correctamente en Nintendo Switch, PlayStation®4 y PlayStation®5.
1.8.3
2 de junio de 2023- PlayFab Party versión 1.8 publicada para Nintendo Switch con todas las correcciones de errores y nuevas funciones desde la última versión para Nintendo Switch (versión 1.7.15).
1.8.2
30 de mayo de 2023Correcciones de errores
- Se corrigió un error por el cual la biblioteca PlayFab Party requería que la versión de macOS fuera al menos 13.1. La nueva versión establece la versión mínima de macOS en 12.3.
1.8.0
8 de mayo de 2023- Se añadió una opción para configurar el número máximo de conexiones directas entre pares que el dispositivo intenta establecer con otros dispositivos. Para más información, consulta
PartyOption::LocalDeviceMaxDirectPeerConnections. - iOS, Android: Se añadió compatibilidad para habilitar la supresión de ruido en el audio capturado desde un control de chat local. Para más información, consulta
PartyLocalChatControl::SetVoiceAudioOptions.
Correcciones de errores
- Se corrigió un error por el cual la biblioteca podía tener fugas de memoria debido al seguimiento diagnóstico interno cuando expira el token de entidad del usuario.
1.7.23
1 de abril de 2023- Se añadió compatibilidad con la manipulación de audio en tiempo real en la plataforma PlayStation®5.
1.7.22
30 de marzo de 2023Correcciones de errores
- Se corrigió un error por el cual Party podía fallar si no se limpiaba antes de que el proceso anfitrión empezara a cerrarse.
- Se cambió el comportamiento de las conexiones entre pares para recurrir a una conexión retransmitida si el enlace se desconecta inesperadamente. El comportamiento anterior desconectaba a ambos dispositivos de la red.
1.7.20
8 de febrero de 2023Correcciones de errores
- Se corrigió un error por el cual el audio de los micrófonos de 44,1 kHz podía sonar distorsionado.
- Se mejoraron los mensajes de error de diagnóstico para los errores de red notificados por PartyManager::GetErrorMessage().
1.7.19
11 de noviembre de 2022Correcciones de errores
- Se corrigió un error que impedía abrir una solicitud web después de cierto momento en Linux.
1.7.17
7 de octubre de 2022Correcciones de errores
- Se corrigió un error por el cual podía producirse un fallo cuando un control de chat está conectado a una red en iOS.
- Se corrigió un error por el cual podía producirse un fallo al habilitar el registro de iOS.
1.7.16
27 de septiembre de 2022Nueva versión de Bundle para macOS
- Se añadió un .bundle para la carga de plug-ins de Unity y el desarrollo nativo en macOS.
Correcciones de errores
- Se corrigió un error por el cual podía producirse un fallo al habilitar el registro de macOS.
1.7.14
12 de agosto de 2022Nuevos SDK para Linux y macOS
- Se añadió compatibilidad nativa con PlayFab Party en Linux y macOS, lo que permite a los desarrolladores de juegos crear experiencias multijugador en tiempo real multiplataforma o de varias plataformas en aún más plataformas. Para ver enlaces a estas y otras versiones del SDK, consulta SDK de PlayFab Party.
- Se presenta PlayFab Party para Linux
1.7.11
24 de junio de 2022Correcciones de errores
- Se corrigió un problema por el cual una única asignación de memoria permanecía tras una llamada a
PartyManager::Cleanup().
1.7.8
21 de abril de 2022Correcciones de errores
- Se corrigió un problema por el cual la memoria no se limpiaba por completo al llamar a
PartyManager::Cleanup(). - Se corrigió un problema por el cual llamar a
PartyLocalChatControl::SetAudioInput()oPartyLocalChatControl::SetAudioOutput()con la misma selección de dispositivo de audio provocaba innecesariamente que la biblioteca reinicializara el dispositivo de audio.
1.7.7
16 de marzo de 2022Correcciones de errores
- PlayStation®4, PlayStation®5: Se corrigió un fallo que se producía cuando no había ningún dispositivo de audio después de que se retiraran los dispositivos de audio.
- Switch: Se corrigió un problema que hacía que las solicitudes web fallaran cuando se activaban varias transacciones de PlayFab.
1.7.6
8 de febrero de 2022Mejoras de rendimiento
- Windows, XDK, Nintendo Switch, PlayStation 4, PlayStation 5: Se eliminaron dos subprocesos trabajadores y el trabajo correspondiente se realiza en un subproceso de trabajo preexistente de menor frecuencia. La versión de la biblioteca del Microsoft Game Development Kit (GDK) ya tenía este comportamiento de trabajo agrupado.
Correcciones de errores
- iOS, Android, Switch, PlayStation 4, PlayStation 5 y Stadia: Se corrigió que una pequeña cantidad de memoria asignada durante la inicialización no se liberara correctamente durante la limpieza.
- Se evita notificar el indicador PartyChatTextReceivedOptions::FilteredDueToError en PartyChatTextReceivedStateChange cuando la moderación de texto no está habilitada.
1.7.5
30 de septiembre de 2021Correcciones de errores
- Se corrigió un problema por el cual algunos micrófonos de 16 kHz no funcionaban.
- Se corrigió un problema por el cual los cambios de permisos del micrófono no se gestionaban en Windows.
- Se corrigió una fuga de memoria en algunas condiciones de fallo de
PartyManager::CreateNewNetwork(). - Se corrigió un fallo ocasional en
PartyLocalEndpoint::GetEndpointStatistics().
1.7.0
29 de junio de 2021Nuevos hooks de generación de perfiles e indicadores de controles de chat
- Los desarrolladores interesados en saber dónde se emplea el tiempo en las funciones internas de la biblioteca ahora pueden configurar devoluciones de llamada opcionales de entrada y salida de métodos para conectarse a su método de instrumentación de alto rendimiento preferido. Para más información, consulta
PartyManager::SetProfilingCallbacksForMethodEntryExit. En esta versión, las devoluciones de llamada solo son compatibles con las plataformas Windows, XBOX One XDK y Microsoft Game Core. - Los nuevos indicadores de control de chat NoRemoteInput y RemoteAudioInputMuted proporcionan mayor granularidad sobre el estado de audio actualmente silencioso. Para más información, consulta
PartyChatControlChatIndicator.
Mejoras en el comportamiento de mensajes de puntos de conexión
- El campo
timeoutInMillisecondsde ‘PartySendMessageQueuingConfiguration’ ahora también es evaluado por el relé transparente en la nube si se ve obligado a encolar mensajes antes de reenviarlos debido a diferencias en las condiciones de red o en la capacidad de respuesta de los destinos remotos. - Cuando la autenticación en una red está completa, enviar a una matriz de 0 entradas apunta correctamente al conjunto exacto de todos los puntos de conexión remotos que la biblioteca notifica actualmente en la red en ese momento. Los puntos de conexión que se están creando mientras el mensaje está en proceso de transmisión ya no se incluyen potencialmente.
1.6.1
Correcciones de errores
- Se corrigió un error por el cual podía producirse un fallo cuando un control de chat se conecta a una red mientras ese mismo control de chat se está desconectando de otra red.
1.6.0
12 de abril de 2021Nuevas funciones de control de subprocesos y moderación de texto
- El trabajo de la biblioteca ahora puede ejecutarse manualmente en subprocesos controlados por el juego. Para más información, consulta
PartyManager::SetWorkMode. - El chat de texto ofensivo ahora puede filtrarse opcionalmente. Para más información, consulta Uso de la moderación de texto.
Numeración explícita de enums en el encabezado
- Los valores de enum del encabezado ahora tienen numeración explícita.
1.5.13
26 de marzo de 2021Correcciones de errores
- Se corrigió un error por el cual el audio se cortaba en dispositivos iOS que usan auriculares Bluetooth.
- Se corrigió un error por el cual se generaba un código de error incorrecto cuando la aplicación no tiene permiso para activar un micrófono en plataformas Windows.
- Se corrigió un error por el cual un dispositivo en mal estado no se actualizaba a menos que otra cosa forzara una actualización.
- Se corrigió un error por el cual podía producirse un fallo al desreferenciar los datos de usuario de un canal de envío después de que el punto de conexión de origen asociado a ese canal dejara de ser válido.
- Se corrigió un error por el cual los clientes experimentaban fallos silenciosos si un control de chat remoto no tiene un código de idioma.
1.5.10
Correcciones de errores
- Se corrigió un error por el cual la biblioteca podía no inicializarse en algunos dispositivos Windows debido a una discrepancia entre la afinidad de procesador del proceso y la afinidad de subprocesos predeterminada de la biblioteca.
- Se corrigió un error por el cual la biblioteca podía no proporcionar errores cuando una operación falla debido a un fallo interno de una solicitud web.
- Se corrigió un error por el cual podía producirse un fallo cuando la conectividad directa entre pares está habilitada y la biblioteca intenta establecer conectividad directa con otro dispositivo.
- Se corrigió un error que podía provocar audio entrecortado o distorsionado.
1.5.1
5 de septiembre de 2020Corrección de errores
- Se corrigió un error por el cual la biblioteca no lograba activar el micrófono en iOS.
1.5.0
Nuevas funciones de conectividad directa entre pares, latencia y voz a texto
- La conectividad directa entre pares ahora es compatible con las versiones de la biblioteca para Windows 10 y Microsoft Game Core. Para más información, consulta Uso de la conectividad directa entre pares.
- La latencia de ida y vuelta entre el dispositivo local y un dispositivo remoto ahora puede consultarse a través de la biblioteca. Para más información, consulta
PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds - El enmascaramiento de palabras malsonantes en la conversión de voz a texto ahora puede deshabilitarse. Para más información, consulta
PartyVoiceChatTranscriptionOptions::DisableProfanityMasking.
Correcciones de errores de audio en Android e iOS
- Android: El administrador de Bluetooth se inicializará la primera vez que se llame a
PartyLocalDevice::CreateChatControl(), en lugar de cuando se llama aPartyManager::Initialize(). - iOS: Se corrigió un pequeño artefacto de sonido cuando se llama a
PartyManager::Initialize().
1.4.13
Problema de dependencia de Windows 8.1
Esta versión elimina una dependencia innecesaria de api-ms-win-core-version-l1-1-1.dll que impedía que las versiones anteriores funcionaran en Windows 8.11.4.8
30 de abril de 2020TLS1.2
- La pila de transcripción se ha actualizado para usar TLS1.2 en Windows 7, Android e iOS. Actualiza si usas alguna de estas plataformas, ya que el soporte de TLS1.1 quedará obsoleto en Azure Speech Services a partir de septiembre de 2020. Todas las demás plataformas ya son compatibles con TLS1.2 y no es necesaria ninguna actualización.
Correcciones de errores
- Se corrigió un error por el cual el campo
languageCodede la estructuraPartyCreateChatControlCompletedStateChangeno se rellenaba. - Se corrigió un error que inflaba artificialmente las mediciones de latencia notificadas por
PartyManager::GetRegions(). - Se corrigió un error que permitía llamar a
PartyManager::SetMemoryCallbacks()en momentos no seguros. - Se corrigió un error por el cual llamar a
PartyManager::DestroyLocalUser()con unPartyLocalUseren unaPartyNetworkgeneraba unPartyLocalUserRemovedStateChangecon un valor incorrecto en el campo removedReason,PartyLocalUserRemovedReason::RemoveLocalUser, en lugar del valor correcto,PartyLocalUserRemovedReason::DestroyLocalUser.
Cambios varios
- Se ha reducido el ancho de banda utilizado por los datos de chat.
- Ahora se proporcionan códigos de error y mensajes de error más descriptivos cuando se encuentran problemas de sandbox en XBOX.
PartyManager::Initialize()ahora falla si se proporciona un PlayFab Title ID vacío.- Pasar tokens de entidad de PlayFab no válidos a
PartyManager::CreateLocalUser()ahora resultará en mensajes de error más descriptivos en los resultados de cambio de estado de las operaciones que dependen de un token válido. - Se corrigieron erratas en la documentación del encabezado.
- Ahora se proporcionan un código de error y un mensaje de error más descriptivos cuando se pasa una región no válida a
PartyManager::CreateNewNetwork(). - Se aclaró la documentación sobre los tiempos de vida de los valores
PartyStringpara las estructuras e interfaces de Party.h. - Se aclaró la documentación de
PartyManager::Cleanup()para explicar que no es una llamada segura para subprocesos. - Se proporcionan un código de error y un mensaje de error más descriptivos cuando
PartyManager::ConnectToNetwork()falla de forma asincrónica con errores de conectividad a Internet.
1.3.0
Cambios en la API de chat
- Las funciones de manipulación de audio en tiempo real, que pueden usarse para modificar el audio saliente o entrante del chat de voz, están implementadas para Windows y XBOX. Para más información, consulta Uso de la manipulación de audio en tiempo real para aplicar efectos de voz personalizados.
- Las opciones de permisos de chat tienen más opciones para configurar opcionalmente los permisos de texto a voz y de audio de micrófono de forma independiente. Para más información, consulta
PartyChatPermissionOptions. - Esto rompe la compatibilidad con versiones anteriores de la biblioteca auxiliar de XBOX Live. Esta versión es compatible con la versión 1.2.0 de la biblioteca auxiliar de XBOX Live. Para más información, consulta las notas de la versión de la biblioteca auxiliar de XBOX Live.
- Cada cambio de estado de transcripción ahora indica si representa texto a voz o audio de micrófono. Para más información, consulta
PartyVoiceChatTranscriptionReceivedStateChange.
1.2.2
Cambios de iOS
- Añade compatibilidad con la API de control de volumen.
1.2.0
Cambios de Android
- Añade compatibilidad con la API de control de volumen.
- Elimina la gestión del foco de audio de la biblioteca. Ahora se espera que las aplicaciones anfitrionas implementen su propia lógica de gestión del foco.
1.0.2
- Se corrigió un fallo en la telemetría en segundo plano.
1.0.1
Cambios en la API de Party
Cambios en PartyManager::SetMemoryCallbacks
Esta versión de Party añade correcciones paraPartyManager::SetMemoryCallbacks() y también restricciones sobre cuándo es seguro llamar a esta API. Consulta la documentación de referencia de la API en Party.h para más detalles.
Eliminación de PartyStateChangeResult::TitleCreateNetworkThrottled
El valorTitleCreateNetworkThrottled de PartyStateChangeResult se ha eliminado de la API, ya que la biblioteca Party nunca lo genera.
0.7.0-prerelease
Cambios de empaquetado en Windows
Esta versión de Party introduce un nuevo paquete NuGet, Microsoft.PlayFab.PlayFabParty.Cpp.Windows, que reemplaza y deja obsoletos los paquetes NuGet específicos de Windows 10 y Windows 7 (Microsoft.PlayFab.PlayFabParty.Cpp.Win10 y Microsoft.PlayFab.PlayFabParty.Cpp.Win7, respectivamente). El nuevo paquete NuGet unificado de Windows contiene dos nuevas DLL, PartyWin.dll (compatible con Windows 8.1 y versiones posteriores) y PartyWin7.dll (solo para su uso en Windows 7). Con el nuevo paquete NuGet unificado de Windows, la DLL de Party correcta se carga según la detección en tiempo de ejecución de la versión del sistema operativo, por lo que tanto PartyWin.dll como PartyWin7.dll deben incluirse en el paquete de distribución del juego.Cambios de Android
La variante de Android ahora usa un objeto compartido para Party (libparty.so) en lugar de una biblioteca estática (libparty.a). Esta versión también contiene correcciones de errores específicas de Android para la selección de dispositivos de audio.Cambios de iOS
La variante de iOS de Party ahora incluye el paquete de framework para la carga dinámica de libparty en lugar de la libparty.a compilada estáticamente.Cambios en la API
API UpdateEntityToken
Esta versión de Party introduce un cambio relacionado con el manejo de los tokens de entidad de PlayFab. En la versión anterior, el juego proporcionaba a Party el token de entidad de un usuario en la APIPartyManager::CreateLocalUser(). A partir de entonces, Party actualizaba internamente el token de entidad y lo mantenía al día.
En esta versión, el comportamiento interno de actualización de tokens se ha eliminado y reemplazado por una nueva API, PartyLocalUser::UpdateEntityToken(). Ahora, el llamador es responsable de supervisar la expiración del token de entidad proporcionado a PartyManager::CreateLocalUser() y PartyLocalUser::UpdateEntityToken(). Cuando el token está cerca de su tiempo de expiración o ya lo ha superado, debe obtenerse un nuevo token realizando una operación de inicio de sesión de PlayFab y proporcionarse a la biblioteca Party llamando a PartyLocalUser::UpdateEntityToken(). Se recomienda adquirir un nuevo token cuando el token proporcionado anteriormente esté a la mitad de su periodo de validez. En plataformas que entran en un estado de bajo consumo o que pausan la ejecución de la aplicación durante mucho tiempo, es posible que el token no pueda actualizarse antes de que expire. Debe comprobarse la expiración del token una vez que se reanude la ejecución.
El flujo aproximado es el siguiente:
- El juego llama a una API
LoginWith*de PlayFab - La respuesta de PlayFab contiene el token de entidad y también el tiempo de expiración
- Proporciona la información del token a Party con la API
PartyManager::CreateLocalUser(), como antes - [Nuevo] Toma nota del tiempo de expiración para saber cuándo actualizarlo
- [Nuevo] A la mitad del tiempo de expiración del token (o en la primera oportunidad después de ese momento), adquiere un token nuevo llamando de nuevo a
LoginWith*y haz seguimiento del tiempo de expiración del nuevo token - [Nuevo] Llama a
PartyLocalUser::UpdateEntityToken()para pasar el nuevo token a Party
- El acto de adquirir un token de entidad no invalida los tokens de entidad obtenidos anteriormente. Estos siguen siendo válidos hasta que expiran.
- La funcionalidad de actualización interna se eliminó porque se espera que la mayoría de los juegos realicen sus propias llamadas a PlayFab. Que tanto el juego como la biblioteca Party obtengan tokens de entidad causa una carga innecesaria en el servicio para administrar dos conjuntos de tokens.
Cambios en la API de chat
ElPartyVoiceChatTranscriptionReceivedStateChange ahora incluye un campo languageCode, que indica el idioma de la transcripción.
El PartyChatTextReceivedStateChange ahora incluye un campo languageCode, que indica el idioma del texto del chat. El campo languageCode se rellenará cuando se haya habilitado la traducción del texto del chat mediante PartyLocalChatControl::SetTextChatOptions().
0.6.0-prerelease
Se añadió compatibilidad con las plataformas iOS, Android y Nintendo Switch. Para más información, consulta los siguientes enlaces: iOS/Android0.5.0-prerelease
Cambios en la API
Chat accesible
- Se añadió compatibilidad con la narración de texto a voz. (consulta
PartyLocalChatControl::SetTextToSpeechProfile()) - Se añadieron más opciones para controlar cuándo se produce la conversión de voz a texto. (consulta
PartyLocalChatControl::SetTranscriptionOptions()) - Se añadió la traducción de texto a texto a la API, aunque aún no es compatible. (consulta
PartyLocalChatControl::SetTextChatOptions()) - Se redujo el uso de ancho de banda y memoria del texto a voz.
Control de acceso a la red
PartyNetwork::SetAccessControlList()y los métodos relacionados se han eliminado de la API. Usa la nueva clasePartyInvitationy los métodos relacionados para crear invitaciones abiertas o conceder acceso a usuarios específicos de PlayFab a tus redes de Party.
0.4.6-prerelease
Cambios en la API
Se añadió la nueva API públicaPartyLocalUser::UpdateEntityToken().
0.2.0-prerelease
Cambios en la API
PartyManager::Initializeahora requiere que se le pase un PlayFab Title ID válido.