Partage, amis et invitations dans les jeux PlayDrop

Appelez sdk.host.share() à la suite d’un appui ou d’un clic. Cette méthode partage la page publique du jeu avec, en option, un texte, une image ou une courte vidéo, ainsi qu’une charge utile de lancement facultative.

shareButton.addEventListener("click", async () => {
  try {
    await sdk.host.share({ text: `I reached level ${level} in Moon Jump`, image: scoreCardBlob, payload: "level-7" });
  } catch (error) {
    console.warn("Share failed", error);
  }
});

• image : un Blob GIF, JPEG, PNG ou WebP de 8 MiB maximum. Les hôtes qui ne peuvent pas joindre d’images partagent uniquement le lien.
• video : un Blob MP4 de 15 secondes et 20 000 000 octets au maximum, à la place d’une image. Le format H.264/AAC en 1080p, en 16:9, 9:16 ou 1:1, donne les meilleurs résultats. Les hôtes sans prise en charge de la vidéo rejettent l’appel avec host_share_video_unsupported plutôt que de partager un simple lien.
• Préparez le Blob avant l’appui ; le générer après peut faire perdre l’autorisation de partage du navigateur.
• Vous ne pouvez pas partager une URL personnalisée ni d’autres fichiers. Le lien est toujours celui de la page du jeu.

Les erreurs liées à l’image sont invalid_host_share_image, host_share_image_type et host_share_image_too_large.

payload compte jusqu’à 256 caractères base64url. Un joueur qui ouvre le lien partagé démarre le jeu avec sdk.host.launchPayload défini sur cette valeur, ou sur null. Traitez-la comme une entrée non fiable : validez-la et vérifiez sur votre serveur que le joueur peut rejoindre la salle qu’elle désigne. N’y mettez jamais d’identifiants.

sdk.social.selectFriends({ max }) ouvre le sélecteur d’amis de PlayDrop (de 1 à 10, 1 par défaut) et ne renvoie que les amis choisis par le joueur, ou [] s’il annule. Envoyez ensuite une carte qui apparaît dans PlayDrop Chat :

const [friend] = await sdk.social.selectFriends({ max: 1 });
if (friend) {
  await sdk.social.sendMessage({
    recipientUserId: friend.id,
    type: "challenge",
    title: "Beat my time: 42.3 s",
    subtitle: "Moon Jump, level 7",
    payload: "level-7",
    clientMessageId: `challenge-${runId}-${friend.id}`,
  });
}

• type vaut invite, request, gift, challenge ou turn.
• title compte jusqu’à 80 caractères et subtitle jusqu’à 160.
• expiresInSeconds va de 60 secondes à 30 jours (la valeur par défaut).
• clientMessageId permet de réessayer sans risque : le réutiliser renvoie le message d’origine.
• Vous pouvez écrire aux amis que le joueur a sélectionnés, aux amis qui jouent à ce jeu et aux joueurs avec qui il échange déjà des messages de jeu. Les inconnus rencontrés lors de la recherche de partie ne peuvent pas recevoir de messages.

Lisez les cartes reçues avec getMessages({ limit }), de la plus ancienne à la plus récente, puis marquez chacune comme traitée avec consumeMessage(message.id). L’expéditeur est message.from.id.

const page = await sdk.social.getMessages({ limit: 20 });
for (const message of page.messages) {
  await applyCard(message.type, message.from.id, message.payload);
  await sdk.social.consumeMessage(message.id);
}

Continuez avec cursor: page.nextCursor jusqu’à ce qu’il vaille null.

sdk.social.listGameFriends() renvoie les amis qui ont joué récemment à ce jeu : une bonne liste pour des boutons « Jouer avec ». Elle n’expose ni la liste d’amis complète ni la présence en ligne. openProfile(userId) ouvre le profil d’un joueur et openChat({ recipientUserId, draftMessage }) ouvre Chat avec un brouillon modifiable que le joueur envoie lui-même.

Un nouveau joueur arrivé par un ami peut avoir sdk.host.launchFriend défini. Proposez-lui de jouer avec cet ami et confirmez avec selectFriends({ max: 1 }) ; ne démarrez jamais rien automatiquement.

Lors d’une pause naturelle, comme une fin de partie, sdk.host.showGames({ games: ["@creator/name"] }) affiche les cartes PlayDrop d’un à trois autres jeux publics et met le vôtre en pause. La méthode se résout avec played (PlayDrop change alors de jeu) ou dismissed. sdk.host.preloadGame(ref) signale le jeu que le joueur ouvrira peut-être ensuite.

Le partage et les appels sociaux nécessitent un paquet qui utilise le SDK. Les fonctionnalités liées aux amis nécessitent un joueur connecté. Les fenêtres de l’hôte mettent le jeu en pause ; gérez la pause et la reprise.