Videoaufzeichnung in Android-Spielen

Mit der Videoaufzeichnungs-API können Sie Ihrem Spiel ganz einfach eine Videoaufzeichnung hinzufügen und Nutzern ermöglichen, ihre Videos in wenigen Schritten mit Freunden auf YouTube zu teilen. Sie könnten beispielsweise auf dem Bildschirm einer Kampfaufzeichnung eine Schaltfläche hinzufügen, die beim Drücken die Videoaufzeichnungsfunktion von Play Spiele öffnet.

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 können:

• Laden Sie das Codebeispiel herunter und sehen Sie es sich an.

• Machen Sie sich mit den Empfehlungen in der Checkliste für die Qualität vertraut.

Videos-Client abrufen

Damit Sie die Videoaufzeichnungs-API verwenden können, muss Ihr Spiel zuerst ein VideosClient-Objekt abrufen. Rufe dazu die Methode Games.getVideosClient() auf und übergebe die Aktivität und die GoogleSignInAccount für den aktuellen Spieler. Informationen zum Abrufen der Informationen zum Spielerkonto findest du unter Anmeldung in Android-Spielen.

Grundlagen der Videoaufzeichnungs-API

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

Die Videoaufzeichnung bietet Nutzern folgende Funktionen:

• Das Overlay für die Videoaufzeichnung mit drei Schaltflächen:

  1. Aufnahme starten / beenden
  2. Mikrofon ein-/ausschalten
  3. Frontkamera ein-/ausschalten

• Eine vom Entwickler bereitgestellte Schaltfläche zum Starten der Aufzeichnung oder ein alternativer Auslöser für die Aufzeichnung

• Ein anklickbares Pop-up, das am Ende der Aufnahme angezeigt wird und es Spielern ermöglicht, das Video auf YouTube hochzuladen oder sich das Video in der Fotogalerie anzusehen. Hinweis: Aufgenommene Videos werden in der Fotogalerie in der Kategorie ScreenCasts gespeichert.

Overlay für die Videoaufzeichnung starten

So startest du die Videoaufnahme für den aktuell angemeldeten Spieler:

1. Rufen Sie die Methode VideosClient.getCaptureOverlayIntent() auf.
2. Wenn der Aufruf erfolgreich ist, gibt Google Play Spieledienste ein Task-Objekt zurück, das asynchron eine Intent zum Starten des Videoaufzeichnungs-Overlays lädt.
3. Verwenden Sie die Absicht 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 zur Videoaufzeichnung

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