Receber dados simples de outros apps

Da mesma forma que um app envia dados a outros apps, ele também pode receber dados de outros apps. Pense em como os usuários interagem com seu app e nos tipos de dados que você quer receber de outros apps. Por exemplo, um aplicativo de rede social pode querer receber conteúdo de texto de outro app, como um URL da Web interessante.

Os usuários de outros apps geralmente enviam dados ao seu app pelo Android Sharesheet ou pelo resolvedor de intents. Os apps que enviam dados para seu app precisam definir um tipo MIME para esses dados. Seu app pode receber dados enviados por outro app das seguintes maneiras:

• Uma Activity com uma tag intent-filter correspondente no manifesto
• Atalhos de compartilhamento publicados pelo seu app.

Os alvos de compartilhamento direto são links diretos para uma atividade específica no seu app. Eles geralmente representam uma pessoa ou um grupo, e o Android Sharesheet os mostra. Por exemplo, um app de mensagens de texto pode oferecer um alvo de compartilhamento direto para alguém que tem link direto para uma conversa com essa pessoa. Consulte Fornecer destinos de compartilhamento direto para instruções detalhadas.

Oferecer suporte a tipos MIME

O ideal é que um app consiga receber o maior número possível de tipos MIME. Por exemplo, um app de mensagens projetado para enviar texto, imagens e vídeos deve oferecer suporte ao recebimento de text/*, image/* e video/*. Confira alguns tipos MIME comuns para enviar e receber dados simples no Android.

Os receptores se registram para	Os remetentes enviam
text/*	text/plain text/rtf text/html text/json
`image/*`	image/jpg image/png image/gif
video/*	video/mp4 video/3gp
Extensões de arquivo compatíveis	application/pdf

Consulte o registro oficial de tipos de mídia MIME da IANA (em inglês).

Cuidado: embora seja possível receber um tipo MIME de */*, não recomendamos isso, a menos que o app seja totalmente capaz de processar qualquer tipo de conteúdo recebido.

Criar ótimos alvos de compartilhamento

Quando um usuário toca em um alvo de compartilhamento associado a uma atividade específica, ele precisa poder confirmar e editar o conteúdo compartilhado antes de usá-lo. Isso é especialmente importante no caso de dados de mensagens de texto.

Receber dados com uma atividade

Receber dados com uma atividade envolve atualizar o manifesto, processar o conteúdo recebido e garantir que o usuário reconheça o app.

Atualizar seu manifesto

Os filtros de intent informam ao sistema quais intents um componente do app aceita. Da mesma forma que você criou uma intent com uma ação ACTION_SEND na lição Como enviar dados simples para outros apps, crie filtros de intent para receber intents com essa ação. O filtro de intent é definido no manifesto usando o elemento <intent-filter>. Por exemplo, se o app processa conteúdo de mensagens de texto recebidas e uma única imagem, ou diversas imagens, de qualquer tipo, um manifesto que inclui uma ou mais imagens de qualquer tipo tem o seguinte snippet:

<activity android:name=".ui.MyActivity" >
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="image/*" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/plain" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.SEND_MULTIPLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="image/*" />
    </intent-filter>
</activity>

Quando outro app tentar compartilhar qualquer um desses itens criando uma intent e transmitindo-a para startActivity(), seu app será listado como uma opção no Android Sharesheet ou no resolvedor de intents. Se o usuário selecionar seu app, isso vai iniciar a atividade correspondente (.ui.MyActivity no exemplo anterior). Cabe a você processar o conteúdo corretamente no seu código e na IU.

Observação: para mais informações sobre filtros de intent e resolução de intents, leia Intents e filtros de intent.

Processar o conteúdo recebido

Para processar o conteúdo enviado por um Intent, chame getIntent() para conseguir o objeto Intent. Assim que você tiver o objeto, poderá analisar o conteúdo dele e determinar o que fazer em seguida. Se essa atividade puder ser iniciada de outras partes do sistema (como a tela de início), considere isso ao examinar a intent.

Verifique os dados recebidos com muita atenção, porque nunca se sabe o que outro app pode enviar. Por exemplo, o tipo MIME incorreto pode estar definido ou a imagem enviada pode ser grande demais. Além disso, lembre-se de processar dados binários em uma linha de execução separada, não na linha de execução principal (IU).

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    when {
        intent?.action == Intent.ACTION_SEND -> {
            if ("text/plain" == intent.type) {
                handleSendText(intent) // Handle text being sent
            } else if (intent.type?.startsWith("image/") == true) {
                handleSendImage(intent) // Handle single image being sent
            }
        }
        intent?.action == Intent.ACTION_SEND_MULTIPLE
                && intent.type?.startsWith("image/") == true -> {
                handleSendMultipleImages(intent) // Handle multiple images being sent
        }
        else -> {
            // Handle other intents, such as being started from the home screen
        }
    }
    ...
}

private fun handleSendText(intent: Intent) {
    intent.getStringExtra(Intent.EXTRA_TEXT)?.let {
        // Update UI to reflect text being shared
    }
}

private fun handleSendImage(intent: Intent) {
    (intent.getParcelableExtra<Parcelable>(Intent.EXTRA_STREAM) as? Uri)?.let {
        // Update UI to reflect image being shared
    }
}

private fun handleSendMultipleImages(intent: Intent) {
    intent.getParcelableArrayListExtra<Parcelable>(Intent.EXTRA_STREAM)?.let {
        // Update UI to reflect multiple images being shared
    }
}

Java

void onCreate (Bundle savedInstanceState) {
    ...
    // Get intent, action and MIME type
    Intent intent = getIntent();
    String action = intent.getAction();
    String type = intent.getType();

    if (Intent.ACTION_SEND.equals(action) && type != null) {
        if ("text/plain".equals(type)) {
            handleSendText(intent); // Handle text being sent
        } else if (type.startsWith("image/")) {
            handleSendImage(intent); // Handle single image being sent
        }
    } else if (Intent.ACTION_SEND_MULTIPLE.equals(action) && type != null) {
        if (type.startsWith("image/")) {
            handleSendMultipleImages(intent); // Handle multiple images being sent
        }
    } else {
        // Handle other intents, such as being started from the home screen
    }
    ...
}

void handleSendText(Intent intent) {
    String sharedText = intent.getStringExtra(Intent.EXTRA_TEXT);
    if (sharedText != null) {
        // Update UI to reflect text being shared
    }
}

void handleSendImage(Intent intent) {
    Uri imageUri = (Uri) intent.getParcelableExtra(Intent.EXTRA_STREAM);
    if (imageUri != null) {
        // Update UI to reflect image being shared
    }
}

void handleSendMultipleImages(Intent intent) {
    ArrayList<Uri> imageUris = intent.getParcelableArrayListExtra(Intent.EXTRA_STREAM);
    if (imageUris != null) {
        // Update UI to reflect multiple images being shared
    }
}

A atualização da IU após o recebimento dos dados pode ser tão simples quanto preencher um EditText ou mais complexa, como aplicar um filtro de foto interessante a uma imagem. Cabe ao app determinar o que acontece em seguida.

Garantir que os usuários reconheçam seu app

Seu app é representado pelo ícone e etiqueta no Android Sharesheet e no resolvedor de intents. Ambos são definidos no manifesto. Você pode definir rótulos de atividade ou filtro de intent para fornecer mais contexto.

A partir do Android 10 (API de nível 29), o Android Sharesheet só usa ícones definidos no manifesto da tag application. O Android ignora os ícones definidos nas tags intent-filter e activity.

Observação: os alvos de compartilhamento eficazes não precisam de uma etiqueta e um ícone na atividade ou no filtro de intents associado. O nome e o ícone do app de destino precisam ser suficientes para que o usuário entenda o que acontece quando ele compartilha.