Mit der Video Recording API kannst du deinem Video ganz einfach Videoaufzeichnungen hinzufügen und Nutzern die Möglichkeit geben, ihre Videos in wenigen einfachen Schritten mit Freunden auf YouTube zu teilen. Du kannst beispielsweise eine Schaltfläche aus einem Bildschirm zur Schlachtwiedergabe einblenden, durch das du die Wiedergabe von Play Spiele-Videos aufrufen kannst.
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 Video Recording API verwenden:
Laden Sie das Codebeispiel herunter und prüfen Sie es.
Mache dich mit den in der Qualitäts-Checkliste beschriebenen Empfehlungen vertraut.
Videoclient abrufen
Damit Sie die Video Recording 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 den GoogleSignInAccount
für den aktuellen Spieler. Informationen zum Abrufen der Spielerkontoinformationen findest du unter In Android Games anmelden.
Grundlagen der Video Recording API
Mit der Video Recording API kannst du die Funktion direkt in dein Spiel integrieren.
Die Videoaufzeichnung für Nutzer umfasst Folgendes:
Das Overlay für die Videoaufnahme mit drei Schaltflächen:
- Aufnahme starten / beenden
- Mikrofon ein-/ausschalten
- Vorwärts gerichtete Kamera ein-/ausschalten
Eine vom Entwickler bereitgestellte Schaltfläche zum Starten der Aufzeichnung oder ein alternativer Aufnahmetrigger
Ein anklickbarer Toast, der am Ende der Aufnahme eingeblendet wird und den Spielern ermöglicht, das Video auf YouTube hochzuladen oder das Video über die Fotos App anzusehen (Hinweis: Aufgezeichnete Videos werden in der Kategorie
ScreenCasts
in Google Fotos gespeichert.)
Overlay für Videoaufzeichnung starten
So beginnst du mit der Videoaufzeichnung für den aktuell angemeldeten Spieler:
- Rufen Sie die Methode
VideosClient.getCaptureOverlayIntent()
auf. - Wenn der Aufruf erfolgreich ist, geben die Google Play-Spieldienste ein
Task
-Objekt zurück, das asynchron einen Intent zum Starten des Videoaufnahme-Overlays lädt. - Verwenden Sie den Intent aus dem vorherigen Schritt, um eine Aktivität zu starten.
So blenden Sie das Videoaufnahme-Overlay ein:
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 Videoaufzeichnungsdaten
Mit der Video Recording API kannst du eine Videoaufzeichnung direkt in dein Spiel integrieren.
Tipp | Beschreibung |
---|---|
Den Trigger für die Videoaufnahme einfach finden |
|
Nutzung der Funktion im Store-Eintrag und im Spiel fördern |
|
Mit Community-Wettbewerben kannst du deine Spieler-Community begeistern |
|