प्रॉडक्ट से जुड़ी खबरें

एम्बेड किया गया फ़ोटो पिकर

आठ मिनट में पढ़ें

एंबेड किया गया फ़ोटो पिकर: अपने ऐप्लिकेशन में फ़ोटो और वीडियो का अनुरोध करने का ज़्यादा आसान तरीका

photopicker.png

Android फ़ोटो पिकर को इस्तेमाल करने के नए और दिलचस्प तरीके से, अपने ऐप्लिकेशन का इस्तेमाल करने वाले लोगों के अनुभव को बेहतर बनाएं! नया एंबेड किया गया फ़ोटो पिकर, उपयोगकर्ताओं को आपकी ऐप्लिकेशन के इंटरफ़ेस में ही फ़ोटो और वीडियो चुनने का आसान और निजता को ध्यान में रखकर बनाया गया तरीका उपलब्ध कराता है. अब आपका ऐप्लिकेशन, फ़ोटो पिकर के साथ उपलब्ध सभी फ़ायदों को पा सकता है. इनमें क्लाउड कॉन्टेंट को ऐक्सेस करने की सुविधा भी शामिल है. यह सुविधा, सीधे तौर पर आपके ऐप्लिकेशन के अनुभव में इंटिग्रेट की जाती है.

वीडियो को क्यों एम्बेड करना चाहिए?

हम समझते हैं कि कई ऐप्लिकेशन, फ़ोटो या वीडियो चुनते समय उपयोगकर्ताओं को बेहतर और आसान अनुभव देना चाहते हैं. एंबेड किया गया फ़ोटो पिकर, इसी काम के लिए बनाया गया है. इसकी मदद से, उपयोगकर्ता आपके ऐप्लिकेशन से बाहर निकले बिना, हाल ही की फ़ोटो को तुरंत ऐक्सेस कर सकते हैं.वे अपनी पूरी लाइब्रेरी को क्लाउड मीडिया सेवा देने वाली अपनी पसंदीदा कंपनी (जैसे, Google Photos) में भी एक्सप्लोर कर सकते हैं. इसमें पसंदीदा फ़ोटो, एल्बम, और खोजने की सुविधा शामिल है. इससे उपयोगकर्ताओं को ऐप्लिकेशन के बीच स्विच करने या यह चिंता करने की ज़रूरत नहीं पड़ती कि उन्हें जिस फ़ोटो की ज़रूरत है वह लोकल स्टोरेज में सेव है या क्लाउड में.

आसान इंटिग्रेशन, बेहतर निजता

एंबेड किए गए फ़ोटो पिकर की मदद से, आपके ऐप्लिकेशन को उपयोगकर्ता की फ़ोटो या वीडियो का ऐक्सेस तब तक नहीं मिलता, जब तक वह कोई आइटम नहीं चुनता. इसका मतलब है कि आपके उपयोगकर्ताओं को बेहतर निजता मिलेगी और उन्हें बेहतर अनुभव मिलेगा. इसके अलावा, एंबेड किए गए फ़ोटो पिकर की मदद से, उपयोगकर्ताओं को क्लाउड पर मौजूद अपनी पूरी मीडिया लाइब्रेरी का ऐक्सेस मिलता है. वहीं, फ़ोटो के लिए स्टैंडर्ड अनुमति सिर्फ़ लोकल फ़ाइलों तक सीमित होती है.

Google Messages में फ़ोटो चुनने की सुविधा

Google Messages में, एंबेड किए गए फ़ोटो पिकर की सुविधाओं के बारे में बताया गया है. उन्होंने इसे इस तरह इंटिग्रेट किया है:

  • आसानी से इस्तेमाल किया जा सकता है: फ़ोटो पिकर, कैमरा बटन के ठीक नीचे होता है. इससे लोगों को नई फ़ोटो कैप्चर करने या मौजूदा फ़ोटो चुनने का विकल्प आसानी से मिल जाता है.
  • डाइनैमिक झलक: जब कोई व्यक्ति किसी फ़ोटो पर टैप करता है, तो उसे तुरंत बड़ी झलक दिखती है. इससे उसे अपने चुने गए विकल्प की पुष्टि करने में आसानी होती है. अगर वे फ़ोटो सेलेक्ट नहीं करते हैं, तो झलक दिखनी बंद हो जाती है. इससे उन्हें साफ़-सुथरा अनुभव मिलता है.
  • ज़्यादा कॉन्टेंट देखने के लिए बड़ा करें: शुरुआती व्यू को आसान बनाया गया है, ताकि हाल ही की फ़ोटो को आसानी से ऐक्सेस किया जा सके. हालांकि, उपयोगकर्ता फ़ोटो पिकर को आसानी से बड़ा कर सकते हैं. इससे वे अपनी लाइब्रेरी में मौजूद सभी फ़ोटो और वीडियो को ब्राउज़ कर सकते हैं और उनमें से कोई भी फ़ोटो और वीडियो चुन सकते हैं. इसमें Google Photos से क्लाउड कॉन्टेंट भी शामिल है.
  • उपयोगकर्ता की पसंद का ध्यान रखना: एम्बेड किए गए फ़ोटो पिकर से, सिर्फ़ उन फ़ोटो या वीडियो का ऐक्सेस मिलता है जिन्हें उपयोगकर्ता चुनता है. इसका मतलब है कि उपयोगकर्ता, फ़ोटो और वीडियो ऐक्सेस करने की अनुमतियों के लिए अनुरोध करना पूरी तरह से बंद कर सकते हैं. इससे Messages को उन स्थितियों को मैनेज करने की ज़रूरत नहीं पड़ती है जहां लोग सिर्फ़ फ़ोटो और वीडियो का सीमित ऐक्सेस देते हैं.
gif1.gif
gif2.gif

लागू करना

Photo Picker Jetpack लाइब्रेरी की मदद से, एंबेड किए गए फ़ोटो पिकर को आसानी से इंटिग्रेट किया जा सकता है.  

Jetpack Compose

सबसे पहले, Jetpack Photo Picker लाइब्रेरी को डिपेंडेंसी के तौर पर शामिल करें.

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

EmbeddedPhotoPicker कंपोज़ेबल फ़ंक्शन, एंबेड किए गए फ़ोटो पिकर यूज़र इंटरफ़ेस को सीधे तौर पर Compose स्क्रीन में शामिल करने का तरीका उपलब्ध कराता है. इस कंपोज़ेबल से एक SurfaceView बनता है. यह एंबेड किए गए फ़ोटो पिकर यूज़र इंटरफ़ेस को होस्ट करता है. यह EmbeddedPhotoPicker सेवा से कनेक्शन मैनेज करता है, उपयोगकर्ता के इंटरैक्शन को हैंडल करता है, और चुने गए मीडिया यूआरआई को कॉलिंग ऐप्लिकेशन के साथ कम्यूनिकेट करता है.  

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

व्यू

सबसे पहले, Jetpack Photo Picker लाइब्रेरी को डिपेंडेंसी के तौर पर शामिल करें.

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

एम्बेड किए गए फ़ोटो पिकर को जोड़ने के लिए, आपको अपनी लेआउट फ़ाइल में एक एंट्री जोड़नी होगी.  

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

इसके बाद, इसे अपनी गतिविधि/फ़्रैगमेंट में शुरू करें.

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

एंबेड किए गए पिकर के साथ इंटरैक्ट करने के लिए, EmbeddedPhotoPickerSession के अलग-अलग तरीकों का इस्तेमाल किया जा सकता है.

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

यह ध्यान रखना ज़रूरी है कि एंबेड किए गए फ़ोटो पिकर की सुविधा, Android 14 (एपीआई लेवल 34) या इसके बाद के वर्शन वाले उन डिवाइसों पर उपलब्ध है जिनमें एसडीके एक्सटेंशन का वर्शन 15 या इसके बाद का है. फ़ोटो पिकर की सुविधा वाले डिवाइसों के बारे में ज़्यादा जानें.

उपयोगकर्ता की निजता और सुरक्षा को बेहतर बनाने के लिए, सिस्टम एंबेड किए गए फ़ोटो पिकर को इस तरह से रेंडर करता है कि कोई भी ड्राइंग या ओवरलेइंग न हो. इस डिज़ाइन को जान-बूझकर चुना गया है. इसका मतलब है कि आपके यूज़र एक्सपीरियंस (यूएक्स) में, फ़ोटो पिकर के डिसप्ले एरिया को एक अलग और खास एलिमेंट के तौर पर शामिल किया जाना चाहिए. ठीक उसी तरह जैसे किसी विज्ञापन बैनर के लिए प्लान किया जाता है.

अगर आपको कोई सुझाव देना है या शिकायत करनी है, तो हमारे समस्या ट्रैकर में टिकट सबमिट करें.

इसे लिखा है:

पढ़ना जारी रखें