Enregistrement vidéo dans les jeux Android

Suite à l'abandon de l'API Connexion Google, nous allons supprimer le SDK games v1 en 2026. Après février 2025, vous ne pourrez plus publier sur Google Play des titres nouvellement intégrés au SDK v1 des jeux. Nous vous recommandons d'utiliser le SDK Games v2 à la place.
Bien que les titres existants avec les intégrations de la version 1 des jeux précédents continuent de fonctionner pendant quelques années, nous vous encourageons à migrer vers la version 2 à partir de juin 2025.
Ce guide explique comment utiliser le SDK de la version 1 des services de jeux Play. L'enregistrement vidéo n'est pas compatible avec le SDK v2 des services de jeux Play.

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.