適用於嵌入式裝置的 C WebRTC 開發套件

下列 step-by-step 指示說明如何針對嵌入式裝置及其對應範例使用 WebRTC 技術 SDK 下載、建置和執行 Kinesis Video Streams。

在 C 語言中使用 WebRTC 技術開發套件下載 Kinesis Video Streams

若要針對嵌入式裝置下載含 WebRTC 技術 SDK 的 Kinesis Video Streams，請執行下列命令：

$ git clone https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-c.git

使用 C 語言中的 WebRTC 技術開發套件建置 Kinesis Video Streams

重要

在 macOS 上完成這些步驟之前，您必須運行以使用命令行工具和標題xcode-select --install來下載軟件包，具體取決於您所擁有的 macOS 版本。然後打開/Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg並按照安裝程序安裝命令行工具和標題。您只需要在調用cmake之前執行此操作一次。如果您已經安裝了命令行工具和標頭，則無需再次執行此命令。

請完成下列步驟：

1. 安裝 CMake：

   • 在 macOS 上，執行 brew install cmake pkg-config srtp

   • 在 Ubuntu 上，執行 sudo apt-get install pkg-config cmake libcap2 libcap-dev

2. 取得您要用於此示範 AWS 帳戶 的存取金鑰和秘密金鑰。

3. 執行以下命令，在您下載的 WebRTC C 開發套件中建立 build 目錄，然後從中執行 cmake：

   $ mkdir -p amazon-kinesis-video-streams-webrtc-sdk-c/build; cd amazon-kinesis-video-streams-webrtc-sdk-c/build; cmake ..

4. 現在，你在你剛剛創建與上述步驟的build目錄中，運行make以構建 WebRTC C SDK 及其提供的示例。

   注意

   如果系統沒有gstreamer安裝，kvsWebrtcClientMasterGstSample將不會建立。要確保它是內置的（在 macOS 上），您必須運行：brew install gstreamer gst-plugins-base gst-plugins-good

執行 WebRTC C 開發套件的範例

完成上述程序之後，最後在 build 目錄中會出現下列範例應用程式：

• kvsWebrtcClientMaster-此應用程序通過信令通道發送樣本 H264/Opus 幀（路徑：/樣本/h264 和/採樣/SampleFrames ）。opusSampleFrames也會接受傳入的音訊 (如果在瀏覽器中啟用)。在瀏覽器中檢查時，將會在終端機列印收到的音訊封包的中繼資料。

• kvsWebrtcClientViewer - 此應用程式接受並印列範例 H264/Opus 影格。

• kvsWebrtcClientMasterGstSample - 此應用程式從 GStreamer 管道傳送範例 H264/Opus 影格。

若要執行這些範例中的任何一個，請完成以下步驟：

1. 使用您的 AWS 帳戶 憑據設置您的環境：

   export AWS_ACCESS_KEY_ID=YourAccessKey
   export AWS_SECRET_ACCESS_KEY=YourSecretKey
   export AWS_DEFAULT_REGION=YourAWSRegion

   如果您使用臨時 AWS 憑據，請同時導出會話令牌：

   export AWS_SESSION_TOKEN=YourSessionToken

   如果您要設定自訂 CA 憑證路徑，您可以使用下列方式進行設定：

   export AWS_KVS_CACERT_PATH=../certs/cert.pem

   注意

   根據預設，SSL CA 憑證會設定為.. /證書/cert.pem，它指向中此存儲庫中的文件。GitHub

2. 將您要給訊號頻道的名稱傳給其中一個範例應用程式，以執行應用程式。應用程式會使用您提供的名稱建立訊號頻道。例如，若要建立名為 myChannel 的訊號頻道，並開始透過此頻道傳送範例 H264/Opus 影格，請執行下列命令：

   ./kvsWebrtcClientMaster myChannel

   當命令列應用程式列印 Connection established 時，您可以繼續進行下一個步驟。

3. 現在，訊號頻道已建立，且連線的主節點正在將媒體串流至訊號頻道，您可以檢視此串流。例如，您可以在 Web 應用程式中檢視此即時串流。若要這麼做，請使用中的步驟開啟 WebRTC SDK 測試頁面，使用 WebRTC 測試頁面的 Kinesis Video Streams並使用您為上述主機指定的相同 AWS 認證和相同的信號通道來設定下列值：

   • 存取金鑰 ID

   • 私密存取金鑰

   • 訊號頻道名稱

   • 用戶端 ID (選擇性)

   選擇 Start viewer (啟動檢視器)，開始範例 H264/Opus 影格的即時視訊串流。

視頻教程

本影片示範如何連接您的攝影機，並開始使用適用於 WebRTC 的 Amazon Kinesis Video Streams。