Wyświetlanie i pobieranie elementów multimedialnych

Gdy użytkownik wybierze elementy multimedialne za pomocą interfejsu Picker API, możesz pobrać informacje o tych elementach i uzyskać do nich dostęp. W tym przewodniku opisujemy proces wyświetlania i pobierania elementów multimedialnych.

Zanim rozpoczniesz

Wyświetl listę wybranych elementów multimedialnych

  1. Użyj punktu końcowego mediaItems.list: wyślij żądanie GET do adresu https://photospicker.googleapis.com/v1/mediaItems, podając parametr zapytania sessionId.

  2. Obsługa stronowania (w razie potrzeby):

    Jeśli użytkownik wybierze dużą liczbę elementów, odpowiedź może być podzielona na strony. Aby pobrać kolejne strony wyników, użyj w odpowiedzi parametru nextPageToken.

  3. Przetwarzanie elementów multimedialnych: odpowiedź będzie zawierać tablicę obiektów PickedMediaItem, z których każdy reprezentuje wybrany element multimedialny. Te obiekty zawierają ważne informacje, takie jak:

    • id: unikalny identyfikator elementu multimedialnego.
    • baseUrl: podstawowy adres URL, na podstawie którego możesz tworzyć adresy URL umożliwiające dostęp do treści elementu multimedialnego w różnych rozdzielczościach.
    • mimeType: typ MIME elementu multimedialnego (np. image/jpeg, video/mp4).

Pobieranie wybranych elementów multimedialnych

Aby autoryzować żądania, musisz mieć prawidłowy token dostępu OAuth 2.0 z zakresem https://www.googleapis.com/auth/photospicker.mediaitems.readonly.

  • Utwórz adres URL treści: użyj obiektu PickedMediaItem, aby utworzyć adres baseUrl. Dodaj rozdzielczość lub format pliku do baseUrl. Więcej informacji znajdziesz w sekcji poświęconej adresom URL podstawowym.

  • Pobieranie treści: wyślij żądanie GET do podstawowego adresu URL zasobu multimedialnego. Odpowiedź będzie zawierać bajty elementu multimedialnego (obrazu lub filmu). Dostępnych jest kilka różnych opcji podstawowego adresu URL.

Podstawowe URL-e

Adresy URL podstawowe w interfejsach API Zdjęć Google zapewniają dostęp do surowych bajtów elementów multimedialnych, co umożliwia aplikacji ich pobieranie i wyświetlanie. Te adresy URL są uwzględniane w odpowiedziach podczas wyświetlania listy albumów (interfejs Library API) lub uzyskiwania dostępu do elementów multimedialnych (interfejsy Library API i Picker API). Pamiętaj, że do prawidłowego działania adresy URL podstawowe wymagają dodatkowych parametrów.

W przypadku interfejsu Picker API:

Wszystkie obiekty PickedMediaItem.mediaFile zawierają element baseUrl.

Adresy URL podstawowe pozostają aktywne przez 60 minut, ale mogą wygasnąć wcześniej, jeśli użytkownik cofnie uprawnienia aplikacji w ustawieniach konta Google.

W przypadku Library API:

Adresy URL podstawowe pozostają aktywne przez 60 minut.

Różne podstawowe adresy URL:

  • baseUrl: bezpośredni dostęp do zdjęcia, miniatury filmu lub pobranie filmu w formacie binarnym.
  • coverPhotoBaseUrl: bezpośredni dostęp do zdjęcia okładki albumu.
  • profilePictureBaseUrl: bezpośredni dostęp do zdjęcia profilowego właściciela mediaItem.

Podstawowe adresy URL obrazów

Oto lista opcji, których możesz używać w przypadku adresów URL bazowych obrazów:

Parametr
w, h

Opis

Szerokość w i wysokość h.

Aby uzyskać dostęp do elementu multimedialnego z obrazem, np. zdjęcia lub miniatury filmu, musisz określić wymiary, które mają być wyświetlane w aplikacji (aby obraz mógł zostać przeskalowany do tych wymiarów przy zachowaniu współczynnika proporcji). Aby to zrobić, połącz podstawowy adres URL z wymiary, których potrzebujesz, jak pokazano w przykładach.

Przykłady:

base-url=wmax-width-hmax-height

Oto przykład wyświetlania elementu multimedialnego o szerokości nieprzekraczającej 2048 pikseli i wysokości nieprzekraczającej 1024 pikseli:

https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024
c

Opis

Parametr crop, c.

Jeśli chcesz przyciąć obraz do określonych przez siebie wymiarów, połącz podstawowy adres URL z opcjonalnym parametrem -c oraz obowiązkowymi parametrami w i h.

Rozmiar (w pikselach) powinien mieścić się w zakresie [1, 16383]. Jeśli szerokość lub wysokość obrazu przekracza wymagany rozmiar, obraz jest zmniejszany i przycinany (przy zachowaniu współczynnika proporcji).

Przykłady:

base-url=wmax-width-hmax-height-c

W tym przykładzie aplikacja wyświetla element multimedialny o wymiarach dokładnie 256 × 256 pikseli, np. miniaturę:

https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c
d

Opis

Parametr download, d.

Jeśli chcesz pobrać obraz, zachowując wszystkie metadane Exif (z wyjątkiem metadanych lokalizacji), połącz podstawowy adres URL z parametrem d.

Przykłady:

base-url=d

W tym przykładzie aplikacja pobiera obraz ze wszystkimi metadanymi oprócz metadanych lokalizacji:

https://lh3.googleusercontent.com/p/Az....XabC=d

Podstawowe adresy URL filmów

Oto lista opcji, których możesz używać w przypadku adresów URL filmów:

Parametr
dv

Opis

Aby uzyskać dostęp do bajtów filmu mediaItem, połącz parametr baseUrl z parametrem dv pobierania filmu.

Parametr dv umożliwia żądanie transkodowanej wersji oryginalnego filmu w wysokiej jakości. Parametr jest niezgodny z parametrami w i h.

Pobieranie adresów URL do pobrania filmów może potrwać do kilku sekund.

Przed użyciem tego parametru sprawdź, czy pole mediaMetadata.status elementów multimediów ma wartość READY. Jeśli jednak Twój element multimedialny nie został w pełni przetworzony, może pojawić się błąd.

Przykłady:

base-url=dv

Ten przykład pokazuje, jak pobrać bajty filmu:

https://lh3.googleusercontent.com/p/AF....BsdZ=dv
w, h, c i d

Opis

Aby uzyskać dostęp do miniatury filmu, użyj dowolnego z parametrów adresu URL podstawowego obrazu.

Domyślnie wszystkie miniatury filmów zawierają nakładkę z przyciskiem odtwarzania. Aby usunąć nakładkę, użyj parametru -no.

Przykłady:

Przykłady znajdziesz w tabeli adresów URL obrazów podstawowych.
no

Opis

Parametr no umożliwiający usunięcie nakładki z miniaturą.

Jeśli chcesz pobrać miniaturę filmu bez nakładki przycisku odtwarzania, połącz podstawowy adres URL z parametrem no.

Parametr no musi być używany z co najmniej jednym z parametrów adresu URL bazowego obrazu.

Przykłady:

base-url=wmax-width-hmax-height-no

W tym przykładzie miniatura filmu ma dokładnie 1280 pikseli szerokości i 720 pikseli wysokości oraz nie zawiera nałożonego przycisku odtwarzania:

https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no

Adresy URL zdjęć ruchomych

Zdjęcia ruchome zawierają zarówno elementy zdjęć, jak i filmów. W przypadku żądań zdjęć w ruchu baseUrl możesz używać parametrów z adresów URL podstawowych obrazu lub adresów URL podstawowych filmu.

Parametr
dv

Opis

Aby pobrać element wideo z multimediów z użyciem zdjęcia w ruchu, użyj parametru dv w taki sam sposób jak w przypadku adresów URL filmów podstawowych.
w, h, c i d

Opis

Aby pobrać element zdjęcia z multimediów z użyciem zdjęcia wideo, użyj formatu adresów URL bazowych zdjęć.