Como compartilhar no Feed

Com o Como compartilhar no Feed, você pode permitir que os usuários do seu aplicativo compartilhem conteúdo no Feed do Instagram deles.

Visão geral

Ao usar os intents implícitos do Android e os links universais ou a interação de documentos do iOS, o seu aplicativo pode transferir fotos e vídeos para o aplicativo do Instagram. O aplicativo do Instagram receberá o conteúdo e fará o carregamento no Compositor do Feed para que o usuário possa publicá-lo no próprio Feed do Instagram.

Desenvolvedores do Android

As implementações do Android usam intents implícitos com o EXTRA_STREAM extra para solicitar que o usuário selecione o aplicativo do Instagram. Quando selecionado, o intent iniciará o aplicativo do Instagram e transferirá o conteúdo para ele. Depois disso, o conteúdo será carregado pelo aplicativo do Instagram no Compositor do Feed.

Em geral, o fluxo de compartilhamento deve incluir estas ações:

1. Instanciar um intent implícito com o conteúdo que você quer transferir para o aplicativo do Instagram.
2. Iniciar uma atividade e verificar se ela pode resolver o intent implícito.
3. Resolver a atividade, se ele puder.

Conteúdo compartilhável

Você pode transferir o seguinte conteúdo para o aplicativo do Instagram:

Como compartilhar um ativo de imagem

String type = "image/*";
String filename = "/myPhoto.jpg";
String mediaPath = Environment.getExternalStorageDirectory() + filename;

createInstagramIntent(type, mediaPath);

private void createInstagramIntent(String type, String mediaPath){

    // Create the new Intent using the 'Send' action.
    Intent share = new Intent(Intent.ACTION_SEND);

    // Set the MIME type
    share.setType(type);

    // Create the URI from the media
    File media = new File(mediaPath);
    Uri uri = Uri.fromFile(media);

    // Add the URI to the Intent.
    share.putExtra(Intent.EXTRA_STREAM, uri);

    // Broadcast the Intent.
    startActivity(Intent.createChooser(share, "Share to"));
}

Como compartilhar um ativo de vídeo

String type = "video/*";
String filename = "/myVideo.mp4";
String mediaPath = Environment.getExternalStorageDirectory() + filename;

createInstagramIntent(type, mediaPath);

private void createInstagramIntent(String type, String mediaPath){

    // Create the new Intent using the 'Send' action.
    Intent share = new Intent(Intent.ACTION_SEND);

    // Set the MIME type
    share.setType(type);

    // Create the URI from the media
    File media = new File(mediaPath);
    Uri uri = Uri.fromFile(media);

    // Add the URI to the Intent.
    share.putExtra(Intent.EXTRA_STREAM, uri);

    // Broadcast the Intent.
    startActivity(Intent.createChooser(share, "Share to"));
}

Desenvolvedores do iOS

As implementações do iOS podem usar links universais para iniciar o aplicativo do Instagram e transferir um conteúdo para ele ou solicitar alguma ação específica.

Links universais

Para realizar ações no aplicativo do Instagram, use os links universais listados abaixo:

Exemplo de código em Objective-C

Este exemplo de código em Objective-C inicia o aplicativo do Instagram com a visualização de câmera.

NSURL *instagramURL = [NSURL URLWithString:@"https://www.instagram.com/create/story"];
if ([[UIApplication sharedApplication] canOpenURL:instagramURL]) {
    [[UIApplication sharedApplication] openURL:instagramURL];
}

Interação de documentos

Caso o seu aplicativo crie fotos e você queira que os usuários as compartilhem no Instagram, use a API de Interação de Documentos para abrir a sua foto no fluxo de compartilhamento do Instagram.

Primeiro, salve o arquivo em formato PNG ou JPEG (preferencial) e use a extensão de nome de arquivo .ig. Com as APIs de Interação de Documentos do iOS, você pode acionar a foto que será aberta pelo Instagram. O identificador do nosso UTI de interação de documentos é com.instagram.photo. Ele está em conformidade com os UTIs public/jpeg e public/png. Consulte os artigos na documentação da Apple: Previewing and Opening Files e UIDocumentInteractionController Class Reference para mais informações.

Como alternativa, para mostrar somente o Instagram na lista de aplicativos (em vez do Instagram e outros aplicativos em conformidade com public/jpeg), especifique a classe de extensão igo, que é do tipo com.instagram.exclusivegram.

Quando acionado, o Instagram mostrará imediatamente ao usuário nossa tela de filtro. A imagem é pré-carregada e dimensionada de acordo com o Instagram. Para melhorar os resultados, o Instagram prefere abrir uma imagem quadrada em JPEG que tenha 640 x 640 pixels. Se a imagem for maior, ela será redimensionada dinamicamente.