اختيار الصور: ما يظهر للمستخدمين
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يساعدك هذا الدليل في فهم تجربة المستخدم عند اختيار عناصر الوسائط.
بعد اتّباع مسار Picker API العادي،
يبدأ الاختيار بعد أن يعرض تطبيقك pickerUri
،
وأثناء أن يطلب تطبيقك mediaItemsSet
لعرض القيمة "صحيح".
للاطّلاع على أي من هذه الخطوات على جهازك، يمكنك تجربة تطبيقنا النموذجي.
بدء جلسة الاختيار
بعد إنشاء جلسة بنجاح، يجب أن يعرض تطبيقك pickerUri
للمستخدمين.
- اعرض
pickerUri
كرمز استجابة سريعة وعنوان URL.
- قدِّم نصًا مفيدًا بجانب
pickerUri
. على سبيل المثال، "امسح هذا الرمز ضوئيًا
لفتح صور Google واختيار الملفات".
- بالنسبة إلى الأجهزة التي تتضمّن إمكانات إدخال محدودة (مثل أكشاك البيع والأجهزة اللوحية وأجهزة التلفزيون الذكية)، يُرجى مراجعة توصيات الشركة المصنّعة للأجهزة بشأن حجم النص وعرض رمز الاستجابة السريعة.
البحث عن الصور واختيارها
عندما يصل المستخدم إلى pickerUri
، يتم توجيهه إلى صفحة اختيار الصور
داخل تطبيق "صور Google".
ستعرض هذه الصفحة دائمًا أحدث الصور من مكتبة "صور Google" الخاصة بالمستخدم. لا يتم عرض الألبومات والصور المفضّلة وفئات الصور الشائعة الأخرى مباشرةً. يمكن للمستخدمين البحث عن الصور باستخدام معايير مختلفة، مثل الكلمات الرئيسية والتواريخ والمواقع الجغرافية وعناوين الألبومات.
إذا كان تطبيقك يستخدم الألبومات أو التواريخ أو فئات الصور الشائعة الأخرى، يمكنك مساعدة المستخدمين من خلال مطالبتهم بالبحث فور دخولهم إلى تطبيق "صور Google".
على سبيل المثال، إذا كنت تطلب من المستخدمين مشاركة ألبوم معيّن، يمكنك تضمين النص التالي في الصفحة نفسها التي يربط المستخدمون من خلالها حساباتهم بخدمة "صور Google": "اربط حسابك بخدمة "صور Google"، ثم ابحث عن الألبوم الذي تريد مشاركته".
بعد البحث، يمكن للمستخدم اختيار عنصر واحد أو أكثر من النتائج.
شاشة "تم"
بعد أن ينقر المستخدم على الزر "تم" ويكمل عملية الاختيار، ستظهر له شاشة "تم". سيؤدي ذلك إلى إنهاء جلسة الاختيار ولن يعمل pickerUri
الحالي بعد ذلك.
لتوفير خيار تحديد المزيد من الصور للمستخدمين، أنشئ جلسة اختيار جديدة واعرض pickerUri
مرة أخرى في تطبيقك.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-18 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-18 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide explains the user experience within the Google Photos app when selecting media items using the Picker API.\u003c/p\u003e\n"],["\u003cp\u003eUsers initiate the process by accessing the \u003ccode\u003epickerUri\u003c/code\u003e displayed in your app, which opens a photo selection page within Google Photos.\u003c/p\u003e\n"],["\u003cp\u003eUsers can search and select photos from their Google Photos library using various criteria before confirming their choices.\u003c/p\u003e\n"],["\u003cp\u003eAfter selection, users are presented with a "Done" screen, and your app can re-display the \u003ccode\u003epickerUri\u003c/code\u003e to allow for further selections in a new session.\u003c/p\u003e\n"]]],["The core process involves displaying a `pickerUri` (QR code and URL) to users, prompting them to access it. This takes them to Google Photos for photo selection. Users can search using keywords, dates, or locations to find specific photos. Upon selection and pressing \"Done,\" the process ends. Apps can offer to display the `pickerUri` again to initiate a new picking session, to select more items. While the app is polling for the media selection the process has begun.\n"],null,[]]