"أداة اختيار الصور المضمّنة": طريقة أكثر سلاسة لطلب الصور والفيديوهات بشكل خاص في تطبيقك
استعدّ لتحسين تجربة المستخدم في تطبيقك من خلال طريقة جديدة ومثيرة لاستخدام "أداة اختيار الصور على Android". توفّر "أداة اختيار الصور المضمّنة" الجديدة طريقة سلسة تركز على الخصوصية ليتمكّن المستخدمون من اختيار الصور والفيديوهات مباشرةً من واجهة تطبيقك. يمكن لتطبيقك الآن الاستفادة من جميع المزايا نفسها التي توفّرها "أداة اختيار الصور"، بما في ذلك الوصول إلى المحتوى على السحابة الإلكترونية، المدمَج مباشرةً في تجربة تطبيقك.
لماذا يجب استخدام "أداة اختيار الصور المضمّنة"؟
ندرك أنّ العديد من التطبيقات تريد توفير تجربة متكاملة وسلسة للمستخدمين عند اختيار الصور أو الفيديوهات. تم تصميم "أداة اختيار الصور المضمّنة" لتحقيق ذلك، ما يتيح للمستخدمين الوصول بسرعة إلى صورهم الحديثة بدون مغادرة تطبيقك. ويمكنهم أيضًا استكشاف مكتبتهم الكاملة في موفّر الوسائط المفضّل لديهم على السحابة الإلكترونية (مثل "صور Google")، بما في ذلك الصور المفضّلة والألبومات ووظيفة البحث. ويزيل ذلك حاجة المستخدمين إلى التبديل بين التطبيقات أو القلق بشأن ما إذا كانت الصورة التي يريدونها مخزّنة محليًا أو على السحابة الإلكترونية.
التكامل السلس والخصوصية المحسّنة
باستخدام "أداة اختيار الصور المضمّنة"، لا يحتاج تطبيقك إلى الوصول إلى صور المستخدم أو فيديوهاته إلى أن يختار المستخدم شيئًا ما. ويعني ذلك توفير خصوصية أكبر للمستخدمين وتجربة أكثر سلاسة. بالإضافة إلى ذلك، تمنح "أداة اختيار الصور المضمّنة" المستخدمين إمكانية الوصول إلى مكتبة الوسائط الكاملة المستندة إلى السحابة الإلكترونية، بينما يقتصر إذن الوصول إلى الصور العادي على الملفات المحلية فقط.
"أداة اختيار الصور المضمّنة" في "رسائل Google"
تعرض "رسائل Google" قوة "أداة اختيار الصور المضمّنة". إليك كيفية دمجها:
- الموضع السهل: تظهر "أداة اختيار الصور" أسفل زر الكاميرا مباشرةً، ما يمنح المستخدمين خيارًا واضحًا بين التقاط صورة جديدة أو اختيار صورة حالية.
- المعاينة الديناميكية: بعد أن ينقر المستخدم على صورة، تظهر له معاينة كبيرة، ما يسهّل عليه تأكيد اختياره. إذا ألغى اختيار الصورة، تختفي المعاينة، ما يحافظ على التجربة نظيفة وغير مزدحمة.
- التوسيع لعرض المزيد من المحتوى: يتم تبسيط العرض الأولي، ما يتيح الوصول بسهولة إلى الصور الحديثة. ومع ذلك، يمكن للمستخدمين توسيع "أداة اختيار الصور" بسهولة لتصفُّح جميع الصور والفيديوهات في مكتبتهم واختيارها، بما في ذلك المحتوى على السحابة الإلكترونية من "صور Google".
- احترام خيارات المستخدم: لا تمنح "أداة اختيار الصور المضمّنة" إذن الوصول إلا إلى الصور أو الفيديوهات المحدّدة، ما يعني أنّه يمكن للمستخدمين إيقاف طلب أذونات الوصول إلى الصور والفيديوهات تمامًا. ويوفّر ذلك أيضًا على "رسائل Google" الحاجة إلى التعامل مع الحالات التي يمنح فيها المستخدمون إذن وصول محدودًا فقط إلى الصور والفيديوهات.
التنفيذ
أصبح دمج "أداة اختيار الصور المضمّنة" سهلاً باستخدام مكتبة Photo Picker Jetpack.
Jetpack Compose
أولاً، أضِف مكتبة Jetpack Photo Picker كإحدى التبعيات.
implementation("androidx.photopicker:photopicker-compose:1.0.0-alpha01")
توفّر الدالة البرمجية القابلة للإنشاء EmbeddedPhotoPicker آلية لتضمين واجهة مستخدم "أداة اختيار الصور المضمّنة" مباشرةً ضمن شاشة Compose. تنشئ هذه الدالة البرمجية القابلة للإنشاء SurfaceView تستضيف واجهة مستخدم "أداة اختيار الصور المضمّنة". وتدير هذه الدالة الاتصال بخدمة EmbeddedPhotoPicker، وتتعامل مع تفاعلات المستخدم، وتُرسِل معرّفات الموارد المنتظمة (URI) للوسائط المحدّدة إلى التطبيق الذي طلبها.
@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)
من المهم ملاحظة أنّ تجربة "أداة اختيار الصور المضمّنة" متاحة للمستخدمين الذين يعملون بالإصدار 14 من Android (المستوى 34 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث مع حزمة SDK Extensions 15 أو الإصدارات الأحدث. مزيد من المعلومات عن مدى توفّر "أداة اختيار الصور" على الأجهزة.
لتعزيز خصوصية المستخدم وأمانه، يعرض النظام "أداة اختيار الصور المضمّنة" بطريقة تمنع أي رسم أو تراكب. يعني خيار التصميم المتعمد هذا أنّه يجب أن تراعي تجربة المستخدم منطقة عرض "أداة اختيار الصور" كعنصر مميز ومخصّص، تمامًا كما تخطط لبانر إعلاني.
إذا كان لديك أي ملاحظات أو اقتراحات، يُرجى إرسال تذاكر إلى أداة تتبُّع المشاكل.
-
أخبار المنتجاتتظل الخصوصية وعناصر التحكّم الخاصة بالمستخدمين في صميم تجربة Android. تمامًا كما جعلت "أداة اختيار الصور" مشاركة الوسائط آمنة وسهلة التنفيذ، فإنّنا نوفّر الآن المستوى نفسه من الخصوصية والبساطة وتجربة المستخدم الرائعة عند اختيار جهات الاتصال.
Roxanna Aliabadi Walker • مدة القراءة: 4 دقائق -
أخبار المنتجاتإنّ توفير تجربة آمنة على الإنترنت وحماية المستخدمين من الأذى من أهم أولوياتنا في Google Play.
Paul Feng • مدة القراءة: دقيقتان -
أخبار المنتجاتنحتفل اليوم رسميًا بمرور خمسة أعوام على إطلاق Jetpack Compose 1.0. من الإصدار 1.0 الذي تم الإعلان عنه في 28 يوليو 2021 إلى أحدث إصدار 1.11، شهدنا تطور واجهات برمجة التطبيقات بشكل كبير على مر السنين، ونحن نأخذ لحظة للاحتفال.
Rebecca Franks, Nick Butcher, Loryn Hairston • مدة القراءة: 5 دقائق
يمكنك تلقّي أحدث الإحصاءات حول تطوير تطبيقات Android في بريدك الوارد أسبوعيًا.