Yerleştirilmiş fotoğraf seçici

Yerleşik fotoğraf seçici, farklı bir fotoğraf seçme deneyimi sunar ve doğrudan uygulamaların kullanıcı arayüzleriyle etkileşime girmesine olanak tanır. Klasik fotoğraf seçiciye kıyasla daha gelişmiş entegrasyon ve özelleştirme seçenekleri sunar. setChildSurfacePackage yöntemi kullanılarak bir SurfaceView üzerinde oluşturulduğu için yerleştirilmemiş sürümle aynı güvenlik ve gizlilik özelliklerini korur.

Yerleşik fotoğraf seçici sayesinde kullanıcılar, istemci uygulamasında odaklarını kaybetmeden hem cihazlarından hem de bulut fotoğraf kitaplıklarından sürekli olarak fotoğraf ve video seçebilir. İstemci uygulaması etkin kalır, etkinliği devam ettirilir ve kullanıcı seçimlerine gerçek zamanlı olarak yanıt verebilir.

Yerleşik fotoğraf seçici, daha sorunsuz bir kullanıcı arayüzü entegrasyonu sunar ancak özel bir SurfaceView üzerinde oluşturulduğu için standart fotoğraf seçiciyle aynı güvenlik ve gizlilik özelliklerini korur.

Kullanılabilen cihazlar

Yerleşik fotoğraf seçici, SDK Extensions 15 veya sonraki sürümleri yüklü Android 14 (API düzeyi 34) çalıştıran cihazlarda desteklenir.

Bu özelliklere uymayan cihazlar, Google Play Hizmetleri'ni kullanarak klasik fotoğraf seçiciyi veya geri bağlanmış sürümü kullanabilir.

Jetpack kitaplığı bağımlılığı

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

// For apps using Jetpack Compose
implementation("androidx.photopicker:photopicker-compose:1.0.0-alpha01")

// For apps using Views
implementation("androidx.photopicker:photopicker:1.0.0-alpha01")

Yerleştirilmiş fotoğraf seçiciyi Jetpack Compose (önerilir) veya Görünümler'i kullanarak entegre edebilirsiniz.

Jetpack Compose entegrasyonu

EmbeddedPhotoPicker composable işlevi, yerleştirilmiş fotoğraf seçici kullanıcı arayüzünü doğrudan Jetpack Compose ekranınıza eklemenizi sağlayan bir mekanizma sunar. Bu composable, yerleşik 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, çalışması için birkaç parametreyle birlikte çağrı uygulamasına iletir:

val coroutineScope = rememberCoroutineScope()
val pickerState = rememberEmbeddedPhotoPickerState()

EmbeddedPhotoPicker(
    state = pickerState,
    onUriPermissionGranted = { uris ->
        _attachments.value += uris
    },
    onUriPermissionRevoked = { uris ->
        _attachments.value -= uris
    },
    onSelectionComplete = {
        // Hide the embedded photo picker as the user is done with the
        // photo/video selection
    },
)

Sürekli seçim

Yerleşik fotoğraf seçici, kullanıcıların seçiciyi kapatmadan fotoğraf kitaplığından öğeleri sürekli olarak seçmesine ve seçimini kaldırmasına olanak tanır. Uygulamanın kullanıcı arayüzünde seçilen ve seçimi kaldırılan öğeler, fotoğraf seçiciyle senkronize edilerek sorunsuz bir kullanıcı deneyimi sunulur.

Kullanıcının uygulamanın kullanıcı arayüzünden bir öğenin seçimini kaldırdığını yerleşik seçiciye bildirmek için pickerState üzerinden deselectUri veya deselectUris yöntemini kullanarak Uri seçimini kaldırın. Bu yöntemler çağrıldığında, yeni iptal edilen URI'lar onUriPermissionRevoked geri çağırma işlevi aracılığıyla uygulamanıza bildirilmez. Bu nedenle, uygulamanızın kullanıcı arayüzü durumunu manuel olarak güncellemeniz gerekir.

coroutineScope.launch {
    // Signal unselected media to the picker
    pickerState.deselectUris(uris)
    // Remove them from the list of selected media to be reflected in the app's UI
    _attachments.value -= uris
}

Fotoğraf seçiciyi kişiselleştirme

Yerleşik fotoğraf seçici, kişiselleştirme seçenekleri sunarak görünümünü ve davranışını uygulamanızın tasarımına ve kullanıcı deneyimine daha iyi uyum sağlayacak şekilde özelleştirmenize olanak tanır.

Vurgu rengi

Yerleşik fotoğraf seçici, varsayılan olarak kullanıcının cihaz tema seçeneklerinde uygulamalar genelinde ayarlayabileceği, sistem tarafından sağlanan dinamik renkleri kullanır. Vurgu rengi, fotoğraf seçicideki çeşitli birincil öğeler için kullanılır. Diğer tüm renkler, Android materyal kurallarına göre ayarlanır. Seçicinin vurgu rengini kişiselleştirmek için EmbeddedPhotoPickerFeatureInfo seçeneğini tanımlayın:

val info = EmbeddedPhotoPickerFeatureInfo.Builder().setAccentColor(0xFF0000).build()

EmbeddedPhotoPicker(
    embeddedPhotoPickerFeatureInfo = info,
    ...
)

Vurgu rengi ayarlanmadan	Vurgu rengiyle (zirve)	Vurgu rengiyle (genişletilmiş)

Vurgu rengi tamamen opak olmalıdır. Alfa (şeffaflık) değeri yok sayılır. Yalnızca parlaklık değeri 0,05 ile 0,9 arasında olan renklere izin verilir.

Boyutlar

Varsayılan olarak, yerleştirilmiş seçicinin boyutu sınırlı değildir ancak bunu sınırlamak için bir değiştirici belirtebilirsiniz:

EmbeddedPhotoPicker(
    modifier = Modifier.height(500.dp),
    ...
)

Sınırsız (genişletilmiş)	500 dp sınırıyla (genişletilmiş)

Görüntüleme sayısı entegrasyonu

Görünümler'i kullanarak yerleşik fotoğraf seçiciyi eklemek için düzen dosyanıza bir giriş ekleyin:

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

Ardından, etkinliğinizin onCreate yönteminde aşağıdakileri yaparak fotoğraf seçiciyi başlatın:

1. Düzenden EmbeddedPhotoPickerView referansınızı alın
2. Seçim etkinliklerini işlemek için EmbeddedPhotoPickerStateChangeListener ekleyin
3. Fotoğraf seçiciyi EmbeddedPhotoPickerFeatureInfo ile yapılandırın (vurgu rengi gibi özel ayarlar dahil)

// Keep track of the selected media
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) {
        // Keep reference to the session to notify the embedded picker of user
        // interactions on the calling app
        openSession = newSession
    }

    override fun onSessionError(throwable: Throwable) {}

    override fun onUriPermissionGranted(uris: List<Uri>) {
        // Add newly selected media to our tracked list
        _attachments += uris
    }

    override fun onUriPermissionRevoked(uris: List<Uri>) {
        // Remove newly unselected media from our tracked list
        _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)
    picker = findViewById(R.id.photopicker)

    // Attach the embedded picker event listener to update the app's UI
    picker.addEmbeddedPhotoPickerStateChangeListener(pickerListener)

    // Customize embedded picker's features: accent color, max selectable items,
    // pre-selected URIs, filter out mime types
    picker.setEmbeddedPhotoPickerFeatureInfo(
        // Set a custom accent color
        EmbeddedPhotoPickerFeatureInfo.Builder().setAccentColor(0xFF0000).build()
    )
}

Yerleşik seçiciyle etkileşim kurmak için EmbeddedPhotoPickerSession öğesinin farklı 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)