适用于嵌入式设备的 Amazon Kinesis Video Streams 带有 C 语言中的 RTC SDK Web - Kinesis Video Streams
下载 SDK构建 SDK运行示SDK例视频教程

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

适用于嵌入式设备的 Amazon Kinesis Video Streams 带有 C 语言中的 RTC SDK Web

以下 step-by-step 说明描述了如何为嵌入式设备下载、构建和运行带有 RTC SDK Web 的 C 语言版 Kinesis Video Streams 及其相应示例。

支持以下编解码器：

  • 音频：

    • G.711 A-Law

    • G.711 U-Law

    • Opus

  • 视频:

    • H.264

    • H.265

    • VP8

下载 SDK

要为嵌入式设备下载带有 C 语言版本的 Kinesis Vid RTC SDK eo Streams，请运行以下命令：

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

构建 SDK

重要

在 macOS 上完成这些步骤之前，根据您的 macOS 版本，您必须运行 xcode-select --install 下载带有命令行工具和标头的软件包。然后打开/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. 运行以下命令在下载的 Web RTC C SDK 中创建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构建 Web RTC C SDK 及其提供的示例。

    注意

    如果系统尚未gstreamer安装，则kvsWebrtcClientMasterGstSampleNOT将构建。要确保它是（在 macOS 上）构建的，您必须运行：brew install gstreamer gst-plugins-base gst-plugins-good

运行示SDK例

完成上述过程后，您最终会在您的 build 目录中使用以下示例应用程序：

  • kvsWebrtcClientMaster-此应用程序通过信令通道发送示例 H264/Opus 帧（路径：/samples/h264 和 /samples/SampleFrames ）。opusSampleFrames它也接受传入的音频（如果在浏览器中启用）。在浏览器中勾选时，它会打印终端中收到的音频数据包的元数据。

  • kvsWebrtcClientViewer - 此应用程序接受示例 H264/Opus 帧并打印出来。

  • kvsWebrtcClientMasterGstSample-此应用程序从管道发送样本 H264/Opus 帧。GStreamer

要运行任何这些示例，请完成以下步骤：

  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
    注意

    默认情况下，SSLCA 证书设置为... /certs/cert.pem，它指向此存储库中的文件。GitHub

  2. 通过将您要向信令通道提供的名称传递给示例应用程序来运行任一应用程序。应用程序使用您提供的名称创建信令通道。例如，要创建一个名为 myChannel 的信令通道并开始通过该通道发送示例 H264/Opus 帧，请运行以下命令：

    ./kvsWebrtcClientMaster myChannel

    当命令行应用程序打印 Connection established 时，您可以继续下一步。

  3. 现在您的信令通道已创建，并且连接的主设备正在将媒体流式传输到它，您可以查看此流。例如，您可以在 Web 应用程序中查看此实时流。为此，请使用中的步骤打开 Web RTC SDK 测试页面，使用示例应用程序然后使用相同的步骤设置以下值 AWS 凭证和您为上述主服务器指定的相同信令信道：

    • 访问密钥 ID

    • 秘密访问密钥

    • 信令通道名称

    • 客户端 ID（可选）

    选择 Start viewer (启动查看器) 以启动示例 H264/Opus 帧的实时视频流式传输。

视频教程

本视频演示了如何连接摄像头并开始使用网络版 Amazon Kinesis Video Streams。RTC