Das SDK- und API-Update vom 21. August 2019 brachte beim Backend-as-a-Service mehrere Änderungen an den Schnittstellen mit. Im Mittelpunkt stehen die Receipt-Validation-APIs und ein zusätzlicher LoginIdentityProvider in der Authentication API. Betroffen sind vor allem Entwickler, die In-App-Käufe über Plattform-Stores wie den App Store abwickeln und die Kaufbestätigungen serverseitig prüfen lassen. PlayFab richtet sich damit an ein klar abgegrenztes Publikum.
Receipt-Validation gibt erfüllte Items zurück
Die wichtigste Änderung an den Kaufprüfungs-Schnittstellen betrifft das Rückgabeverhalten. Die Receipt-Validation-APIs liefern laut Release Notes über das Feld PurchaseReceiptFulfillment jetzt die erfüllten Items zurück. Als Beispiel führt die Dokumentation die Methode RestoreIOSPurchases an. Nach erfolgreicher Validierung einer Kaufbestätigung steht damit direkt fest, welche Inhalte dem Spielerkonto gutgeschrieben wurden. Ein zusätzlicher Abruf des Inventars entfällt.
Dazu kommt ein neuer Parameter CatalogVersion. Mit ihm legt man beim Prüfen einer Kaufbestätigung fest, gegen welche Katalogversion die gekauften Items zugeordnet werden. Beide Anpassungen senken den Aufwand bei der Verarbeitung von Plattform-Käufen, und die Verknuepfung zwischen Store-Transaktion und PlayFab-Katalog lässt sich praeziser steuern.
Neuer LoginIdentityProvider und SDK-Kompatibilität
Bei der Anmeldung kam die Authentication API um einen weiteren LoginIdentityProvider hinzu. Der Enum-Wert kennzeichnet das genutzte Anmeldeverfahren eines Spielers und ergänzt die Liste der unterstützten Identitätsquellen. Titel, die mehrere Login-Wege parallel anbieten, bekommen damit einen zusätzlichen dokumentierten Provider-Wert innerhalb der Schnittstelle.
Zum API-Update gehört auch eine bestätigte Kompatibilität der Client-SDKs. Das Unreal-SDK ist nach Herstellerangaben mit den Engine-Versionen 4.20, 4.21 und 4.22 geprüft. Das Unity-SDK wurde für Unity 5.6 sowie alle Versionen von 2017.1 bis 2019.1 verifiziert. Nähere Angaben zu den Änderungen stehen in den PlayFab Release Notes für das Jahr 2019.