Enregistrement vidéo dans les jeux Android

Suite à l'arrêt de l'API Google Sign-In, nous allons supprimer le SDK v1 pour les jeux en 2026. Après février 2025, vous ne pourrez plus publier de titres qui viennent d'être intégrés au SDK v1 de Jeux sur Google Play. Nous vous recommandons d'utiliser plutôt le SDK v2 de Jeux.
Bien que les titres existants avec les intégrations de jeux v1 précédentes continuent de fonctionner pendant quelques années, nous vous encourageons à migrer vers la v2 à partir de juin 2025.
Ce guide explique comment utiliser la version 1 du SDK des services de jeux Play. L'enregistrement vidéo n'est pas compatible avec la version 2 du SDK 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 l'écran de rediffusion d'un 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 Video Recording :

Obtenir le client Videos

Pour commencer à utiliser l'API Video Recording, 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 fonctionnalité d'enregistrement vidéo directement dans votre jeu.

Voici ce que les utilisateurs peuvent faire lorsqu'ils enregistrent une vidéo :

  • 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

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

  • Un toast cliquable qui s'affiche à la fin de l'enregistrement et qui permet aux joueurs d'importer la vidéo sur YouTube ou de la visionner dans 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 permettant de 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 de la façon d'afficher l'interface de 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 fonctionnalité d'enregistrement vidéo directement dans votre jeu.

Conseil Description
Rendre le déclencheur d'enregistrement vidéo facilement visible
  • Placer un bouton d'enregistrement bien en évidence en dehors de votre menu principal
  • Déclencher automatiquement l'overlay à partir d'une option de menu de mode d'enregistrement dédiée et clairement libellée
Faites la promotion de la fonctionnalité dans votre fiche Play Store et dans le jeu
  • Utilisez une capture d'écran de votre fiche Play Store qui affiche la superposition d'enregistrement vidéo.
  • Faites la promotion de la fonctionnalité d'enregistrement vidéo dans le jeu.
  • Pensez à proposer des récompenses dans le jeu pour le partage de replays
Engagez votre communauté de joueurs avec des compétitions de rediffusions
  • Encouragez les joueurs à enregistrer et à partager des replays de leurs parties en organisant des compétitions hebdomadaires, mensuelles ou annuelles.
  • Identifier les vidéos et les créateurs les plus populaires dans le jeu ou sur les réseaux sociaux