Ürün Haberleri

Yerleşik Fotoğraf Seçici

Okuma süresi: 8 dk.

Yerleşik Fotoğraf Seçici: Uygulamanızda fotoğraf ve videoları gizli bir şekilde istemenin daha sorunsuz bir yolu

photopicker.png

Android fotoğraf seçiciyi kullanmanın heyecan verici yeni bir yoluyla uygulamanızın kullanıcı deneyimini iyileştirmeye hazırlanın. Yeni yerleşik fotoğraf seçici, kullanıcıların doğrudan uygulamanızın arayüzünden fotoğraf ve video seçebileceği, gizlilik odaklı ve sorunsuz bir yöntem sunar. Artık uygulamanız, doğrudan uygulama deneyiminize entegre edilmiş bulut içeriğine erişim de dahil olmak üzere fotoğraf seçiciyle sunulan tüm avantajlardan yararlanabilir.

Neden yerleştirilmiş?

Birçok uygulamanın, fotoğraf veya video seçerken kullanıcılara son derece entegre ve sorunsuz bir deneyim sunmak istediğinin farkındayız. Yerleşik fotoğraf seçici, tam olarak bu amaçla tasarlanmıştır. Kullanıcılar uygulamanızdan ayrılmadan son fotoğraflarına hızlıca erişebilir.Ayrıca, favoriler, albümler ve arama işlevi de dahil olmak üzere tercih ettikleri bulut medya sağlayıcısındaki (ör. Google Fotoğraflar) tüm kitaplıklarını keşfedebilirler. Bu sayede kullanıcıların uygulamalar arasında geçiş yapması veya istedikleri fotoğrafın yerel olarak mı yoksa bulutta mı depolandığı konusunda endişelenmesi gerekmez.

Sorunsuz entegrasyon, gelişmiş gizlilik

Yerleşik fotoğraf seçici sayesinde uygulamanızın, kullanıcı bir öğe seçene kadar kullanıcının fotoğraflarına veya videolarına erişmesi gerekmez. Bu sayede kullanıcılarınız daha fazla gizlilik ve daha sorunsuz bir deneyim elde eder. Ayrıca, yerleşik fotoğraf seçici, kullanıcılara bulut tabanlı medya kitaplıklarının tamamına erişim imkanı sunarken standart fotoğraf izni yalnızca yerel dosyalarla sınırlıdır.

Google Mesajlar'daki yerleşik fotoğraf seçici

Google Mesajlar, yerleşik fotoğraf seçicinin gücünü gösterir. Bu özelliği nasıl entegre ettiklerini aşağıda görebilirsiniz:

  • Sezgisel yerleşim: Fotoğraf seçici, kamera düğmesinin hemen altında yer alır. Böylece kullanıcılar yeni bir fotoğraf çekmek veya mevcut bir fotoğrafı seçmek arasında net bir tercih yapabilir.
  • Dinamik önizleme: Kullanıcı bir fotoğrafa dokunduktan hemen sonra büyük bir önizleme görür. Böylece seçimini kolayca onaylayabilir. Fotoğrafın seçimini kaldırdıklarında önizleme kaybolur. Böylece deneyim temiz ve düzenli kalır.
  • Daha fazla içerik için genişletme: İlk görünüm basitleştirilerek son fotoğraflara kolay erişim sağlanır. Ancak kullanıcılar, fotoğraf seçiciyi kolayca genişleterek Google Fotoğraflar'daki bulut içerikleri de dahil olmak üzere kitaplıklarındaki tüm fotoğraf ve videoları inceleyip bunlar arasından seçim yapabilir.
  • Kullanıcı tercihlerine saygı duyma: Yerleşik fotoğraf seçici, yalnızca kullanıcının seçtiği belirli fotoğraf veya videolara erişim izni verir. Bu sayede kullanıcılar, fotoğraf ve video izinlerini istemeyi tamamen bırakabilir. Bu sayede Mesajlar'ın, kullanıcıların fotoğraf ve videolara yalnızca sınırlı erişim izni verdiği durumları işlemesi de gerekmez.
gif1.gif
gif2.gif

Uygulama

Fotoğraf Seçici Jetpack kitaplığı sayesinde yerleşik fotoğraf seçiciyi entegre etmek kolaydır.  

Jetpack Compose

Öncelikle Jetpack Fotoğraf Seçici kitaplığını bağımlılık olarak ekleyin.

implementation("androidx.photopicker:photopicker-compose:1.0.0-alpha01")

EmbeddedPhotoPicker composable işlevi, yerleştirilmiş fotoğraf seçici kullanıcı arayüzünü doğrudan Compose ekranınıza eklemenizi sağlayan bir mekanizma sunar. Bu composable, yerleştirilmiş fotoğraf seçici kullanıcı arayüzünü barındıran bir SurfaceView oluşturur. EmbeddedPhotoPicker hizmetiyle bağlantıyı yönetir, kullanıcı etkileşimlerini işler ve seçilen medya URI'lerini çağıran uygulamaya iletir.  

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

Görüntüleme sayısı

Öncelikle Jetpack Fotoğraf Seçici kitaplığını bağımlılık olarak ekleyin.

implementation("androidx.photopicker:photopicker:1.0.0-alpha01")

Yerleşik fotoğraf seçiciyi eklemek için düzen dosyanıza bir giriş eklemeniz gerekir.  

<view class="androidx.photopicker.EmbeddedPhotoPickerView"
    android:id="@+id/photopicker"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Ardından etkinliğinizde/parçanızda başlatın.

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

Yerleştirilmiş seçiciyle etkileşim kurmak için farklı EmbeddedPhotoPickerSession yöntemlerini çağırabilirsiniz.

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

Yerleşik fotoğraf seçici deneyiminin, SDK Extensions 15 ve sonraki sürümlerin yüklü olduğu Android 14 (API düzeyi 34) veya sonraki sürümleri çalıştıran cihazlarda kullanılabildiğini unutmayın. Fotoğraf seçicinin kullanılabildiği cihazlar hakkında daha fazla bilgi edinin.

Sistem, kullanıcı gizliliğini ve güvenliğini artırmak için yerleşik fotoğraf seçiciyi, çizim veya yer paylaşımı yapılmasını engelleyecek şekilde oluşturur. Bu bilinçli tasarım tercihi, kullanıcı deneyiminizin fotoğraf seçicinin görüntüleme alanını, reklam banner'ı planlarken yaptığınız gibi ayrı ve özel bir öğe olarak değerlendirmesi gerektiği anlamına gelir.

Geri bildiriminiz veya öneriniz varsa Sorun İzleyicimize destek kaydı gönderin.

Okumaya devam et