Build

Instant Games-SDK

In diesem Abschnitt findest du die API-Referenz für das Instant Games-JavaScript-SDK. Wenn du ein neues Spiel startest, solltest du immer unsere neueste Version des SDK verwenden. Klicke auf den Button unten, um die SDK-Referenz für unsere neueste Version zu sehen:

Referenz zum Instant Games-SDKReferenz zur Bundle-Konfiguration

Sieh dir die Änderungsprotokolle für die derzeit unterstützten Versionen des Instant Games-SDK an:

Version 7.1

Zur Referenzdokumentation für Instant Games-SDK, Version 7.1

Änderungsprotokoll

  1. Natives Rendering von Videoinhalten: Es wurden APIs hinzugefügt, damit Apps Videoinhalte nativ rendern können.
  2. Rewarded Interstitial API: Rewarded Interstitial ist ein neues Format für die Anzeige von Werbeanzeigen, mit dem Instant-Game-Entwickler*innen Geld verdienen können. Im Gegensatz zum Format „Rewarded Video“, bei dem Nutzer*innen der Anzeige der Werbeanzeige zustimmen, werden Rewarded Interstitials anstelle einer regulären Interstitial angezeigt und Nutzer*innen können sie deaktivieren. Wenn sie sich das vollständige Video ansehen, erhalten sie eine Prämie im Spiel.
  3. Top-Banner-Ads: Entwickler*innen können Bannerwerbung oben in ihrem Spiel zeigen.

Version 7.0

Zur Referenzdokumentation für Instant Games-SDK, Version 7.0

Änderungsprotokoll

  1. Individuelle Einladungen Spieler*innen können neue Spieler*innen über den Messenger zum Spiel einladen. Spieler*innen sehen den Abschnitt „Neue Spieler einladen“ mit ihren Freund*innen, die das Spiel noch nicht gespielt haben. Wenn sie auf „Einladen“ klicken, wird dem*der Freund*in eine Nachricht mit der Aufforderung gesendet, das Spiel zu spielen. Spieler*innen können mehrere Einladungen gleichzeitig senden. Einen Leitfaden mit weiteren Informationen findest du hier.
  2. Haptisches Feedback Instant Games unterstützt jetzt haptisches Feedback für Android- und iOS-Geräte mit integriertem Vibrationsmotor.
  3. Turnier-APIs Sofort-Turniere sind eine großartige Möglichkeit, neue Spieler*innen zu gewinnen, und eignen sich sehr gut, um ihr Interesse während der gesamten Laufzeit eines Turniers (in der Regel 7 Tage) aufrechtzuerhalten. Spieler*innen teilen eine Bestenliste in ihrer Chronik mit einer Aufforderung für Freund*innen, an der Challenge teilzunehmen. Durch Auslieferung im News Feed in Kombination mit dem erneuten Teilen durch Spieler*innen, die am Spiel teilnehmen, kann das Freundschaftsdiagramm in Turnieren schnell durchlaufen werden, um in kurzer Zeit mehr Spieler*innen für das Spiel zu gewinnen.
  4. Entfernung von Statistik-APIs Diese wurden zugunsten der flexibleren Daten-APIs für Spieler*innen entfernt.
  5. Entfernung von postSessionScore Wir stellen postSessionScoreAsync als Ersatz zur Verfügung, da es bessere Informationen über Handlungen von Nutzer*innen für Dialoge bereitstellt, die über diese API aufgerufen werden.
  6. Entfernung ungenutzter Parameter in shareAsync und updateAsync Wir haben den Parameter INTENT aus shareAsync entfernt, da er nicht verwendet wurde. Wir haben auch die Strategie IMMEDIATE_CLEAR aus updateAsync entfernt, da es eine Richtlinie gibt, die individuelle Updates auf ein Update pro Kontextsitzung beschränkt.
  7. Top-Banner-Ads: Entwickler*innen können Bannerwerbung oben in ihrem Spiel zeigen.

Version 6.3

Zur Referenzdokumentation für Instant Games-SDK, Version 6.3

Änderungsprotokoll

  1. (Neu) FBInstant.postSessionScore Über diese API kann das Spiel Facebook das Ergebnis des*der Spieler*in aus der aktuellen Spielesitzung zur Verfügung stellen. Facebook verwendet diese Ergebnissignale in verschiedenen Plattform-Integrationen, um Spieler*innen dabei zu unterstützen, das Spiel zu entdecken, mit anderen zu konkurrieren und erneut mit dem Spiel zu interagieren.
  2. Offline-Spielersuche Bisher erfolgte die Spielersuche synchron und blockierte das Spiel für die Spieler*innen, während sie warten. In dieser Version wurde eine asynchrone Option zu „matchPlayerAsync“ hinzugefügt. Spieler*innen, die ein Offline-Spiel starten, werden sofort zu einem Gruppen-Thread hinzugefügt. Außerdem können Spieler*innen das Spiel verlassen, während sie auf das Beitreten weiterer Spieler*innen warten. Sobald der*die Spieler*in anderen zugeordnet wurde und sofern diese noch im Spiel sind, wird der*die Spieler*in hinzugefügt und wechselt in den Kontext des zugeordneten Threads.
  3. Daten-APIs für Spieler*innen, Kontext, Gebietsschema und Einstiegspunkt sind nach „initializeAsync“ zugänglich Wir erlauben erneut den Zugriff auf Daten-APIs vor Spielbeginn. Du kannst jetzt beispielsweise auf Daten zum Gebietsschema oder Einstiegspunkt von Spieler*innen zugreifen, während das Spiel noch geladen wird. Dies sollte dazu beitragen, die Anzahl sekundärer Ladebildschirme und die Gesamt-Ladeanforderungen für deine Spiele zu verringern. Diese Änderung ist jetzt im Web verfügbar und wird ab den folgenden Versionen für mobile Geräte verfügbar sein: FB für Android v219, Messenger für Android v213, FB für iOS v222, Messenger für iOS v216. Frühere mobile Versionen weisen weiterhin das bisherige Verhalten auf. Suche daher nach aktualisierten Werten, nachdem „startGameAsync“ aufgelöst wurde.