इस गाइड से, आपको मीडिया आइटम चुनते समय उपयोगकर्ता के अनुभव को समझने में मदद मिलती है.
Picker API के स्टैंडर्ड फ़्लो के मुताबिक, ऐप्लिकेशन में pickerUri
दिखने के बाद और mediaItemsSet
के 'सही' के तौर पर दिखने के लिए, ऐप्लिकेशन के पोलिंग के दौरान आइटम चुना जाता है.
अपने डिवाइस पर इनमें से कोई भी चरण देखने के लिए, हमारा सैंपल ऐप्लिकेशन देखें.
चुनने का सेशन शुरू करना
सेशन बनाने के बाद, आपका ऐप्लिकेशन आपके उपयोगकर्ताओं को pickerUri
दिखाएगा.
pickerUri
को क्यूआर कोड और यूआरएल, दोनों के तौर पर दिखाएं.pickerUri
के साथ उपयोगी टेक्स्ट दें. उदाहरण के लिए, "Google Photos खोलने और अपने आइटम चुनने के लिए, यह कोड स्कैन करें.".- जिन डिवाइसों पर इनपुट की सुविधाएं सीमित होती हैं, जैसे कि कीऑस्क, टैबलेट, स्मार्ट टीवी वगैरह के लिए, टेक्स्ट के साइज़ और क्यूआर कोड की चौड़ाई के बारे में, हार्डवेयर बनाने वाली कंपनी के सुझाव देखें.
फ़ोटो खोजना और चुनना
जब कोई उपयोगकर्ता pickerUri
को ऐक्सेस करता है, तो उसे Google Photos ऐप्लिकेशन में फ़ोटो चुनने वाले पेज पर ले जाया जाता है.
इस पेज पर, आपके उपयोगकर्ता की Google Photos लाइब्रेरी में मौजूद हाल ही की फ़ोटो हमेशा दिखेंगी. एल्बम, पसंदीदा फ़ोटो, और फ़ोटो की अन्य सामान्य कैटगरी, सीधे तौर पर नहीं दिखती हैं. उपयोगकर्ता, कीवर्ड, तारीखों, जगहों, और एल्बम के टाइटल जैसी कई चीज़ों का इस्तेमाल करके फ़ोटो खोज सकते हैं.
अगर आपका ऐप्लिकेशन, एल्बम, तारीखों या फ़ोटो की अन्य सामान्य कैटगरी का इस्तेमाल करता है, तो Google Photos ऐप्लिकेशन में आने के बाद, उपयोगकर्ताओं को खोज करने के लिए कहें. इससे उन्हें मदद मिलेगी.
उदाहरण के लिए, अगर आपको अपने उपयोगकर्ताओं से कोई खास एल्बम शेयर करने के लिए कहना है, तो उसी पेज पर यह टेक्स्ट शामिल किया जा सकता है जिस पर उपयोगकर्ता Google Photos से कनेक्ट करते हैं: "Google Photos से कनेक्ट करें. इसके बाद, वह एल्बम खोजें जिसे आपको शेयर करना है."
खोजने के बाद, उपयोगकर्ता नतीजों में से एक या उससे ज़्यादा आइटम चुन सकता है.
'हो गया' स्क्रीन
जब उपयोगकर्ता "हो गया" बटन दबाकर, आइटम चुन लेता है, तो उसे "हो गया" स्क्रीन दिखेगी.
अपने उपयोगकर्ताओं को ज़्यादा फ़ोटो चुनने का विकल्प देने के लिए, अपने ऐप्लिकेशन में pickerUri
को फिर से दिखाएं. अगर उपयोगकर्ता pickerUri
को दूसरी बार ऐक्सेस करते हैं, तो एक नया फ़ोटो चुनने का सेशन बन जाएगा.