Meet Media API：C++ 參考用戶端快速入門

本頁面說明如何使用 C++ 參考用戶端實作設定及執行範例。如要瞭解 TypeScript 用戶端，請參閱 TypeScript 參考用戶端快速入門。

必要條件

如要執行本快速入門導覽課程，請先完成下列必要條件：

• 您已複製 GitHub 存放區。
• Bazel 7.4.1。
• 已啟用 Google Meet REST API 的 Google Cloud 專案。
• Google Workspace 帳戶。

啟用 Meet REST API

建構 C++ 用戶端

1. C++ 實作項目是使用 Bazel 建構。不過，C++ WebRTC 程式庫 (libwebrtc) 沒有可用的 Bazel 建構作業，因此您必須先按照 WebRTC 文件中的說明建構該程式庫。

   以下是 WebRTC 文件中說明的簡短版本：

   $ cd ~
   $ mkdir src
   $ cd src
   $ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
   $ export PATH=~/src/depot_tools:$PATH
   $ mkdir webrtc-checkout
   $ cd webrtc-checkout
   $ fetch --nohooks webrtc
   $ cd src
   $ # Latest known version to work with our builds
   $ git checkout b00c469cad3f8c926fcf81ded90b90b6e1e62b9c
   $ cd ..
   $ gclient sync
   $ mv src webrtc
   $ cd webrtc
   $ ./build/install-build-deps.sh
   $ gn gen out/Default --args='is_debug=false use_custom_libcxx=false rtc_include_tests=false rtc_build_examples=false dcheck_always_on=true rtc_use_x11=false use_rtti=true'
   $ ninja -C out/Default
   

   注意：由於工具鍊和 abseil 更新，我們目前已知與建構作業相容的最新版本是提交 b00c469cad3f8c926fcf81ded90b90b6e1e62b9c。目錄位置日後可能會有變動。這組指令現在可以運作，但如果基礎工具有所變更，請參閱提供的連結。如果您要建構的目標是 x64 以外的 Debian 或 Ubuntu Linux 變種版本，可能需要進行不同的必要設定。

2. 建構 libwebrtc 後，請更新 WORKSPACE 檔案，指向 webrtc-checkout 目錄。更新該檔案頂端的 webrtc_path 路徑：

   webrtc_path = "/usr/local/myuser/webrtc-checkout/" 
   

3. 使用 Bazel 建構 C++ 用戶端：

   $ bazel build //cpp/...
   

注意：請使用 Bazel 7.4.1。如果安裝了較新版本的 Bazel，可以使用 bazel-7.4.1 build/run/test ... 執行

1. (選用) 執行測試：

   $ bazel test //cpp/...
   

產生 OAuth 權杖

如要連線至 Meet Media API，應用程式必須使用 OAuth 產生存取權杖。如要進一步瞭解如何使用 OAuth 存取 Google API，請參閱「使用 OAuth 2.0 存取 Google API」。

您可以使用 OAuth 2.0 Playground 產生權杖。使用遊樂場時，請務必遵守下列事項：

• 使用雲端專案中的用戶端 ID 和密鑰憑證。
• 要求正確的範圍。
• 登入 Google 帳戶並接受存取權。

完成後，按一下 Exchange authorization code for tokens 按鈕，然後複製產生的存取權杖。

發起會議

使用產生 OAuth 權杖時所用的使用者帳戶發起會議。複製會議代碼。您現在可以執行範例了。

範例應用程式

GitHub 存放區提供範例，可從會議接收媒體和參與者中繼資料。

這些樣本會收集指定時間長度的資料 (預設為 3 秒)，並將收集到的資料寫入檔案。

音訊檔案為 PCM16 格式。影片檔案為 YUV420p 格式。您可以使用 FFmpeg 等程式庫播放這些檔案。

由於會議期間的影片解析度可能會變更，因此範例會在影片檔名中加入解析度。

參與者中繼資料檔案為使用者可讀的文字檔。

單一使用者媒體範例

單一使用者媒體範例是基本應用程式，主要用於收集音訊和影片。樣本不會判斷音訊和視訊資料是由哪位參與者建立。因此，如果會議有多位參與者，使用這個範例可能會導致輸出內容損毀。

如要執行單一使用者媒體範例，請執行：

$ bazel run cpp/samples:single_user_media_sample -- \
    --meeting_space_id MEETING_SPACE_ID \
    --oauth_token OAUTH_TOKEN

根據預設，單一音訊檔案會儲存至 /tmp/test_output_audio.pcm。

由於視訊串流可能會在會議期間變更解析度，因此系統可能會建立多個視訊檔案。影片檔案名稱會包含遞增計數器和該檔案的解析度。舉例來說，如果影片串流解析度從 320x180 變更為 240x135，然後再變回 320x180，系統會建立下列影片檔案：

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

(選用) 使用 FFmpeg 在 Linux 和 Mac 上播放輸出檔案

您可以使用 FFmpeg 播放建立的音訊和影片檔案。範例指令：

# 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

選項

執行範例時，您可以指定下列選項：

相關主題

• 排解及修正 Meet Media API 錯誤

• 符合 Media API 資料管道參考資料