Videoaufzeichnung in Android-Spielen

Nach der Einstellung der Google Sign-In API wird 2026 das games v1 SDK entfernt. Ab Februar 2025 können Sie bei Google Play keine Titel mehr veröffentlichen, die neu in games v1 SDK integriert wurden. Wir empfehlen, stattdessen das games v2 SDK zu verwenden.
Bestehende Titel mit den vorherigen games v1-Integrationen funktionieren zwar noch einige Jahre, aber wir empfehlen Ihnen, ab Juni 2025 zu v2 zu migrieren.
Dieser Leitfaden bezieht sich auf die Verwendung des Play Games-Dienste v1 SDK. Die Videoaufzeichnung wird im Play Games-Dienste v2 SDK nicht unterstützt.

Mit der Videoaufzeichnungs-API können Sie Ihrem Spiel ganz einfach eine Videoaufzeichnungsfunktion hinzufügen und Nutzern ermöglichen, ihre Videos in wenigen Schritten mit Freunden auf YouTube zu teilen. Sie könnten beispielsweise auf dem Bildschirm für die Wiederholung eines Kampfes eine Schaltfläche hinzufügen, die bei Auswahl die Videoaufzeichnung von Play Games aufruft.

In diesem Leitfaden erfahren Sie, wie Sie die Videoaufzeichnung in Spielen mit den Google Play-Spieldiensten implementieren. Die APIs finden Sie in den Paketen com.google.android.gms.games.video und com.google.android.gms.games.

Hinweis

Bevor Sie die Videoaufzeichnungs-API verwenden, sollten Sie Folgendes tun:

Laden Sie das Codebeispiel herunter und sehen Sie es sich an.
Mach dich mit den Empfehlungen in der Checkliste für die Qualität vertraut.

Videos-Client abrufen

Bevor Sie die Videoaufzeichnungs-API verwenden können, muss Ihr Spiel zuerst ein VideosClient-Objekt abrufen. Rufen Sie dazu die Methode Games.getVideosClient() auf und übergeben Sie die Aktivität und die GoogleSignInAccount für den aktuellen Spieler. Informationen zum Abrufen der Spielerkontoinformationen finden Sie unter Anmelden in Android-Spielen.

Grundlagen der Videoaufzeichnungs-API

Mit der Video Recording API können Sie eine Funktion zum Aufzeichnen von Videos direkt in Ihr Spiel einbinden.

Die Videoaufzeichnung für Nutzer umfasst Folgendes:

Das Overlay für die Videoaufzeichnung mit drei Schaltflächen:
1. Aufnahme starten / beenden
2. Mikrofon ein-/ausschalten
3. Nach vorn gerichtete Kamera ein- / ausschalten
Hinweis :Wenn Sie auf die Anzeige der nach vorn gerichteten Kamera im Overlay klicken, werden die drei oben genannten Schaltflächen angezeigt.
Eine vom Entwickler bereitgestellte Schaltfläche zum Starten der Aufnahme oder ein alternativer Aufnahmetrigger
Ein anklickbarer Hinweis, der am Ende der Aufnahme eingeblendet wird und es Spielern ermöglicht, das Video auf YouTube hochzuladen oder es in der Fotos App anzusehen. Hinweis: Aufgenommene Videos werden in Fotos in der Kategorie ScreenCasts gespeichert.

Overlay für die Videoaufzeichnung starten

So starten Sie die Videoaufzeichnung für den aktuell angemeldeten Spieler:

Rufen Sie die Methode VideosClient.getCaptureOverlayIntent() auf.
Wenn der Aufruf erfolgreich ist, geben die Google Play-Spieledienste ein Task-Objekt zurück, mit dem asynchron ein Intent zum Starten des Videoaufzeichnungs-Overlays geladen wird.
Verwenden Sie den Intent aus dem vorherigen Schritt, um eine Aktivität zu starten.

Hier ein Beispiel dafür, wie Sie das Overlay für die Videoaufzeichnung aufrufen:

private static final int RC_VIDEO_OVERLAY = 9011;

public void showVideoOverlay(View myview) {
  Games.getVideosClient(this, GoogleSignIn.getLastSignedInAccount(this))
      .getCaptureOverlayIntent()
      .addOnSuccessListener(new OnSuccessListener<Intent>() {
        @Override
        public void onSuccess(Intent intent) {
          startActivityForResult(intent, RC_VIDEO_OVERLAY);
        }
      });
}

Tipps zur Verwendung von Daten aus Videoaufzeichnungen

Mit der Videoaufzeichnungs-API können Sie eine Videoaufzeichnungsfunktion direkt in Ihr Spiel einbinden.

Tipp	Beschreibung
Videoaufzeichnungstrigger leicht auffindbar machen	Eine Aufzeichnungsschaltfläche gut sichtbar außerhalb des Hauptmenüs platzieren Das Overlay wird automatisch über eine spezielle und deutlich gekennzeichnete Menüoption für den Aufnahmemodus ausgelöst.
Nutzung der Funktion in Ihrem Store-Eintrag und im Spiel bewerben	Verwenden Sie in Ihrem Store-Eintrag einen Screenshot, auf dem das Overlay für die Videoaufnahme zu sehen ist. Funktion zur Videoaufzeichnung über In-Game-Werbung bewerben In-Game-Prämien für das Teilen von Replays anbieten
Mit Replay-Wettbewerben die Spieler-Community einbinden	Spieler dazu anregen, Spielwiederholungen aufzuzeichnen und zu teilen, indem du wöchentliche, monatliche oder jährliche Wettbewerbe veranstaltest Top-Videos und ‑Creator im Spiel oder über soziale Medien auszeichnen