Partage dans Instagram Reels sur Android

Ce document explique comment intégrer le partage dans votre application Android afin que les utilisateur·ices puissent partager des images, des vidéos et des stickers dans des Reels sur Instagram.

Overview

Reels Layers

The Reels composer has a background video layer and an optional sticker layer.

Background Video Layer – A video fills the screen
Sticker Layer – An optional sticker can appear in front of the video

Sharing Icon

For a consistent user experience across apps, download the standard sharing icon for Instagram Reels and use it in your app.

Before You Start

You will need:

A Meta app ID
You must Go Live with your Meta app before your app users can share content

Terms and Policies

By accessing and using this functionality, you acknowledge and agree to be bound by the Meta Platform Terms and Developer Policies. You also represent and warrant that any content made available through your application or website, or shared to Instagram Reels from your application or website, does not infringe upon the intellectual property rights of any third party and that you own, control or have otherwise secured all rights necessary to distribute, copy, publicly perform and display, or otherwise use the content via this functionality, including as uploaded and shared on Instagram Reels. You further represent and warrant that you have the authority to make the foregoing representations on behalf of your organization. If you do not have such authority or are otherwise unable to make the foregoing representations, you are not authorized to continue and should not do so.

Intégration du partage vers Instagram

Vous pouvez envoyer un intent explicite pour lancer l’application Instagram et lui envoyer des contenus pour les publier dans des Reels. L’application Instagram reçoit le contenu et le charge dans l’éditeur de Reels afin que l’utilisateur ou utilisatrice puisse le modifier et le publier dans ses Reels.

En général, le processus est le suivant :

Instanciez un intent.
Définissez le package "com.instagram.android" pour garantir la prise en charge de l’intent par l’application Instagram.
Associez votre ID d’application Meta et le contenu multimédia à l’intent.
Instanciez une activité.
Accordez les autorisations URI pour garantir la lecture du contenu multimédia par l’application Instagram.
Vérifiez que l’activité peut résoudre l’intent et démarrer l’activité.

Supprimez les fichiers temporaires que vous créez sur l’appareil de l’utilisateur·ice.

Données

Vous devez envoyer les données suivantes lorsque vous partagez dans les Reels.

Données Description

Données	Description
ID d’application Meta chaîne	Obligatoire. Votre ID d’application Meta
Vos contenus multimédias chaîne pour un seul contenu ou liste de plusieurs contenus	Obligatoire. Vous devez choisir l’une des options suivantes : L’URI d’une image enregistrée localement sur l’appareil de l’utilisateur·ice. Formats d’image acceptés : `JPG` `PNG` L’URI d’une vidéo enregistrée localement sur l’appareil de l’utilisateur·ice. Caractéristiques des vidéos : 1080p Durée comprise entre 3 et 60 secondes Format `H.264`, `H.265`, `MOV`, `MP4` ou `WebM` Format plein écran ou dimensions inférieures Une liste des URI des vidéos ou images enregistrées localement sur l’appareil de l’utilisateur·ice.
Stickers chaîne	L’URI d’un sticker enregistré localement sur l’appareil de l’utilisateur·ice. Formats acceptés : `JPG` et `PNG`. Dimensions : 640 × 480. Le sticker apparaît par dessus la vidéo.

ID d’application Meta

chaîne

Obligatoire. Votre ID d’application Meta

Vos contenus multimédias

chaîne pour un seul contenu

liste de plusieurs contenus

Obligatoire. Vous devez choisir l’une des options suivantes :

L’URI d’une image enregistrée localement sur l’appareil de l’utilisateur·ice. Formats d’image acceptés :
- JPG
- PNG
L’URI d’une vidéo enregistrée localement sur l’appareil de l’utilisateur·ice. Caractéristiques des vidéos :
- 1080p
- Durée comprise entre 3 et 60 secondes
- Format H.264, H.265, MOV, MP4 ou WebM
- Format plein écran ou dimensions inférieures
Une liste des URI des vidéos ou images enregistrées localement sur l’appareil de l’utilisateur·ice.

Stickers

chaîne

L’URI d’un sticker enregistré localement sur l’appareil de l’utilisateur·ice. Formats acceptés : JPG et PNG. Dimensions : 640 × 480. Le sticker apparaît par dessus la vidéo.

Exemples de code

Les exemples de code Java et Kotlin ci-dessous illustrent comment envoyer une seule image ou vidéo, plusieurs images ou vidéo, et des images ou vidéos avec un sticker.

Exemple avec un fichier multimédia

L’exemple de code suivant envoie un fichier à Instagram de sorte que l’utilisateur ou l’utilisatrice puisse le modifier et le publier dans ses Reels Instagram.

// Instantiate an intent
val intent = Intent("com.instagram.share.ADD_TO_REEL")

// Set package
intent.setPackage("com.instagram.android")

// Attach your App ID to the intent
val appId = "your-app-id"
intent.putExtra("com.instagram.platform.extra.APPLICATION_ID", appId)

// Attach your image or video to the intent from a URI
val mediaAssetUri = Uri.parse("your-image-or-video-asset-uri-goes-here")
intent.setDataAndType(mediaAssetUri, "image/* video/*")
intent.putExtra(Intent.EXTRA_STREAM, mediaAssetUri)

// Instantiate an activity
val activity: Activity = getActivity()

// Grant URI permissions
intent.flags = Intent.FLAG_GRANT_READ_URI_PERMISSION
val resInfoList = activity.packageManager.queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY)
for (resolveInfo in resInfoList) {
    val packageName = resolveInfo.activityInfo.packageName
    activity.grantUriPermission(packageName, mediaAssetUri, Intent.FLAG_GRANT_READ_URI_PERMISSION)
}

// Verify that the activity resolves the intent and start it
if (activity.packageManager.resolveActivity(intent, 0) != null) {
    activity.startActivityForResult(intent, 0)
}

// Instantiate an intent
Intent intent = new Intent("com.instagram.share.ADD_TO_REEL");

// Set package
intent.setPackage("com.instagram.android");

// Attach your App ID to the intent
String appId = "your-app-id";
intent.putExtra("com.instagram.platform.extra.APPLICATION_ID", appId);

// Attach your image or video to the intent from a URI
Uri mediaAssetUri = Uri.parse("your-image-or-video-asset-uri-goes-here");
intent.setDataAndType(mediaAssetUri, "image/* video/*");
intent.putExtra(Intent.EXTRA_STREAM, mediaAssetUri);

// Instantiate an activity
Activity activity = getActivity();

// Grant URI permissions
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
List<ResolveInfo> resInfoList = activity.getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
for (ResolveInfo resolveInfo : resInfoList) {
    String packageName = resolveInfo.activityInfo.packageName;
    activity.grantUriPermission(packageName, mediaAssetUri, Intent.FLAG_GRANT_READ_URI_PERMISSION);
}

// Verify that the activity resolves the intent and start it
if (activity.getPackageManager().resolveActivity(intent, 0) != null) {
    activity.startActivityForResult(intent, 0);
}

Exemple avec plusieurs fichiers multimédias

L’exemple de code suivant envoie plusieurs fichiers à Instagram de sorte que l’utilisateur ou l’utilisatrice puisse les modifier et les publier dans ses Reels Instagram.

// Instantiate an intent
val intent = Intent("com.instagram.share.ADD_TO_REEL_MULTIPLE")

// Set package
intent.setPackage("com.instagram.android")

// Attach your App ID to the intent
val appId = "your-app-id"
intent.putExtra("com.instagram.platform.extra.APPLICATION_ID", appId)
intent.setType("image/* video/*")

// Attach your files to the intent
val uri1 = Uri.parse("your-first-uri-goes-here")
val uri2 = Uri.parse("your-second-uri-goes-here")
val mediaList = mutableListOf<Uri>()
mediaList.addAll(listOf(uri1, uri2))
intent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, ArrayList(mediaList))

// Instantiate an activity
val activity: Activity = getActivity()

// Grant URI permissions
intent.flags = Intent.FLAG_GRANT_READ_URI_PERMISSION
val resInfoList =
activity.packageManager.queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY)
for (uri in mediaList) {
  for (resolveInfo in resInfoList) {
    val packageName = resolveInfo.activityInfo.packageName
    activity.grantUriPermission(packageName, uri, Intent.FLAG_GRANT_READ_URI_PERMISSION)
  }
}

// Verify that the activity resolves the intent and start it
if (activity.packageManager.resolveActivity(intent, 0) != null) {
  activity.startActivityForResult(intent, 0)
}

// Instantiate an intent
Intent intent = new Intent("com.instagram.share.ADD_TO_REEL_MULTIPLE");

// Set package
intent.setPackage("com.instagram.android");

// Attach your App ID to the intent
String appId = "your-app-id";
intent.putExtra("com.instagram.platform.extra.APPLICATION_ID", appId);
intent.setType("image/* video/*");

// Attach your files to the intent
Uri uri1 = Uri.parse("your-first-uri-goes-here");
Uri uri2 = Uri.parse("your-second-uri-goes-here");
ArrayList<Uri> mediaList = new ArrayList<>();
mediaList.add(uri1);
mediaList.add(uri2);
intent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, mediaList);

// Instantiate an activity
Activity activity = getActivity();

// Grant URI permissions
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
List<ResolveInfo> resInfoList = activity.getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
for (Uri uri : mediaList) {
    for (ResolveInfo resolveInfo : resInfoList) {
        String packageName = resolveInfo.activityInfo.packageName;
        activity.grantUriPermission(packageName, uri, Intent.FLAG_GRANT_READ_URI_PERMISSION);
    }
}

// Verify that the activity resolves the intent and start it
if (activity.getPackageManager().resolveActivity(intent, 0) != null) {
    activity.startActivityForResult(intent, 0);
}

Exemple avec un sticker

L’exemple de code suivant envoie une vidéo avec un sticker en option à Instagram de sorte que l’utilisateur ou l’utilisatrice puisse la modifier et la publier dans ses Reels Instagram.

// Instantiate an intent
val intent = Intent("com.instagram.share.ADD_TO_REEL")

// Set package
intent.setPackage("com.instagram.android")

// Attach your App ID to the intent
val appId = "your-app-id" 
intent.putExtra("com.instagram.platform.extra.APPLICATION_ID", appId)

// Attach your video to the intent from a URI
val videoAssetUri = Uri.parse("your-video-asset-uri-goes-here")
intent.setDataAndType(videoAssetUri, "video/*")
intent.putExtra(Intent.EXTRA_STREAM, videoAssetUri)

// Attach your sticker to the intent from a URI
val stickerAssetUri = Uri.parse("your-image-asset-uri-goes-here")
intent.putExtra("interactive_asset_uri", stickerAssetUri)

// Instantiate an activity
val activity: Activity = getActivity()

// Grant URI permissions
intent.flags = Intent.FLAG_GRANT_READ_URI_PERMISSION
val resInfoList = activity.packageManager.queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY)
for (resolveInfo in resInfoList) {
    val packageName = resolveInfo.activityInfo.packageName
    activity.grantUriPermission(packageName, videoAssetUri, Intent.FLAG_GRANT_READ_URI_PERMISSION)
    activity.grantUriPermission(packageName, stickerAssetUri, Intent.FLAG_GRANT_READ_URI_PERMISSION)
}

// Verify that the activity resolves the intent and start it
if (activity.packageManager.resolveActivity(intent, 0) != null) {
    activity.startActivityForResult(intent, 0)
}

// Instantiate an intent
Intent intent = new Intent("com.instagram.share.ADD_TO_REEL");

// Set package
intent.setPackage("com.instagram.android");

// Attach your App ID to the intent
String appId = "your-app-id";
intent.putExtra("com.instagram.platform.extra.APPLICATION_ID", appId);

// Attach your video to the intent from a URI
Uri videoAssetUri = Uri.parse("your-video-asset-uri-goes-here");
intent.setDataAndType(videoAssetUri, "video/*");
intent.putExtra(Intent.EXTRA_STREAM, videoAssetUri);

// Attach your sticker to the intent from a URI
Uri stickerAssetUri = Uri.parse("your-image-asset-uri-goes-here");
intent.putExtra("interactive_asset_uri", stickerAssetUri);

// Instantiate an activity
Activity activity = getActivity();

// Grant URI permissions
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
List<ResolveInfo> resInfoList = activity.getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
for (ResolveInfo resolveInfo : resInfoList) {
    String packageName = resolveInfo.activityInfo.packageName;
    activity.grantUriPermission(packageName, videoAssetUri, Intent.FLAG_GRANT_READ_URI_PERMISSION);
    activity.grantUriPermission(packageName, stickerAssetUri, Intent.FLAG_GRANT_READ_URI_PERMISSION);
}

// Verify that the activity resolves the intent and start it
if (activity.getPackageManager().resolveActivity(intent, 0) != null) {
  activity.startActivityForResult(intent, 0);
}

Exemple GitHub et tutoriel vidéo

Pour faciliter le travail des développeurs et développeuses, Meta a publié cet exemple de code pour le partage dans les Reels Instagram sur GitHub à l’adresse fbsamples/share_to_reels_android. Regardez la vidéo suivante pour découvrir comment utiliser l’exemple de code GitHub.

Une erreur s’est produite

Nous rencontrons des difficultés pour lire cette vidéo.

Voir aussi

Développer avec les technologies Meta

GitHub

Partage dans Instagram Reels sur GitHub