Videoaufzeichnung in Android-Spielen

Nach der Einstellung der Google-Anmeldung-API wird das games v1 SDK im Jahr 2026 entfernt. Ab Februar 2025 kannst du bei Google Play keine Titel mehr veröffentlichen, die neu in Games SDK V1 integriert wurden. Wir empfehlen, stattdessen das Games SDK V2 zu verwenden.
Bestehende Titel mit den vorherigen Games v1-Integrationen funktionieren zwar noch einige Jahre, aber wir empfehlen Ihnen, ab Juni 2025 zu Version 2 zu migrieren.
Dieser Leitfaden bezieht sich auf die Verwendung des Play-Spieldienste v1 SDK. Die Videoaufzeichnung wird im Play-Spieldienste 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 Play Spiele-Videoaufzeichnung startet.

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.

Hinweis :Die Klasse VideosClient verwendet die Google Play-Dienste-Klasse Task, um Ergebnisse asynchron zurückzugeben. Weitere Informationen zur Verwendung von Aufgaben zum Verwalten von Threads finden Sie im Entwicklerleitfaden für die Tasks API.

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:

1. Rufen Sie die Methode VideosClient.getCaptureOverlayIntent() auf.
2. Wenn der Aufruf erfolgreich ist, geben die Google Play-Spieldienste ein Task-Objekt zurück, mit dem asynchron ein Intent zum Starten des Videoaufzeichnungs-Overlays geladen wird.
3. Verwende 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. Videoaufzeichnungsfunktion über In-Game-Werbung bewerben In-Game-Prämien für das Teilen von Replays anbieten
Spieler-Community mit Replay-Wettbewerben 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