View a markdown version of this page

下载并构建 Kinesis 视频流 C++ 制作人 SDK - Amazon Kinesis Video Streams

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

下载并构建 Kinesis 视频流 C++ 制作人 SDK

按照以下步骤下载和构建 Kinesis Video Streams C++ 制作器 SDK 。确保您已安装软件必备组件；有关这些步骤安装软件必备条件，请参阅。

  1. 导航到下载目录。打开终端并切换到您的首选下载目录。

    例如：

    cd ~/Downloads

  2. 克隆 SDK 存储库。使用git clone命令从 GitHub 存储库下载 SDK。类型：

    git clone https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git --single-branch -b master kvs-producer-sdk-cpp

    此命令仅克隆单个分支（分master支），从而减少了下载大小和时间。它还将下载的内容放到当前目录kvs-producer-sdk-cpp中名为的文件夹中。

  3. 验证下载。克隆过程完成后，列出该kvs-producer-sdk-cpp文件夹的内容以验证 SDK 是否已下载。

    ls kvs-producer-sdk-cpp

  4. 准备一个编译目录。类型：

    mkdir -p kvs-producer-sdk-cpp/build
cd kvs-producer-sdk-cpp/build

  5. 配置构建。运行以下cmake命令使用特定选项配置编译环境：

    cmake .. -DBUILD_GSTREAMER_PLUGIN=ON -DBUILD_DEPENDENCIES=OFF -DALIGNED_MEMORY_MODEL=ON

    CMake 使用以下选项来生成相应Makefiles的：

    • 使用项目文件夹 (..) 作为源目录。

    • 使用当前目录 (.) (build/) 进行编译输出。

    • -DBUILD_GSTREAMER_PLUGIN=ON允许构建 GStreamer 插件 kvssink。

    • -DBUILD_DEPENDENCIES=OFF禁止从源代码构建外部依赖关系。该项目将查找并使用上一步中安装的外部依赖项。

    • -DALIGNED_MEMORY_MODEL=ON禁用未对齐的内存模型。某些树莓派设备不支持未对齐的内存访问。

    注意

    有关 CMake 参数的完整列表，请参见下载并配置 C++ 生产者库代码。

  6. 构建项目。配置编译后，使用make命令使用Makefile生成的进行编译cmake。

    make -j$(nproc)

    的-j参数make允许它并行运行多个编译作业。要缩短编译时间，请使用该nproc命令动态计算树莓派上的 CPU 内核数量。

  7. 确认libgstkvssink.so它存在。

    列出当前目录中的文件。

    提示：

    ls

    响应：

    CMakeCache.txt       dependency                          kvs_gstreamer_sample
CMakeFiles           kvs_gstreamer_audio_video_sample    kvssink_gstreamer_sample
Makefile             kvs_gstreamer_file_uploader_sample  libKinesisVideoProducer.so
cmake_install.cmake  kvs_gstreamer_multistream_sample    libgstkvssink.so

  8. 确认 GStreamer 可以加载。kvssink

    将GST_PLUGIN_PATH环境变量设置为包含的目录libgstkvssink.so。

    export GST_PLUGIN_PATH=`pwd`

    加载 GStreamer：kvssink

    gst-inspect-1.0 kvssink

    你应该看到一些相关的文档kvssink。使用箭头键导航，按下q箭头键退出。

  9. （可选）更新 shell 的启动脚本以包括设置GST_PLUGIN_PATH环境变量。这样可以确保GST_PLUGIN_PATH在新的终端会话期间正确设置。在树莓派设备上，外壳的启动脚本是~/.bashrc。

    运行以下命令将该命令附加到 shell 启动脚本的末尾。

    echo "export GST_PLUGIN_PATH=~/Downloads/kvs-producer-sdk-cpp/build" >> ~/.bashrc

    键入以下命令来运行外壳程序的启动脚本，或者关闭当前 shell 并打开一个新的 shell。

    source ~/.bashrc

    确认GST_PLUGIN_PATH已设置，即可加载kvssink。

    echo $GST_PLUGIN_PATH
    gst-inspect-1.0 kvssink