Ricevi dati semplici da altre app

Così come un'app può inviare dati ad altre app, può riceverli anche da altre app. Pensa a come gli utenti interagiscono con la tua applicazione e ai tipi di dati che vuoi ricevere da altre applicazioni. Ad esempio, un'applicazione di social network potrebbe essere interessata a ricevere contenuti di testo, come un URL web interessante, da un'altra app.

Gli utenti di altre app inviano spesso dati alla tua app tramite Android Sharesheet o lo strumento di risoluzione intent. Le app che inviano dati alla tua app devono impostare un tipo MIME per i dati. La tua app può ricevere i dati inviati da un'altra app nei seguenti modi:

• Un elemento Activity con un tag intent-filter corrispondente nel file manifest
• Condivisione delle scorciatoie pubblicate dalla tua app.

Le destinazioni della Condivisione diretta sono link diretti a un'attività specifica all'interno dell'app. Spesso rappresentano una persona o un gruppo e vengono mostrati da Sharesheet di Android. Ad esempio, un'app di messaggistica può fornire una destinazione della condivisione diretta per una persona che aggiunge link diretti a una conversazione con quella persona. Per istruzioni dettagliate, consulta Fornire target della condivisione diretta.

Supportare i tipi MIME

Idealmente, un'app deve essere in grado di ricevere il maggior numero possibile di tipi MIME. Ad esempio, un'app di messaggistica progettata per l'invio di testo, immagini e video supporta idealmente la ricezione di text/*, image/* e video/*. Ecco alcuni tipi MIME comuni per l'invio e la ricezione di dati semplici in Android.

I destinatari si registrano a	Invio dei mittenti
text/*	text/plain text/rtf text/html text/json
`image/*`	image/jpg image/png image/gif
video/*	video/mp4 video/3gp
Estensioni dei file supportate	application/pdf

Fai riferimento al registro ufficiale IANA dei tipi multimediali MIME.

Attenzione :anche se puoi ricevere un tipo MIME */*, sconsigliamo vivamente di farlo, a meno che la tua app non sia completamente in grado di gestire qualsiasi tipo di contenuti in entrata.

Raggiungi ottimi obiettivi di condivisione

Quando un utente tocca una destinazione di condivisione associata a un'attività specifica, dovrebbe essere in grado di confermare e modificare i contenuti condivisi prima di utilizzarli. Ciò è particolarmente importante per i dati di testo.

Ricevere dati con un'attività

La ricezione di dati con un'attività comporta l'aggiornamento del manifest, la gestione dei contenuti in arrivo e la verifica che l'utente riconosca la tua app.

Aggiornare il file manifest

I filtri per intent comunicano al sistema gli intent accettati da un componente dell'app. In modo simile a come hai creato un intent con un'azione ACTION_SEND nella lezione Invio di dati semplici ad altre app, crei filtri per intent per riceverli con questa azione. Per definire un filtro per intent nel file manifest, devi utilizzare l'elemento <intent-filter>. Ad esempio, se l'app gestisce la ricezione di contenuti di testo, un file manifest che include una o più immagini di qualsiasi tipo sarà simile al seguente 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 un'altra app tenta di condividere uno qualsiasi di questi elementi sviluppando un intent e passandolo a startActivity(), la tua applicazione viene elencata come opzione in Android Sharesheet o nel resolver di intent. Se l'utente seleziona la tua app, viene avviata l'attività corrispondente (.ui.MyActivity nell'esempio precedente). Spetta a te gestire i contenuti in modo appropriato nel codice e nell'interfaccia utente.

Nota: per saperne di più sui filtri per intent e sulla risoluzione degli intent, leggi Intent e filtri per intent.

Gestire i contenuti in arrivo

Per gestire i contenuti pubblicati da un Intent, chiama getIntent() per ottenere l'oggetto Intent. Una volta ottenuto l'oggetto, puoi esaminarne i contenuti per decidere cosa fare. Se questa attività può essere avviata da altre parti del sistema (ad esempio, Avvio app), tienine conto quando analizzi l'intento.

Controlla i dati in arrivo, perché non saprai mai quali altre applicazioni potrebbero inviarti. Ad esempio, potrebbe essere impostato il tipo MIME errato o l'immagine inviata potrebbe essere molto grande. Inoltre, ricordati di elaborare i dati binari in un thread separato anziché nel thread principale ("UI").

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
    }
}

L'aggiornamento dell'interfaccia utente dopo aver ricevuto i dati può essere semplice come compilare una EditText o più complicato, come l'applicazione di un filtro fotografico interessante a un'immagine. Sta all'app cosa succederà dopo.

Assicurati che gli utenti riconoscano la tua app

La tua app è rappresentata dall'icona e dall'etichetta nel file Sharesheet di Android e dallo strumento di risoluzione degli intent. Entrambi sono definiti nel manifest. Puoi impostare le etichette dei filtri per intent o attività per fornire maggiore contesto.

A partire da Android 10 (livello API 29), Android Sharesheet utilizza solo le icone impostate nel file manifest del tag application. Android ignora le icone impostate nei tag intent-filter e activity.

Nota: i target di condivisione effettiva non richiedono un'etichetta e un'icona nel filtro per intent o attività associato. Il nome e l'icona dell'app ricevente da soli devono essere sufficienti per consentire a un utente di capire cosa succede quando condivide.