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

# Activités

> Publiez des expériences multijoueurs que d'autres joueurs XBOX peuvent rejoindre avec Multiplayer Activity, notamment les champs d'activité, les restrictions d'accès et le nombre de joueurs.

Cette rubrique décrit la publication d'expériences multijoueurs auprès d'autres joueurs, qui peuvent ensuite les rejoindre.

## Utilisation des activités

Lorsqu'un joueur démarre ou rejoint une expérience multijoueur, un titre doit le publier
dans Multiplayer Activity (MPA) en créant une activité. Contrairement à un
modèle basé sur les sessions, les activités sont propres à chaque joueur. Chaque joueur doit créer sa
propre activité, même s'ils jouent ensemble.

Un titre doit créer cette activité dès qu'un joueur se trouve dans une expérience
multijoueur. Pendant l'expérience, un titre doit modifier l'activité si le nombre de joueurs
augmente ou diminue. Un titre doit supprimer l'activité si le joueur
met fin à l'expérience multijoueur ou la quitte. Si un titre plante ou ne parvient pas,
pour une autre raison, à supprimer une activité, MPA tente de supprimer l'activité s'il
détecte que le joueur a cessé de jouer au titre. Les activités sont automatiquement
supprimées au bout de 24 heures si elles n'ont fait l'objet d'aucune mise à jour.

## Contenu des activités

Les activités contiennent les informations indiquées dans le tableau suivant.

| Champ | Objectif | Remarques |
| - | - | - |
| `xuid` | `XboxUserId` de l'utilisateur qui a créé l'activité. | Utilisé uniquement lors de l'interrogation des activités. Les joueurs ne peuvent définir une activité que pour eux-mêmes. |
| `connectionString` | Chaîne définie par le titre et opaque pour MPA. Contient des informations qu'un titre peut utiliser pour se connecter à un autre joueur. | Doit comporter moins de 512 caractères. |
| `joinRestriction` | Indique qui peut voir la chaîne de connexion de cette activité. Pour plus de détails, consultez la section Confidentialité plus loin dans cette rubrique. | Doit être `Public`, `Followed` ou `InviteOnly`. |
| `maxPlayers` | Nombre maximal de joueurs autorisés dans cette activité. | Facultatif. S'il est spécifié, il doit être supérieur à 1 et inférieur ou égal à 100. |
| `currentPlayers` | Nombre actuel de joueurs dans cette activité. | Facultatif. S'il est spécifié, il doit être supérieur à 0 et inférieur ou égal à 100. |
| `groupId` | ID défini par le titre. Les joueurs ayant le même `groupId` sont reconnus par MPA comme jouant ensemble. | Doit comporter moins de 128 caractères et être utilisé uniquement pour l'identité du groupe. |
| `platform` | Lorsqu'il est défini sur une plateforme spécifique, limite le jeu multiplateforme via les invitations et l'accès aux parties à cette seule plateforme. S'il n'est pas défini, le jeu multiplateforme est activé avec toutes les plateformes définies. | Pour plus d'informations, consultez la section Prise en charge des activités multiplateformes plus loin dans cette rubrique. |

## Confidentialité

Un titre peut souhaiter n'autoriser qu'une partie des joueurs de son graphe social à rejoindre
le joueur. Le champ `joinRestriction` détermine si les autres joueurs reçoivent
la chaîne de connexion lorsqu'ils consultent cette activité. Les valeurs et leur signification sont indiquées dans le tableau suivant.

| Valeur | Signification |
| - | - |
| `Public` | Tous les joueurs peuvent rejoindre cette activité. |
| `Followed` | Si le créateur de l'activité suit un autre joueur, ce dernier peut la rejoindre. |
| `InviteOnly` | Aucun joueur ne peut rejoindre cette activité, sauf en réponse à une invitation. |

## Prise en charge des activités multiplateformes

Lors de la création d'une activité dans le Microsoft Game Development Kit (GDK), les titres peuvent spécifier un indicateur `allowCrossplay`.
S'il est défini sur `false`, le Microsoft Game Development Kit (GDK) renseigne automatiquement le champ de plateforme d'une invitation avec la
plateforme actuelle. S'il est défini sur `true`, le Microsoft Game Development Kit (GDK) laisse le champ de plateforme à `null`, ce qui indique que
l'invitation est multiplateforme. La liste des plateformes autorisées pour le jeu multiplateforme est définie par la configuration
du titre. Dans ce scénario, les générations de consoles sont considérées comme du jeu multiplateforme.

## Récupération des activités

Lors de la récupération des activités d'autres joueurs, la chaîne de connexion est parfois
masquée. Cela indique que le joueur n'est pas autorisé à rejoindre cette activité. Par
exemple, la chaîne de connexion peut être masquée en raison de la valeur `joinRestriction`
de l'activité, ou parce que l'activité est complète.


## Related topics

- [Signaler une activité publicitaire](https://docs.xbox.com/fr/services/playfab/api-references/rest/client/advertising/report-ad-activity.md)
- [Récompenser une activité publicitaire](https://docs.xbox.com/fr/services/playfab/api-references/rest/client/advertising/reward-ad-activity.md)
- [Résolution des problèmes d'invitation et d'activité MPSD](https://docs.xbox.com/fr/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-invite-troubleshooting.md)
- [Intégration à PlayFab Lobby et Match](https://docs.xbox.com/fr/services/xbox-services/multiplayer/mpa/concepts/live-mpa-playfab-integration.md)
- [Passer de MPSD à PlayFab Multiplayer et MPA](https://docs.xbox.com/fr/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)