Notas de la versión del SDK de C/C++ de PlayFab Services

​

2604.0.1

​

Cambios importantes

• Se quitaron PFInventoryGetMicrosoftStoreAccessTokensAsync, sus funciones de resultado y sus tipos de solicitud y respuesta tras la retirada de la API del servicio.
• Se quitaron PFSegmentsServerGetPlayersInSegmentAsync, sus funciones de resultado y sus tipos auxiliares tras la retirada de la API del servicio.
• Se quitó el miembro obsoleto entity de PFAuthenticationGetEntityRequest. PFAuthenticationGetEntityAsync ahora emite un token para la entidad que realiza la llamada.
• Se cambió el nombre de dos tipos de solicitud de Account Management para distinguir los modelos de Client y Server:
  • PFAccountManagementUnlinkAppleRequest ahora es PFAccountManagementClientUnlinkAppleRequest.
  • PFAccountManagementUnlinkGameCenterAccountRequest ahora es PFAccountManagementClientUnlinkGameCenterAccountRequest.
• Se quitaron los códigos de error retirados E_PF_COPILOT_DISABLED, E_PF_COPILOT_INVALID_REQUEST, E_PF_GET_PLAYERS_IN_SEGMENT_DEPRECATED y E_PF_GET_PLAYERS_IN_SEGMENT_RATE_LIMIT_EXCEEDED.
• Se cambió el tipo subyacente de PFGameSaveInitOptions de uint32_t a uint64_t.
• Se agregaron valores a PFMultiplayerServerAzureVmSize. Los valores existentes posteriores a los puntos de inserción tienen nuevas representaciones numéricas, por lo que las aplicaciones no deben conservar ni transmitir el valor numérico de esta enumeración entre versiones del SDK.

​

Actualizaciones de la API

• Se agregó el miembro opcional namespaceWide a PFFriendsClientGetFriendsListRequest y PFFriendsServerGetFriendsListRequest. Incluye amigos del mismo espacio de nombres que no han iniciado sesión en el título actual.
• Se agregó compatibilidad con la versión de autenticación y el espacio aislado de PlayStation Network mediante los nuevos miembros authVersion, sandboxId y psnSandboxId en los modelos relacionados de Authentication, Account Management e información de usuario.
• Se agregó issuer a PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest.
• Se agregaron datos de estadísticas a los perfiles de entidad mediante includeStatistics y los nuevos tipos PFStatisticColumn, PFStatisticColumnCollection y PFStatisticColumnCollectionDictionaryEntry.
• Se agregó aggregationTargetEntityKeys a PFStatisticsStatisticUpdate y se agregó la enumeración PFStatisticAggregationMethod.
• Se agregaron expirationTimestamp a PFInventoryRedemptionSuccess, region a PFMultiplayerServerRequestPartyServiceResponse y tamaños de máquina virtual de Azure adicionales.
• Se agregaron códigos de error del servicio para nuevas condiciones de PlayStation Network, Nintendo, Economy, Experiments, Statistics, Segments, pertenencia de entidades, direcciones IP y Game Save.
• PFEntityRegisterTokenRefreshedEventHandler ahora acepta una cola de tareas opcional.
• Se agregó E_PF_GAMESAVE_OPERATION_IN_PROGRESS para las operaciones de Game Save rechazadas porque hay otra operación mutuamente excluyente en curso.
• Se agregó PF_GAMESAVE_MAX_SHORT_SAVE_DESCRIPTION_LENGTH, que define la longitud máxima aceptada de la descripción breve de una partida guardada en 768 caracteres.

​

Actualizaciones del entorno de ejecución y la plataforma

• Se corrigió el bloqueo de PFUninitializeAsync mientras hay en curso una operación HTTP interna o un vaciado de la canalización de eventos.
• Se agregó la versión del SDK al registro de seguimiento durante la inicialización.
• Se actualizó PlayFab::Wrappers::Exception::what() para incluir el HRESULT en su mensaje.
• Se exportaron los símbolos PF_API con visibilidad predeterminada en iOS y macOS, y se corrigió un bloqueo al iniciar en macOS al usar el Apple Unified SDK.
• Se corrigieron las invalidaciones de operator delete con tamaño en las cadenas de herramientas basadas en Clang para que se respeten los enlaces de memoria personalizados.
• Se actualizaron los proyectos de GDK para usar la plataforma de proyecto x64 que requiere el diseño de GDK 2510 y se agregó compatibilidad para redestinar proyectos al conjunto de herramientas v145 de Visual Studio 2026.
• Se fijó la dependencia de Android com.google.android.gms:play-services-games-v2 en la versión 21.0.0 para mantener la compatibilidad con minSdkVersion 21.

​

Actualizaciones de Game Save

• Se corrigió que los errores de transferencia de blobs que no son de PlayFab se notificaran como correctos. Los errores HTTP ahora devuelven un HRESULT de error en lugar de permitir que se finalice un manifiesto con un blob que no se escribió.
• Se corrigieron problemas de pérdida de datos y sincronización relacionados con direcciones URL de manifiestos extendidos obsoletas, conjuntos de archivos remotos incompletos, la eliminación de carpetas durante la descarga, la falta de localstate.json y la creación de archivos de marcador para nuevas partidas guardadas.
• Se corrigieron errores de carga, bloqueo y conflictos, incluidos bucles infinitos de rebloqueo, versiones de manifiesto obsoletas, cadenas de versiones base incorrectas, la selección de la versión perdedora en un conflicto, errores del servicio no reintentables mal controlados y cargas innecesariamente lentas tras la eliminación de directorios.
• Se corrigieron daños en la memoria y condiciones de carrera de GDK en la administración compartida del contexto de Game Save, y se agregó una validación que impide que las rutas de manifiestos extendidos salgan de la carpeta de partidas guardadas.
• Se restauró el acceso de escritura del título a la carpeta de partidas guardadas cuando la sincronización entra en el estado Uploading. Los archivos originales son de solo lectura durante PreparingForUpload.
• Se aclaró el comportamiento del progreso: PFGameSaveFilesUiProgressCallback notifica las transiciones de estado, mientras que PFGameSaveFilesUiProgressGetProgress se puede sondear para obtener el progreso en bytes. Un total de cero ahora significa que el total es desconocido.
• Se corrigió el comportamiento de cancelación y sin conexión de GRTS, se aceptan rutas con barras diagonales generadas por motores como Unreal Engine y se corrigieron varios errores de inicialización, apagado, identidad del dispositivo y carga de partidas guardadas en Windows y GDK.
• Se corrigió que la telemetría de Game Save identificara incorrectamente los dispositivos Steam Deck.

​

2504.0.0

• Se migró el análisis de JSON de rapidjson a nlohmann::json para mejorar la seguridad y la facilidad de mantenimiento.
• Se solucionó un problema por el que la inicialización de PFCore sobrescribía la devolución de llamada de seguimiento establecida por el título.
• Cambios en las funciones de enlace de memoria: se agregó una nueva API para recuperar los enlaces de memoria predeterminados y se modificaron las funciones de asignación de memoria existentes para incluir un identificador de tipo de memoria.
• Se corrigió un error relacionado con la limpieza del seguimiento cuando hay varios clientes implicados.
• Se habilitó la API PFAccountManagementSetDisplayNameAsync en PlayFab.C.
• Se introdujo la asignación de memoria personalizada para la biblioteca JSON de nlohmann y las invalidaciones globales de los operadores new/delete.

​

2410.0.0

• Se agregaron a la versión de GitHub encabezados públicos, código fuente y bibliotecas para su uso con el Microsoft GDK
• La biblioteca HTTP, libHttpClient, ahora es una dependencia de biblioteca dinámica en todas las plataformas. Esta biblioteca debe incluirse en el paquete distribuido del juego para que PlayFab Services funcione.
• Se agregaron API en versión preliminar pública para Leaderboards y Statistics
• Se agregó el parámetro opcional authenticationToken a PFAuthenticationLoginWithFacebookRequest
• Se agregó compatibilidad con nuevos códigos de error del servicio
• Se quitó OfferId de las respuestas de canje en la Economy API. En su lugar, se agregó el nuevo campo MarketplaceAlternateId. Los autores de las llamadas deben migrar al nuevo campo, aunque el servicio seguirá respondiendo con ambos campos por motivos de compatibilidad con versiones anteriores.
• Se resolvió un problema por el que PFFriendsExternalFriendSources no permitía selecciones múltiples

​

2406.0.0

• Se agregó compatibilidad con la compresión gzip opcional a PFEventPipelineConfig para Linux y Android
• Se agregó compatibilidad con la compresión (y descompresión) gzip automática de respuestas mediante PFHttpSettings
• Se habilitó el truncamiento de la impresión al intentar registrar seguimientos de XCurl
• Se corrigieron varias advertencias del análisis estático de código

​

2403.0.0

• Publicación de nuevas proyecciones del SDK con compatibilidad con Linux, Android, iOS y macOS. Las nuevas API que se exponen con esta versión son:
  • Para Android:
    • LoginWithFacebook
    • ClientLinkGoogleAccount
    • ClientLinkGooglePlayGamesServicesAccount
    • ClientUnlinkGoogleAccount
    • ClientUnlinkGooglePlayGamesServicesAccount
    • ClientAndroidDevicePushNotificationRegistration
    • RedeemGooglePlayInventoryItems
  • Para iOS:
    • LoginWithFacebook
    • ClientLinkApple
    • ClientUnlinkApple
    • ClientLinkGameCenterAccount
    • ClientUnlinkGameCenterAccount
    • ClientRegisterForIOSPushNotification
    • RedeemAppleAppStoreInventoryItems
• Se agregó compatibilidad con el almacenamiento en búfer de eventos (Event Buffering) en las canalizaciones de eventos.

​

2310.0.1

• Se agregó PFAccountManagementServerLinkNintendoServiceAccountSubjectAsync a Win32

​

2310.0.0

• Se agregó compatibilidad con Nintendo Switch (consulte “Request access for secured SDKs and samples - PlayFab | Microsoft Learn” para solicitar acceso)
• Se agregó el compressionLevel opcional de gzip a PFEventPipelineConfig
• Se quitaron las llamadas de administración de TelemetryKey de PFEvents
• Se agregaron las llamadas de Client heredadas de PFCloudScript que faltaban:
  • ClientExecuteCloudScript
  • ExecuteEntityCloudScript
• Se agregaron las llamadas de Client de PFAccountManagement que faltaban:
  • ClientAddOrUpdateContactEmail
  • ClientAddUsernamePassword
  • ClientGetPlayFabIDsFromFacebookIDs
  • ClientGetPlayFabIDsFromFacebookInstantGamesIds
  • ClientGetPlayFabIDsFromGameCenterIDs
  • ClientGetPlayFabIDsFromGoogleIDs
  • ClientGetPlayFabIDsFromGooglePlayGamesPlayerIDs
  • ClientGetPlayFabIDsFromKongregateIDs
  • ClientGetPlayFabIDsFromNintendoServiceAccountIds
  • ClientGetPlayFabIDsFromNintendoSwitchDeviceIds
  • ClientGetPlayFabIDsFromPSNAccountIDs
  • ClientGetPlayFabIDsFromTwitchIDs
  • ClientLinkAndroidDeviceID
  • ClientLinkApple
  • ClientLinkFacebookAccount
  • ClientLinkFacebookInstantGamesId
  • ClientLinkGameCenterAccount
  • ClientLinkGoogleAccount
  • ClientLinkGooglePlayGamesServicesAccount
  • ClientLinkIOSDeviceID
  • ClientLinkKongregate
  • ClientLinkNintendoServiceAccount
  • ClientLinkNintendoSwitchDeviceId
  • ClientLinkPSNAccount
  • ClientLinkTwitch
  • ClientRemoveContactEmail
  • ClientSendAccountRecoveryEmail
  • ClientUnlinkAndroidDeviceID
  • ClientUnlinkApple
  • ClientUnlinkFacebookAccount
  • ClientUnlinkFacebookInstantGamesId
  • ClientUnlinkGameCenterAccount
  • ClientUnlinkGoogleAccount
  • ClientUnlinkGooglePlayGamesServicesAccount
  • ClientUnlinkIOSDeviceID
  • ClientUnlinkKongregate
  • ClientUnlinkNintendoServiceAccount
  • ClientUnlinkNintendoSwitchDeviceId
  • ClientUnlinkPSNAccount
  • ClientUnlinkTwitch
  • ClientUpdateUserTitleDisplayName
• Se agregaron muchas llamadas destinadas a su uso por servidores de juegos (solo para Win32)
  • PFAuthentication
    • ServerLoginWithServerCustomId
    • ServerLoginWithSteamId
    • ServerLoginWithXbox
    • ServerLoginWithXboxId
    • AuthenticateGameServerWithCustomId
    • Delete
    • GetEntity
    • ValidateEntityToken
  • PFAccountManagement
    • ServerBanUsers
    • ServerDeletePlayer
    • ServerGetPlayerCombinedInfo
    • ServerGetPlayerProfile
    • ServerGetPlayFabIDsFromFacebookIDs
    • ServerGetPlayFabIDsFromFacebookInstantGamesIds
    • ServerGetPlayFabIDsFromNintendoServiceAccountIds
    • ServerGetPlayFabIDsFromNintendoSwitchDeviceIds
    • ServerGetPlayFabIDsFromPSNAccountIDs
    • ServerGetPlayFabIDsFromSteamIDs
    • ServerGetPlayFabIDsFromTwitchIDs
    • ServerGetPlayFabIDsFromXboxLiveIDs
    • ServerGetServerCustomIDsFromPlayFabIDs
    • ServerGetUserAccountInfo
    • ServerGetUserBans
    • ServerLinkNintendoServiceAccount
    • ServerLinkNintendoSwitchDeviceId
    • ServerLinkPSNAccount
    • ServerLinkServerCustomId
    • ServerLinkSteamId
    • ServerLinkXboxAccount
    • ServerRevokeAllBansForUser
    • ServerRevokeBans
    • ServerSendCustomAccountRecoveryEmail
    • ServerSendEmailFromTemplate
    • ServerUnlinkNintendoServiceAccount
    • ServerUnlinkNintendoSwitchDeviceId
    • ServerUnlinkPSNAccount
    • ServerUnlinkServerCustomId
    • ServerUnlinkSteamId
    • ServerUnlinkXboxAccount
    • ServerUpdateAvatarUrl
    • ServerUpdateBans
    • GetTitlePlayersFromXboxLiveIDs
  • PFCloudScript
    • ServerExecuteCloudScript
  • PFFriends
    • ServerAddFriend
    • ServerGetFriendsList
    • ServerRemoveFriend
    • ServerSetFriendTags
  • PFInventory
    • GetTransactionHistory
  • PFLocalization
    • GetLanguageList
  • PFPlatformSpecific
    • ServerAwardSteamAchievement
  • PFPlayerDataManagement
    • ServerGetUserData
    • ServerGetUserInternalData
    • ServerGetUserPublisherData
    • ServerGetUserPublisherInternalData
    • ServerGetUserPublisherReadOnlyData
    • ServerGetUserReadOnlyData
    • ServerUpdateUserData
    • ServerUpdateUserInternalData
    • ServerUpdateUserPublisherData
    • ServerUpdateUserPublisherInternalData
    • ServerUpdateUserPublisherReadOnlyData
    • ServerUpdateUserReadOnlyData
  • PFPushNotifications
    • ServerSendPushNotification
    • ServerSendPushNotificationFromTemplate
  • PFSegments
    • ServerAddPlayerTag
    • ServerGetAllSegments
    • ServerGetPlayerSegments
    • ServerGetPlayersInSegment
    • ServerGetPlayerTags
    • ServerRemovePlayerTag
  • PFTitleDataManagement
    • ServerGetPublisherData
    • ServerGetTime
    • ServerGetTitleData
    • ServerGetTitleInternalData
    • ServerGetTitleNews
    • ServerSetPublisherData
    • ServerSetTitleData
    • ServerSetTitleInternalData

​

2306.0.0

• Versión inicial del SDK con compatibilidad con Win32 y GDK