Enregistrement vidéo dans les jeux Android

L'API d'enregistrement vidéo vous permet d'ajouter facilement l'enregistrement 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 sur un écran de relecture de combat qui, lorsqu'il est enfoncé, affiche l'expérience d'enregistrement vidéo Play Jeux.

Ce guide explique comment implémenter 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:

• Téléchargez et consultez l'exemple de code.

• Familiarisez-vous avec les recommandations décrites dans la checklist de contrôle de qualité.

Obtenir le client de vidéos

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 du compte du joueur, consultez Se connecter dans les jeux Android.

Principes de base de l'API Video Recording

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

L'expérience d'enregistrement vidéo pour les utilisateurs est la suivante:

• La superposition d'enregistrement vidéo, qui comporte trois boutons:

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

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

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

Lancer la superposition d'enregistrement vidéo

Pour lancer l'enregistrement vidéo du joueur 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 pour utiliser les 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.