> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Produits SDK PlayFab

> Comparez les gammes de produits des SDK autonomes PlayFab v1 et du SDK unifié v2, et choisissez la bibliothèque cliente adaptée à vos projets de jeu nouveaux ou existants.

Le **SDK unifié PlayFab (v2)** est la nouvelle génération de SDK PlayFab. Il regroupe toutes les bibliothèques clientes PlayFab en un seul produit cohérent. Il offre une expérience de développement moderne et simplifiée, avec une authentification unifiée, une gestion automatique des jetons et des API cohérentes entre tous les composants. Le SDK unifié est la priorité du développement en cours : toutes les nouvelles fonctionnalités, la prise en charge de nouvelles plateformes et les améliorations ciblent d'abord la v2.

**Pour les nouveaux projets**, nous recommandons le **SDK unifié PlayFab (v2)** si les plateformes actuellement prises en charge répondent à vos besoins. Les **projets existants** utilisant les SDK autonomes v1 peuvent [migrer vers la v2](/fr-CA/services/playfab/sdks/unified-sdk/migrating-from-v1) pour tirer parti de l'architecture unifiée.

Les **SDK autonomes v1** restent pris en charge pour le moment et offrent une couverture plus large des plateformes pour les projets qui nécessitent des plateformes pas encore prises en charge par la v2.

<Info>
  Les SDK v1 et v2 ne peuvent pas être utilisés ensemble dans un même projet. Si vous avez besoin d'une plateforme qui n'est pas encore prise en charge par la v2, utilisez la v1 pour tous les composants.
</Info>

## SDK unifié PlayFab (v2)

Le [SDK unifié PlayFab](/fr-CA/services/playfab/sdks/unified-sdk/overview) remplace l'ensemble des packages SDK v1 distincts par un produit unique et cohérent qui couvre toutes les fonctionnalités de PlayFab. Au lieu de télécharger, d'installer et de mettre à jour plusieurs SDK indépendamment, vous travaillez avec un seul SDK qui comprend tout ce dont vous avez besoin.

### Contenu

Le SDK unifié regroupe les composants suivants dans une seule installation :

| Composant | Description |
| - | - |
| **PlayFab Core** | Authentification, gestion des entités, télémétrie et journalisation |
| **PlayFab Services** | LiveOps, économie, progression et analyse de données |
| **PlayFab GameSave** | Stockage et synchronisation des sauvegardes dans le cloud |
| **PlayFab Multiplayer** | Création de lobbies, matchmaking et gestion des sessions |
| **PlayFab Party** | Mise en réseau en temps réel, clavardage vocal et communication textuelle avec intégration d'Azure AI Services |

### Principaux avantages

* **SDK unique** : un seul processus d'installation et de mise à jour pour toutes les fonctionnalités PlayFab; vous n'avez plus à gérer des packages distincts pour Services, Party et Multiplayer
* **Authentification unifiée** : authentifiez-vous une seule fois et recevez un `PFEntityHandle` unique qui fonctionne avec tous les composants. Vous n'avez plus à récupérer et transmettre manuellement les jetons d'entité entre les services
* **Gestion automatique des jetons** : l'actualisation des jetons en arrière-plan gère automatiquement le renouvellement de l'Entity Token, ce qui évite l'expiration de la session pendant les longues sessions de jeu sans aucun code de contournement
* **Modèle de programmation cohérent** : tous les composants suivent des modèles standardisés pour l'initialisation, les appels d'API, la gestion des erreurs et les opérations asynchrones; apprenez un modèle et utilisez-le partout
* **Gestion personnalisée de la mémoire** : branchez vos propres allocateurs de mémoire via `PFMemoryHooks` pour un contrôle précis dans les environnements aux ressources limitées ou hautes performances
* **Contrôle avancé des threads** : l'intégration de `XTaskQueue` fournit des modes de distribution flexibles (Manual, ThreadPool, SerializedThreadPool, Immediate) afin que vous puissiez contrôler précisément comment et où le travail asynchrone s'exécute
* **Traçage de débogage intégré** : système de traçage extensible pour surveiller les requêtes, les réponses et les erreurs d'API de tous les composants à partir d'une sortie de débogage unique
* **Pérennité** : toutes les nouvelles fonctionnalités PlayFab, les extensions de plateformes et les améliorations des performances ciblent exclusivement la v2

<Tip>
  Vous utilisez déjà la v1? Consultez [Migration de la v1 vers la v2](/fr-CA/services/playfab/sdks/unified-sdk/migrating-from-v1) pour obtenir un guide pas à pas. La migration simplifie généralement votre code en supprimant la gestion manuelle des jetons et en unifiant la logique d'initialisation entre les composants.
</Tip>

### Comparaison de l'expérience développeur

Les exemples suivants illustrent comment la v2 simplifie les tâches courantes par rapport à la v1 :

| Tâche | v1 (SDK autonomes) | v2 (SDK unifié) |
| - | - | - |
| **Configuration** | Télécharger et configurer chaque SDK séparément | Installer un seul SDK avec tous les composants |
| **Authentification** | Récupérer manuellement les jetons d'entité, les transmettre entre les services et les actualiser avant leur expiration | Appeler la connexion une seule fois, recevoir un `PFEntityHandle` et le transmettre à n'importe quel composant |
| **Actualisation des jetons** | Écrire une logique d'actualisation personnalisée pour éviter l'expiration de la session | Gérée automatiquement en arrière-plan |
| **Gestion des erreurs** | Modèles d'erreur différents selon le SDK | Signalement des erreurs cohérent entre tous les composants |

## SDK autonomes PlayFab (v1)

Les [SDK autonomes v1](/fr-CA/services/playfab/sdks/sdk-overview) se composent de packages SDK distincts pour les différentes fonctionnalités de PlayFab. Bien qu'ils soient toujours entièrement pris en charge, ils nécessitent de gérer plusieurs installations de SDK et une coordination manuelle entre les composants. Les SDK v1 continuent de recevoir les correctifs critiques, mais les nouvelles fonctionnalités et la prise en charge de nouvelles plateformes sont développées exclusivement pour la v2.

### Composants SDK (v1)

* [**SDK PlayFab Services**](/fr-CA/services/playfab/sdks/playfab-sdk-intro) : LiveOps, économie, matchmaking et analyse de données
* [**SDK PlayFab Party**](/fr-CA/services/playfab/multiplayer/networking/party-sdks/overview) : mise en réseau et communication par clavardage vocal/textuel
* [**SDK PlayFab Lobby and Matchmaking**](/fr-CA/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks) : fonctionnalités de lobby et de matchmaking

## Plateformes prises en charge

Le tableau suivant compare la prise en charge des plateformes entre le SDK unifié v2 et les SDK autonomes v1 :

| Plateforme | v2 (SDK unifié) | v1 (SDK autonomes) |
| - | :-: | :-: |
| Windows (PC et portable) | ✅ Pris en charge | ✅ Pris en charge |
| XBOX (One, Series S/X, Cloud) | ✅ Pris en charge | ✅ Pris en charge |
| Steam Deck | ✅ Pris en charge | ❌ Non pris en charge actuellement |
| PlayStation 4 ¹ | ✅ Pris en charge | ✅ Pris en charge |
| PlayStation 5 ¹ | ✅ Pris en charge | ✅ Pris en charge |
| Nintendo Switch ¹ | ✅ Pris en charge | ✅ Pris en charge |
| Nintendo Switch 2 ¹ | ✅ Pris en charge | ✅ Pris en charge |
| Linux | ❌ Non pris en charge actuellement | ✅ Pris en charge |
| iOS | ❌ Non pris en charge actuellement | ✅ Pris en charge |
| Android | ❌ Non pris en charge actuellement | ✅ Pris en charge |
| macOS | ❌ Non pris en charge actuellement | ✅ Pris en charge |

<Note>
  L'accès aux SDK des plateformes PlayStation® et Nintendo nécessite un accord de confidentialité (NDA) avec le détenteur de la plateforme concernée. Pour plus de détails, consultez [Demander l'accès aux SDK et aux exemples](/fr-CA/services/playfab/sdks/request-access-for-sdks-samples).
</Note>

## Voir aussi

* [SDK unifié PlayFab (v2)](/fr-CA/services/playfab/sdks/unified-sdk/overview)
* [Vue d'ensemble des SDK autonomes (v1)](/fr-CA/services/playfab/sdks/sdk-overview)
* [Demander l'accès aux SDK et aux exemples](/fr-CA/services/playfab/sdks/request-access-for-sdks-samples)


## Related topics

- [SDK unifié PlayFab](/fr-CA/services/playfab/sdks/unified-sdk/overview.md)
- [Notes de version du SDK PlayFab Services 2026](/fr-CA/services/playfab/release-notes/index.md)
- [Notes de version du SDK PlayFab Services 2025](/fr-CA/services/playfab/release-notes/2025.md)
- [Notes de publication du SDK PlayFab Services 2023](/fr-CA/services/playfab/release-notes/2023.md)
- [Notes de publication du SDK PlayFab Services 2024](/fr-CA/services/playfab/release-notes/2024.md)