Ten przewodnik pomoże Ci zrozumieć, jak użytkownicy wybierają treści multimedialne.
Postępując zgodnie ze standardowym schematem interfejsu Picker API, zacznij wybierać po wyświetleniu przez aplikację pickerUri i podczas sprawdzania przez aplikację, czy mediaItemsSet ma zwrócić wartość true.
Aby zobaczyć te czynności na swoim urządzeniu, otwórz naszą przykładową aplikację.
Rozpocznij sesję wybierania
Po utworzeniu sesji aplikacja powinna wyświetlić użytkownikom pickerUri.
- Wyświetl
pickerUrijako kod QR i adres URL. - Podać przydatny tekst obok
pickerUri. Możesz na przykład napisać: „Skanuj ten kod, aby otworzyć Zdjęcia Google i wybrać swoje elementy”. - W przypadku urządzeń o ograniczonych możliwościach wprowadzania danych (np. kiosków, tabletów, telewizorów smart TV) zapoznaj się z zaleceniami producenta sprzętu dotyczącymi rozmiaru tekstu i szerokości kodu QR.
Wyszukiwanie i wybieranie zdjęć
Gdy użytkownik kliknie pickerUri, przejdzie do strony wyboru zdjęć w aplikacji Zdjęcia Google.
Na tej stronie zawsze będą wyświetlane najnowsze zdjęcia z biblioteki Zdjęć Google użytkownika. Albumy, ulubione i inne popularne kategorie zdjęć nie są wyświetlane bezpośrednio. Użytkownicy mogą wyszukiwać zdjęcia według różnych kryteriów, takich jak słowa kluczowe, daty, lokalizacje i nazwy albumów.
Jeśli Twoja aplikacja korzysta z albumów, dat lub innych popularnych kategorii zdjęć, ułatwij użytkownikom wyszukiwanie, wyświetlając im odpowiedni komunikat po otwarciu Zdjęć Google.
Jeśli na przykład chcesz, aby użytkownicy udostępnili określony album, możesz dodać ten tekst na tej samej stronie, na której użytkownicy łączą się z Zdjęciami Google: „Połącz się ze Zdjęciami Google, a potem wyszukaj album, który chcesz udostępnić”.
Po wyszukaniu użytkownik może wybrać co najmniej 1 element z wyników.
Ekran „Gotowe”
Gdy użytkownik kliknie przycisk „Gotowe” i zakończy wybieranie, zobaczy ekran „Gotowe”. Spowoduje to zakończenie sesji wybierania i uniemożliwi korzystanie z obecnego pickerUri.
Aby umożliwić użytkownikom wybranie większej liczby zdjęć, utwórz nową sesję wybierania i ponownie wyświetl pickerUri w aplikacji.