Meet Media API: krótkie wprowadzenie do klienta referencyjnego C++

Na tej stronie znajdziesz informacje o konfigurowaniu i uruchamianiu przykładu z użyciem referencyjnej implementacji klienta w C++. Aby dowiedzieć się więcej o kliencie TypeScript, zapoznaj się z przewodnikiem Szybki start dotyczącym klienta referencyjnego TypeScript.

Wymagania wstępne

Aby uruchomić ten samouczek, musisz spełnić te wymagania wstępne:

• Repozytorium GitHub zostało sklonowane.
• Projekt Google Cloud z włączonym interfejsem Google Meet REST API.
• Konto Google Workspace.

Włączanie interfejsu Meet REST API

Kompilowanie klienta C++

Implementacja w C++ jest tworzona za pomocą narzędzia Generate Ninja (GN). Więcej informacji znajdziesz w dokumentacji WebRTC.

1. Wygeneruj hasło w Git at Google i skonfiguruj Git.

2. W interfejsie wiersza poleceń zmień <samples_location> na katalog zawierający przykłady i uruchom to polecenie, które:

   • Zmienia katalog roboczy na katalog główny.
   • Tworzy w katalogu głównym katalog o nazwie src.
   • Zmienia katalog roboczy na src.
   • Klonuje https://chromium.googlesource.com/chromium/tools/depot_tools.git do katalogu src/ z gita.
   • Tymczasowo dodaje katalog ~/src/depot_tools do listy lokalizacji, w których powłoka wyszukuje polecenia wykonywalne.
   • Zmienia katalog roboczy na katalog cpp w lokalizacji przykładów.
   • Uruchamia skrypt powłoki ./build.sh.

   cd ~
   mkdir src
   cd src
   git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
   export PATH=~/src/depot_tools:$PATH
   cd <samples_location>/cpp
   sh ./build.sh

Generowanie tokenów OAuth

Aby połączyć się z interfejsem Meet Media API, aplikacja musi używać OAuth do generowania tokenów dostępu. Więcej informacji o uzyskiwaniu dostępu do interfejsów API Google za pomocą OAuth znajdziesz w artykule Używanie protokołu OAuth 2.0 na potrzeby dostępu do interfejsów API Google.

Do generowania tokenów możesz użyć OAuth 2.0 Playground. Podczas korzystania z piaskownicy pamiętaj, aby:

• Użyj identyfikatora klienta i tajnych danych logowania z projektu w chmurze.
• Poproś o odpowiednie zakresy.
• Zaloguj się na konto Google i zaakceptuj dostęp.

Po zakończeniu kliknij przycisk Exchange authorization code for tokens i skopiuj wygenerowany token dostępu.

Rozpoczynanie spotkania

Rozpocznij spotkanie przy użyciu tego samego konta użytkownika, którego użyto do wygenerowania tokena OAuth. Skopiuj kod spotkania. Możesz teraz uruchomić przykłady.

Przykładowe aplikacje

Repozytorium GitHub zawiera przykłady odbierania multimediów i metadanych uczestników spotkania.

Te próbki zbierają dane przez określony czas (domyślnie 3 sekundy) i zapisują je w plikach.

Pliki audio są w formacie PCM16. Pliki wideo są w formacie YUV420p. Te pliki można odtwarzać za pomocą biblioteki takiej jak FFmpeg.

Rozdzielczość wideo może się zmieniać w trakcie spotkania, dlatego w nazwach plików wideo znajdują się przykłady rozdzielczości.

Pliki metadanych uczestników będą plikami tekstowymi czytelnymi dla człowieka.

Próbka multimediów dla pojedynczego użytkownika

Próbka multimediów jednego użytkownika to podstawowa aplikacja, która koncentruje się na zbieraniu dźwięku i obrazu. Próbka nie określa, który uczestnik utworzył dane audio i wideo. Dlatego użycie tego przykładu podczas spotkania z więcej niż 1 uczestnikiem może spowodować uszkodzenie danych wyjściowych.

Aby uruchomić przykładowy kod multimediów dla jednego użytkownika, wpisz:

$ sh ./run_multi.sh -- \
    --meeting_space_id MEETING_SPACE_ID \
    --oauth_token OAUTH_TOKEN

Domyślnie pojedynczy plik audio jest zapisywany w folderze /tmp/test_output_audio.pcm.

Strumienie wideo mogą zmieniać rozdzielczość podczas spotkania, dlatego może powstać kilka plików wideo. Nazwy plików wideo będą zawierać rosnący licznik i rozdzielczość danego pliku. Jeśli na przykład rozdzielczość strumienia wideo zmieniła się z 320 x 180 na 240 x 135, a potem z powrotem na 320 x 180, utworzone zostaną te pliki wideo:

• /tmp/test_output_video_0_320x180.pcm
• /tmp/test_output_video_1_240x135.pcm
• /tmp/test_output_video_2_320x180.pcm

(Opcjonalnie) Odtwarzanie plików wyjściowych w systemach Linux i Mac za pomocą FFmpeg

FFmpeg można używać do odtwarzania utworzonych plików audio i wideo. Przykładowe polecenia:

# Audio
$ ffplay -f s16le -ar 48k -af aformat=channel_layouts=mono \
    /tmp/test_output_audio.pcm

# Video
#
# `video_size` must match the resolution in the video filename (320x180 in
# this example).
$ ffplay -f rawvideo -pixel_format yuv420p -video_size 320x180 \
    /tmp/test_output_video_0_320x180.yuv

Opcje

Podczas uruchamiania przykładów możesz określić te opcje:

Powiązane artykuły

• Rozwiązywanie problemów z błędami interfejsu Meet Media API

• Dokumentacja kanałów danych interfejsu Meet Media API