Il selettore di foto incorporato: un modo più semplice per richiedere foto e video in privato nella tua app
Preparati a migliorare l'esperienza utente della tua app con un nuovo entusiasmante modo di utilizzare il selettore di foto Android. Il nuovo selettore di foto incorporato offre agli utenti un modo semplice e incentrato sulla privacy per selezionare foto e video direttamente dall'interfaccia della tua app. Ora la tua app può usufruire di tutti i vantaggi disponibili con il selettore di foto, incluso l'accesso ai contenuti cloud, integrati direttamente nell'esperienza della tua app.
Perché embedded?
Sappiamo che molte app vogliono offrire agli utenti un'esperienza altamente integrata e fluida durante la selezione di foto o video. Il selettore di foto incorporato è progettato proprio per questo, consentendo agli utenti di accedere rapidamente alle loro foto recenti senza mai uscire dalla tua app. Possono anche esplorare l'intera raccolta nel loro fornitore di contenuti multimediali cloud preferito (ad es. Google Foto), inclusi preferiti, album e funzionalità di ricerca. In questo modo, gli utenti non devono passare da un'app all'altra o preoccuparsi di dove sia archiviata la foto che vogliono, se localmente o nel cloud.
Integrazione perfetta, privacy migliorata
Con il selettore di foto incorporato, la tua app non ha bisogno di accedere alle foto o ai video dell'utente finché quest'ultimo non seleziona effettivamente qualcosa. Ciò significa maggiore privacy per gli utenti e un'esperienza più semplificata. Inoltre, il selettore di foto incorporato consente agli utenti di accedere all'intera raccolta multimediale basata su cloud, mentre l'autorizzazione standard per le foto è limitata ai soli file locali.
Il selettore di foto incorporato in Google Messaggi
Google Messaggi mostra la potenza del selettore di foto incorporato. Ecco come l'hanno integrata:
- Posizionamento intuitivo: il selettore di foto si trova proprio sotto il pulsante della fotocamera, offrendo agli utenti una scelta chiara tra scattare una nuova foto o selezionarne una esistente.
- Anteprima dinamica: subito dopo aver toccato una foto, l'utente vede un'anteprima di grandi dimensioni, che semplifica la conferma della selezione. Se deseleziona la foto, l'anteprima scompare, mantenendo l'esperienza pulita e ordinata.
- Espandi per visualizzare altri contenuti: la visualizzazione iniziale è semplificata e offre un facile accesso alle foto recenti. Tuttavia, gli utenti possono espandere facilmente il selettore di foto per sfogliare e scegliere tra tutte le foto e i video della loro raccolta, inclusi i contenuti cloud di Google Foto.
- Rispetto delle scelte dell'utente: il selettore di foto incorporato concede l'accesso solo alle foto o ai video specifici selezionati dall'utente, il che significa che non è più necessario richiedere le autorizzazioni per foto e video. In questo modo, l'app Messaggi non deve gestire situazioni in cui gli utenti concedono solo un accesso limitato a foto e video.
Implementazione
L'integrazione del selettore di foto incorporato è semplificata dalla libreria Jetpack Selettore di foto.
Jetpack Compose
Innanzitutto, includi la libreria del selettore di foto di Jetpack come dipendenza.
implementation("androidx.photopicker:photopicker-compose:1.0.0-alpha01")
La funzione componibile EmbeddedPhotoPicker fornisce un meccanismo per includere la UI del selettore di foto incorporato direttamente nella schermata di Compose. Questo composable crea una SurfaceView che ospita la UI del selettore di foto incorporato. Gestisce la connessione al servizio EmbeddedPhotoPicker, gestisce le interazioni dell'utente e comunica gli URI dei contenuti multimediali selezionati all'applicazione chiamante.
@Composable
fun EmbeddedPhotoPickerDemo() {
// We keep track of the list of selected attachments
var attachments by remember { mutableStateOf(emptyList<Uri>()) }
val coroutineScope = rememberCoroutineScope()
// We hide the bottom sheet by default but we show it when the user clicks on the button
val scaffoldState = rememberBottomSheetScaffoldState(
bottomSheetState = rememberStandardBottomSheetState(
initialValue = SheetValue.Hidden,
skipHiddenState = false
)
)
// Customize the embedded photo picker
val photoPickerInfo = EmbeddedPhotoPickerFeatureInfo
.Builder()
// Set limit the selection to 5 items
.setMaxSelectionLimit(5)
// Order the items selection (each item will have an index visible in the photo picker)
.setOrderedSelection(true)
// Set the accent color (red in this case, otherwise it follows the device's accent color)
.setAccentColor(0xFF0000)
.build()
// The embedded photo picker state will be stored in this variable
val photoPickerState = rememberEmbeddedPhotoPickerState(
onSelectionComplete = {
coroutineScope.launch {
// Hide the bottom sheet once the user has clicked on the done button inside the picker
scaffoldState.bottomSheetState.hide()
}
},
onUriPermissionGranted = {
// We update our list of attachments with the new Uris granted
attachments += it
},
onUriPermissionRevoked = {
// We update our list of attachments with the Uris revoked
attachments -= it
}
)
SideEffect {
val isExpanded = scaffoldState.bottomSheetState.targetValue == SheetValue.Expanded
// We show/hide the embedded photo picker to match the bottom sheet state
photoPickerState.setCurrentExpanded(isExpanded)
}
BottomSheetScaffold(
topBar = {
TopAppBar(title = { Text("Embedded Photo Picker demo") })
},
scaffoldState = scaffoldState,
sheetPeekHeight = if (scaffoldState.bottomSheetState.isVisible) 400.dp else 0.dp,
sheetContent = {
Column(Modifier.fillMaxWidth()) {
// We render the embedded photo picker inside the bottom sheet
EmbeddedPhotoPicker(
state = photoPickerState,
embeddedPhotoPickerFeatureInfo = photoPickerInfo
)
}
}
) { innerPadding ->
Column(Modifier.padding(innerPadding).fillMaxSize().padding(horizontal = 16.dp)) {
Button(onClick = {
coroutineScope.launch {
// We expand the bottom sheet, which will trigger the embedded picker to be shown
scaffoldState.bottomSheetState.partialExpand()
}
}) {
Text("Open photo picker")
}
LazyVerticalGrid(columns = GridCells.Adaptive(minSize = 64.dp)) {
// We render the image using the Coil library
itemsIndexed(attachments) { index, uri ->
AsyncImage(
model = uri,
contentDescription = "Image ${index + 1}",
contentScale = ContentScale.Crop,
modifier = Modifier.clickable {
coroutineScope.launch {
// When the user clicks on the media from the app's UI, we deselect it
// from the embedded photo picker by calling the method deselectUri
photoPickerState.deselectUri(uri)
}
}
)
}
}
}
}
}Visualizzazioni
Innanzitutto, includi la libreria del selettore di foto di Jetpack come dipendenza.
implementation("androidx.photopicker:photopicker:1.0.0-alpha01")
Per aggiungere il selettore di foto incorporato, devi aggiungere una voce al file di layout.
<view class="androidx.photopicker.EmbeddedPhotoPickerView"
android:id="@+id/photopicker"
android:layout_width="match_parent"
android:layout_height="match_parent" />E inizializzalo nella tua attività/frammento.
// We keep track of the list of selected attachments
private val _attachments = MutableStateFlow(emptyList<Uri>())
val attachments = _attachments.asStateFlow()
private lateinit var picker: EmbeddedPhotoPickerView
private var openSession: EmbeddedPhotoPickerSession? = null
val pickerListener = object EmbeddedPhotoPickerStateChangeListener {
override fun onSessionOpened (newSession: EmbeddedPhotoPickerSession) {
openSession = newSession
}
override fun onSessionError (throwable: Throwable) {}
override fun onUriPermissionGranted(uris: List<Uri>) {
_attachments += uris
}
override fun onUriPermissionRevoked (uris: List<Uri>) {
_attachments -= uris
}
override fun onSelectionComplete() {
// Hide the embedded photo picker as the user is done with the photo/video selection
}
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.main_view)
//
// Add the embedded photo picker to a bottom sheet to allow the dragging to display the full photo library
//
picker = findViewById(R.id.photopicker)
picker.addEmbeddedPhotoPickerStateChangeListener(pickerListener)
picker.setEmbeddedPhotoPickerFeatureInfo(
// Set a custom accent color
EmbeddedPhotoPickerFeatureInfo.Builder().setAccentColor(0xFF0000).build()
)
}Puoi chiamare diversi metodi di EmbeddedPhotoPickerSession per interagire con il selettore incorporato.
// Notify the embedded picker of a configuration change openSession.notifyConfigurationChanged(newConfig) // Update the embedded picker to expand following a user interaction openSession.notifyPhotoPickerExpanded(/* expanded: */ true) // Resize the embedded picker openSession.notifyResized(/* width: */ 512, /* height: */ 256) // Show/hide the embedded picker (after a form has been submitted) openSession.notifyVisibilityChanged(/* visible: */ false) // Remove unselected media from the embedded picker after they have been // unselected from the host app's UI openSession.requestRevokeUriPermission(removedUris)
È importante notare che l'esperienza del selettore di foto incorporato è disponibile per gli utenti con Android 14 (livello API 34) o versioni successive con SDK Extensions 15+. Scopri di più sulla disponibilità del selettore di foto sui dispositivi.
Per una maggiore privacy e sicurezza dell'utente, il sistema esegue il rendering del selettore di foto incorporato in modo da impedire qualsiasi disegno o overlay. Questa scelta di design intenzionale significa che la tua UX deve considerare l'area di visualizzazione del selettore di foto come un elemento distinto e dedicato, proprio come faresti per un banner pubblicitario.
Se hai feedback o suggerimenti, invia i ticket al nostro Issue Tracker.
-
Novità sui prodottiLe app che hanno come target la prossima release di Android non potranno più scrivere direttamente nei contatti con l'autorizzazione WRITE_CONTACTS.
Roxanna Aliabadi Walker • Tempo di lettura: 6 min -
Novità sui prodottiLa privacy e il controllo dell'utente rimangono al centro dell'esperienza Android. Proprio come il selettore di foto ha reso la condivisione di contenuti multimediali sicura e facile da implementare, ora stiamo portando lo stesso livello di privacy, semplicità e un'esperienza utente ottimale alla selezione dei contatti.
Roxanna Aliabadi Walker • Tempo di lettura: 4 min -
Novità sui prodottiPer offrire queste esperienze ai giocatori e garantire che i tuoi giochi siano perfetti su schermi di qualsiasi dimensione, Google Play sta introducendo nuovi requisiti di qualità per i giochi su schermi di grandi dimensioni.
Aurash Mahbod • Tempo di lettura: 4 min
Ricevi gli ultimi approfondimenti sullo sviluppo Android direttamente nella tua casella di posta ogni settimana.