SwiftUI: GameCenter/GameKit Integration
Zusammenfassung
Kurz
Der Bericht zeigt die Einrichtung von Game Center mit GameKit in einer SwiftUI-App sowie Beispielcode für Anmeldung, Erfolge und Ranglisten. Der Autor berichtet von nicht zuverlässig funktionierenden Tests, einem wirkungslosen Aufruf zum Laden aller Ranglisten und einem bei ihm ausbleibenden Abschlussbanner; mögliche Ursachen bleiben teils Vermutungen.
Mittel
Itsukis vollständiger Bericht führt anhand eines SwiftUI-Demoprojekts durch die GameKit-Einrichtung für Game-Center-Erfolge und Ranglisten. Er empfiehlt, Game Center am Gerät zu aktivieren und sich anzumelden, das Game-Center-Entitlement hinzuzufügen und eine GameKit-Konfigurationsdatei für Erfolge und Ranglisten anzulegen. Für macOS-Apps mit Sandbox seien außerdem Netzwerkverbindungen freizugeben.
Die lokale Anmeldung läuft im Beispiel über `authenticateHandler`. Der Artikel weist darauf hin, dass dieser Handler mehrfach aufgerufen werden oder bei bereits angemeldeten Spielern ausbleiben kann. Zum Testen beschreibt er Xcodes GameKit-Debugmodus und den Game Progress Manager, der laut Bericht ein physisches Gerät voraussetzt. Der Autor berichtet von gelegentlichen Authentifizierungs- und Erkennungsfehlern in Testumgebungen und nennt erneutes Starten sowie das Bereinigen von Build und Caches als mögliche Abhilfe.
Bei Erfolgen müsse man noch nicht gemeldete Einträge ergänzen, da `loadAchievements()` nur Erfolge mit bereits gemeldetem Fortschritt liefere. Fortschritt wird prozentual gemeldet; 100 Prozent schließt den Erfolg ab. Ranglisten lassen sich laden, mit Punktzahlen bespielen und nach globalen Einträgen abfragen. In den Versuchen des Autors lieferte das Laden aller Ranglisten mit `nil` jedoch nichts. Auch das Abschlussbanner funktionierte bei ihm nicht; die vermutete Ursache bleibt unbestätigt. Multiplayer und weitere Funktionen spart der Bericht aus.
Ausführlich lesen
Der vollständige Bericht von Itsuki zeigt anhand eines SwiftUI-Demoprojekts, wie sich Game Center mit GameKit für Erfolge und Ranglisten einrichten lässt. Der Autor beschreibt die Schritte als praktischen Einstieg und verweist auf ein GitHub-Demo. Multiplayer, Herausforderungen und wiederkehrende Ranglisten werden als weiterführende Möglichkeiten genannt, bleiben aber außerhalb des Umfangs.
Zur Einrichtung empfiehlt der Bericht, Game Center auf dem Gerät zu aktivieren und sich anzumelden. Das gilt laut Autor auch für den Simulator, bei dem die Funktion standardmäßig ausgeschaltet sein könne. Im Projekt müsse außerdem das Game-Center-Entitlement aktiviert werden. Für macOS-Apps mit Sandbox seien zusätzlich ein- und ausgehende Netzwerkverbindungen freizugeben. Eine GameKit-Konfigurationsdatei diene dazu, Erfolge und Ranglisten lokal anzulegen und Konfigurationen mit App Store Connect abzugleichen.
Die Anmeldung des lokalen Spielers erfolgt laut Beispiel über `GKLocalPlayer.local.authenticateHandler`. Der Handler könne mehrfach aufgerufen werden oder ausbleiben, wenn der Spieler bereits angemeldet ist. Bei Bedarf sei ein übergebener View Controller anzuzeigen; Fehler und Einschränkungen des Kontos, darunter Alters- oder Multiplayerbeschränkungen, sollten berücksichtigt werden. Der Autor führt einen Authentifizierungsfehler auf deaktiviertes Game Center zurück. Zum lokalen Testen beschreibt er Xcodes GameKit-Debugmodus und den Game Progress Manager, der laut Bericht ein physisches Gerät erfordert. Ein weiterer Fehler, bei dem Game Center die App nicht erkenne, sei in seiner Sandbox-Testumgebung gelegentlich durch erneutes Starten verschwunden; falls nicht, empfiehlt er, den Build-Ordner zu bereinigen und Caches zu löschen.
Für Erfolge erläutert der Artikel, dass `loadAchievements()` nur solche Erfolge zurückliefert, für die beim Spieler bereits Fortschritt gemeldet wurde. Noch fehlende Einträge ergänzt der Beispielcode daher anhand festgelegter Kennungen. Beschreibungen und Kennungen aller konfigurierten Erfolge könnten über `loadAchievementDescriptions()` geladen werden; darüber lasse sich auch ein Erfolgsbild abrufen. Fortschritt wird als Prozentwert gemeldet, wobei 100 Prozent den Erfolg abschließt. Der Beispielmanager aktualisiert seine gespeicherten Werte nach dem Melden oder Zurücksetzen manuell, weil die verwendeten GameKit-Objekte laut Autor nicht beobachtbar seien.
Ranglisten werden über Kennungen geladen. Der Beispielcode reicht sie anschließend zum Abruf globaler Einträge weiter und kann Punktzahlen einreichen. Der Autor berichtet allerdings, dass der dokumentierte Aufruf zum Laden aller Ranglisten mit `nil` bei ihm keine Ergebnisse lieferte. Zudem ließ sich das vorgesehene Abschlussbanner für Erfolge in seinen Versuchen weder im Simulator noch auf einem echten Gerät anzeigen; eine mögliche Erklärung durch veraltete Controller-APIs vermutet er, bestätigt sie aber nicht. Auch die Empfehlung, Game Center in jeder App einzusetzen, ist seine persönliche Meinung; er sagt selbst, dass er nicht weiß, ob Apple dies für Apps außerhalb von Spielen erlaubt.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Luna hat zwei Zusammenfassungen geliefert. Geprüft wurde die mittlere Fassung; die kurze ist ebenfalls treu, lässt aber noch mehr aus. Erfunden wurde in keiner der beiden Fassungen etwas. Die Einordnung blieb leer, weil keine Fragen angegeben waren.
Im Bericht, aber nicht in der Zusammenfassung
- Der Bericht sagt, dass die UI-Controller wie GKGameCenterViewController und das Game-Center-Dashboard veraltet sind. Deshalb muss man eigene Oberflächen bauen oder einen Access Point nutzen.
- Die Prüfung der Einschränkungen (isUnderage, isMultiplayerGamingRestricted, isPersonalizedCommunicationRestricted) beim Authentifizieren fehlt.
- Die Konfigurationsdatei lässt sich mit App Store Connect synchronisieren oder von dort abrufen; das fehlt.
- Der Hinweis, dass ausgeschaltetes Game Center im Handler einen Fehler auslöst, und der Fehlercode 15 bei nicht erkannter App fehlen.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.