Uso compartido en reels Instagram desde Android

En este documento, se explica cómo integrar el uso compartido en tu app de Android, para que los usuarios puedan compartir imágenes, videos y stickers en reels de 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.

Implementar el uso compartido en Instagram

Utiliza una intención explícita para iniciar la app de Instagram y enviarle contenido de reels. La app de Instagram recibe el contenido y lo carga en el editor de reels, y el usuario puede editar y publicar el contenido en sus reels.

Por lo general, el proceso de contenido compartido realiza lo siguiente:

Crea una instancia de una intención.
Configura un paquete igual a "com.instagram.android" para garantizar que la app de Instagram pueda procesar la intención.
Adjunta identificador de la app de Meta y el contenido multimedia a la intención.
Crea una instancia de una actividad.
Concede permisos de URI para garantizar que Instagram pueda leer el contenido multimedia.
Verifica que la actividad pueda resolver la intención e inicia la actividad.

Elimina los archivos temporales que creas en el dispositivo del usuario.

Datos

Deberías enviar los siguientes datos cuando compartes contenido en reels:

Datos Descripción

Datos	Descripción
Identificador de la app de Meta cadena	Obligatorio. Tu identificador de la app de Meta.
Activos multimedia cadena en el caso de un solo activo o una lista en el caso de varios activos	Obligatorio. Una de las siguientes opciones es obligatoria: El URI de una imagen, que es un archivo local en el dispositivo del usuario. Formatos de imagen admitidos: `JPG` `PNG` El URI de un video, que es un archivo local en el dispositivo del usuario. Los videos deben tener las siguientes características: 1.080 p Entre 3 y 60 segundos de duración Los formatos de video admitidos son `H.264`, `H.265`, `MOV`, `MP4` y `WebM` Deben ser en pantalla completa o más pequeños Una lista de URI de videos y/o imágenes, que son archivos locales en el dispositivo del usuario.
Activo de sticker cadena	El URI de un sticker, que es un archivo local en el dispositivo del usuario. Los formatos de sticker admitidos son `JPG` y `PNG`, y se recomienda que sus dimensiones sean 640 x 480. El sticker aparece sobre el video.

Identificador de la app de Meta

cadena

Obligatorio. Tu identificador de la app de Meta.

Activos multimedia

cadena en el caso de un solo activo

una lista en el caso de varios activos

Obligatorio. Una de las siguientes opciones es obligatoria:

El URI de una imagen, que es un archivo local en el dispositivo del usuario. Formatos de imagen admitidos:
- JPG
- PNG
El URI de un video, que es un archivo local en el dispositivo del usuario. Los videos deben tener las siguientes características:
- 1.080 p
- Entre 3 y 60 segundos de duración
- Los formatos de video admitidos son H.264, H.265, MOV, MP4 y WebM
- Deben ser en pantalla completa o más pequeños
Una lista de URI de videos y/o imágenes, que son archivos locales en el dispositivo del usuario.

Activo de sticker

cadena

El URI de un sticker, que es un archivo local en el dispositivo del usuario. Los formatos de sticker admitidos son JPG y PNG, y se recomienda que sus dimensiones sean 640 x 480. El sticker aparece sobre el video.

Ejemplos de códigos

En los siguientes ejemplos de código de Java y Kotlin, se muestra cómo enviar una imagen o un video simples, cómo enviar varias imágenes o videos, y cómo enviar imágenes o videos con un sticker.

Ejemplo con un archivo multimedia

El siguiente ejemplo de código envía un archivo a Instagram para que el usuario pueda editarlo y publicarlo en Instagram Reels.

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

Ejemplo con varios archivos multimedia

El siguiente ejemplo de código envía varios archivos a Instagram para que el usuario pueda editarlos y publicarlos en Instagram Reels.

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

Ejemplo con sticker

El siguiente ejemplo de código envía un video a Instagram e incluye un sticker opcional, de modo que el usuario pueda editarlo y publicarlo en Instagram Reels.

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

Ejemplo de GitHub y tutorial de video

Para brindar mayor comodidad a los desarrolladores, Meta publicó un código de ejemplo para contenido compartido de Instagram Reels en GitHub, en fbsamples/share_to_reels_android. Mira el siguiente video para aprender a usar el ejemplo de GitHub.

Se produjo un error

Tenemos problemas para reproducir este video.

Más información

Desarrollo con tecnologías de Meta

GitHub

Uso compartido de reels de Instagram en GitHub