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 podziału na strony (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 elementu 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

Podstawowe adresy URL w interfejsach API Zdjęć Google zapewniają dostęp do nieprzetworzonych bajtów elementów multimedialnych, dzięki czemu aplikacja może je pobrać lub wyświetlić. 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 prawidłowe działanie adresów URL podstawowych wymaga 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 interfejsu Library API:

Podstawowe adresy URL są 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 na okładkę 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

Parametry szerokości, w i wysokości oraz h.

Aby uzyskać dostęp do elementu multimediów 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, złą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 dokładnej szerokości 256 pikseli i wysokości 256 pikseli, na przykład miniaturę:

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

Opis

Parametr download, d.

Jeśli chcesz pobrać obraz z zachowaniem wszystkich metadanych Exif oprócz metadanych lokalizacji, połącz podstawowy adres URL za pomocą parametru 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 żąda wysokiej jakości transkodowanej wersji oryginalnego filmu. 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ć liczbę bajtów 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 podstawowego adresu URL 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 bazowych adresów URL obrazów.
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 żądaniach baseUrl zdjęć ruchomych możesz używać parametrów z podstawowych adresów URL obrazów lub podstawowych adresów URL filmów.

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 elementu multimedialnego z ruchomym zdjęciem, użyj formatu adresów URL bazowych zdjęć.