Facebook-Spiele

Spielen mit Freund*innen für Instant Games

Bei Instant Games gibt es vielfältige Möglichkeiten, soziale Interaktionen zwischen Spieler*innen zu ermöglichen.

Verbundene Spieler*innen

Die Methode FBInstant.player.getConnectedPlayersAsync() ruft eine Liste der Nutzer*innen ab, die mit dem*der aktuellen Spieler*in im Messenger verbunden sind. Diese Methode gibt nur verbundene Nutzer*innen zurück, die dem Spiel die Berechtigung für den Zugriff auf ihre Daten erteilt haben.

Hinweis:Diese Methode unterscheidet nicht zwischen Spieler*innen, die bereits im selben Kontext gespielt haben und Spieler*innen, die dies nicht getan haben. Du kannst spezifische Informationen zu diesem Kontext über FBInstant.context.getPlayersAsync() abrufen.

Freund*innen von Spieler*in abrufen

FBInstant.player.getConnectedPlayersAsync()
  .then(function(players) {
    _leaderboard.render(players);
  });

Kontextspieler*innen abrufen

FBInstant.context.getPlayersAsync()
  .then(function(players) {
    _leaderboard.render(players);
  });

Ändern von Kontext

Instant Games können in verschiedenen Kontextumgebungen gespielt werden, wie in Messenger-Unterhaltungen oder Feed-Stories. Mit den nachfolgenden SDK-Aufrufen kannst du in allen Sitzungen zwischen Kontextumgebungen wechseln, unabhängig vom Einstiegspunkt. Das bedeutet, deine Spieler können nun zwischen Unterhaltungen wechseln, ohne das Spiel beenden und neu öffnen zu müssen.

Wir bieten drei verschiedene Methoden des Kontextwechsels an:

  • FBInstant.context.chooseAsync() öffnet einen nativen Dialog, in dem die Spieler*innen auswählen, zu welcher Unterhaltung sie wechseln möchten.
  • FBInstant.context.switchAsync(contextId) ermöglicht es dem*der Entwickler*in, den*die Spieler*in zu einem vordefinierten Kontext zu senden (beispielsweise um ein Spiel fortzusetzen, das vorher in einer anderen Unterhaltung gestartet wurde).
  • FBInstant.context.createAsync(playerId) versucht, einen Kontext mit dem*der festgelegten Spieler*in zu erstellen (beispielsweise um ein Spiel zwischen einem*einer Spieler*in und einem*einer vorgeschlagenen Freund*in zu starten).

Mit anderen Spielern mit Matchmaking spielen

Wir bieten Tools für dein Spiel, um Spieler mit unseren Kontext- und Matchmaking-APIs in neue Kontexte zu bringen. Wir haben festgestellt, dass Menschen, die mit anderen Spielern spielen, am Ende besser zu halten sind als Solokontext-Spieler. Dafür gibt es ein paar Gründe:

  1. Personalisierte Updates im Kontext können einen überzeugenden Einstieg zurück ins Spiel bieten.
  2. Soziales Spiel fördert die Bindung, weil Menschen mehr Spaß haben, wenn sie zusammen spielen!

Sinnvolle soziale Dynamik im Gameplay selbst wird dein Instant Game zur Geltung kommen lassen und die Spieler begeistern, um dein Spiel mit ihren Freunden zu teilen.

Empfohlene Verwendung:

  1. Verwende die matchmaking API, um Spieler*innen unabhängig von Interaktionen mit Freund*innen die Möglichkeit eines sozialen Spieleerlebnisses zu bieten. Dies ist besonders hilfreich bei rundenbasierten Spielen und Multiplayer-Spielen, kann aber auch von anderen Arten von Spielen profitieren, wenn Spieler keine Freunde haben, die ein bestimmtes Spiel spielen, ihre Freunde nicht oft genug spielen oder sie einfach ein anderes Spielerlebnis wollen.
  2. Bringe KI-Spieler ein, wenn Zufallsgegner vor Spielende aufgeben

Durch die Verwendung von matchPlayerAsync() versucht dein Spiel den*die aktuelle*n Spieler*in in einen Kontext mit einem*einer anderen Spieler*in zu bringen. Wir haben einen zusätzlichen Parameter geschaffen. Damit kannst du angeben, ob das Spiel direkt nach dem Matchen des*der Spieler*in in den neu erstellten Kontext wechseln soll oder ob der*der Spieler*in in der Benachrichtigung erst auf Spielen klicken muss.

Es gibt zwei Mechanismen für das Matchen:

  1. Synchrones Match: Ordnet den*die aktuelle*n Spieler*in anderen Nutzer*innen zu, die nach Spielpartner*innen suchen. Bei Erfolg wird ein neuer Messenger-Gruppen-Thread erstellt, der die zugeordneten Spieler*innen enthält und der*die Spieler*in wechselt in den Kontext dieses Threads. Dies wird gelöst, sobald der*die Spieler*in erfolgreich in den neu zugeordneten Kontext gewechselt hat.
  2. Asynchrones Match (mehr erfahren): Ein*e Spieler*in, der*die ein Spiel offline startet, wird direkt zu einem Gruppen-Thread mit anderen Spieler*innen hinzugefügt, die zuvor ein Spiel offline gestartet haben. Spieler*innen können das Spiel verlassen, während auf das Beitreten weiterer Spieler*innen gewartet wird. Sobald die Zuordnung erfolgt ist, wird der*die Spieler*in hinzugefügt und wechselt in den Kontext des zugeordneten Threads. Dies wird gelöst, sobald der*die Spieler*in erfolgreich zum Gruppen-Thread hinzugefügt wurde und in den zugeordneten Kontext gewechselt hat.

Die standardmäßige Mindest- und Höchstzahl von Spielern in einem passenden Thread beträgt 2 bzw. 20, je nachdem, wie viele Spieler versuchen, etwa zur gleichen Zeit gematcht zu werden. Die Werte können in fbapp-config.json geändert werden.