Enregistrement vidéo dans les jeux Android

L'API d'enregistrement vidéo vous permet d'ajouter facilement des enregistrements vidéo à votre jeu et de permettre aux utilisateurs de partager leurs vidéos avec leurs amis sur YouTube en quelques étapes simples. Par exemple, vous pouvez ajouter un bouton à partir d'un écran de rediffusion de bataille qui, lorsque vous appuyez dessus, affiche l'expérience d'enregistrement vidéo de Play Jeux.

Ce guide vous explique comment mettre en œuvre l'enregistrement vidéo dans les jeux à l'aide des services de jeux Google Play. Les API sont disponibles dans les packages com.google.android.gms.games.video et com.google.android.gms.games.

Avant de commencer

Avant de commencer à utiliser l'API d'enregistrement vidéo:

Obtenir le client vidéo

Pour commencer à utiliser l'API d'enregistrement vidéo, votre jeu doit d'abord obtenir un objet VideosClient. Pour ce faire, appelez la méthode Games.getVideosClient() et transmettez l'activité et le GoogleSignInAccount pour le lecteur actuel. Pour savoir comment récupérer les informations de compte de joueur, consultez Connexion à Android Games.

Principes de base de l'API d'enregistrement vidéo

Vous pouvez utiliser l'API d'enregistrement vidéo pour intégrer une expérience d'enregistrement vidéo directement depuis votre jeu.

Pour les utilisateurs, l'enregistrement vidéo inclut les éléments suivants:

  • L'enregistrement vidéo en superposition, qui comporte trois boutons:

    1. Démarrer / Arrêter l'enregistrement
    2. Activer / Désactiver le micro
    3. Activer / Désactiver la caméra frontale

  • Un bouton fourni par le développeur pour lancer l'enregistrement, ou un autre déclencheur d'enregistrement

  • Toast cliquable qui s'affiche à la fin de l'enregistrement et permet aux joueurs d'importer la vidéo dans YouTube ou de la regarder via l'application Photos (Remarque: les vidéos enregistrées sont stockées dans la catégorie ScreenCasts dans Photos.)

Lancer la superposition d'enregistrement vidéo

Pour lancer l'enregistrement vidéo du lecteur actuellement connecté, procédez comme suit:

  1. Appelez la méthode VideosClient.getCaptureOverlayIntent().
  2. Si l'appel aboutit, les services de jeux Google Play renvoient un objet Task qui charge de manière asynchrone un intent pour lancer la superposition d'enregistrement vidéo.
  3. Utilisez l'intent de l'étape précédente pour démarrer une activité.

Voici un exemple d'affichage de la superposition d'enregistrement vidéo:

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);
        }
      });
}

Conseils d'utilisation des données d'enregistrement vidéo

L'API d'enregistrement vidéo vous permet d'intégrer une expérience d'enregistrement vidéo directement dans votre jeu.

Astuce Description
Faciliter la découverte du déclencheur d'enregistrement vidéo
  • Placez un bouton d'enregistrement bien en vue dans le menu principal
  • Déclenchez automatiquement la superposition à partir d'une option de menu d'enregistrement dédiée et clairement identifiée.
Promouvoir l'utilisation de la fonctionnalité sur votre fiche Play Store et dans le jeu
  • Utiliser une capture d'écran sur votre fiche Play Store qui montre l'enregistrement vidéo en superposition
  • Promouvoir l'enregistrement vidéo par le biais de promotions intégrées au jeu
  • Proposez des récompenses dans le jeu pour le partage de rediffusion
Suscitez l'intérêt de votre communauté de joueurs avec des rediffusions de compétition
  • Encouragez les joueurs à enregistrer et à partager des rediffusions de jeux à l'aide de compétitions hebdomadaires, mensuelles ou annuelles
  • Identifier les vidéos et les créateurs les plus populaires dans le jeu ou via les réseaux sociaux