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

编写并检查代码

在本节中使用 C++ 制作者库，您将研究 C++ 测试工具（tst/ProducerTestFixture.h和其他文件）中的代码。您在上一部分中已下载该代码。

平台独立的 C++ 示例演示了以下编码模式：

以下各节提供了有关此编码模式的更多信息。

创建的实例 KinesisVideoProducer

您可以通过调用 KinesisVideoProducer::createSync 方法来创建 KinesisVideoProducer 对象。以下示例在 ProducerTestFixture.h 文件中创建 KinesisVideoProducer：

kinesis_video_producer_ = KinesisVideoProducer::createSync(move(device_provider_),
    move(client_callback_provider_),
    move(stream_callback_provider_),
    move(credential_provider_),
    defaultRegion_);

createSync 方法采用以下参数：

创建的实例 KinesisVideoStream

您可以通过调用带 StreamDefinition 参数的 KinesisVideoProducer::CreateStream 方法来创建 KinesisVideoStream 对象。该示例在 ProducerTestFixture.h 文件中创建 KinesisVideoStream，轨道类型为视频，轨道 ID 为 1：

auto stream_definition = make_unique<StreamDefinition>(stream_name,
                                               hours(2),
                                               tags,
                                               "",
                                               STREAMING_TYPE_REALTIME,
                                               "video/h264",
                                               milliseconds::zero(),
                                               seconds(2),
                                               milliseconds(1),
                                               true,
                                               true,
                                               true);
return kinesis_video_producer_->createStream(move(stream_definition));

StreamDefinition 对象具有以下字段：

向 Kinesis 视频流添加音轨

您可以使用以下addTrack方法将音轨详细信息添加到视频轨道流定义中StreamDefinition：

stream_definition->addTrack(DEFAULT_AUDIO_TRACKID, DEFAULT_AUDIO_TRACK_NAME, DEFAULT_AUDIO_CODEC_ID, MKV_TRACK_INFO_TYPE_AUDIO);

该addTrack方法需要以下参数：

如果有用于音轨的编解码器专用数据，可在调用 addTrack 函数时传递。您还可以在中调用 start 方法时创建 KinesisVideoStream 对象后发送编解码器私有数据。 KinesisVideoStream

在 Kinesis 视频流中加入一帧

您可以使用将媒体放入 Kinesis 视频流KinesisVideoStream::putFrame，传入一个包含标题和媒体数据的Frame对象。此示例调用 ProducerApiTest.cpp 文件中的 putFrame：

frame.duration = FRAME_DURATION_IN_MICROS * HUNDREDS_OF_NANOS_IN_A_MICROSECOND;
    frame.size = SIZEOF(frameBuffer_);
    frame.frameData = frameBuffer_;
    MEMSET(frame.frameData, 0x55, frame.size);

    while (!stop_producer_) {
        // Produce frames
        timestamp = std::chrono::duration_cast<std::chrono::nanoseconds>(
                std::chrono::system_clock::now().time_since_epoch()).count() / DEFAULT_TIME_UNIT_IN_NANOS;
        frame.index = index++;
        frame.decodingTs = timestamp;
        frame.presentationTs = timestamp;

        // Key frame every 50th
        frame.flags = (frame.index % 50 == 0) ? FRAME_FLAG_KEY_FRAME : FRAME_FLAG_NONE;
    ...

    EXPECT_TRUE(kinesis_video_stream->putFrame(frame));

Frame 对象具有以下字段：

有关帧的格式的更多信息，请参阅 Kinesis 视频流数据模型。

将 a 放 KinesisVideoFrame 入特定的曲目中 KinesisVideoStream

您可以使用该PutFrameHelper类将帧数据放入特定的轨道中。首先，调用getFrameDataBuffer以获取指向其中一个预先分配的缓冲区的指针，以填充数据。KinesisVideoFrame然后，您可以调用，putFrameMultiTrack将与布尔值KinesisVideoFrame一起发送，以指示帧数据的类型。如果是视频数据，请使用 true；如果帧包含音频数据，则使用 false。该putFrameMultiTrack方法使用排队机制来确保 MKV 片段保持单调增加的帧时间戳，并且任何两个片段都不会重叠。例如，片段第一帧的 MKV 时间戳应始终大于前一片段最后一帧的 MKV 时间戳。

PutFrameHelper 包含以下字段：

访问指标和指标日志

C++ 生产者 SDK 包含指标和指标记录功能。

您可以使用getKinesisVideoMetrics和 getKinesisVideoStreamMetrics API 操作来检索有关 Kinesis 视频流和活动直播的信息。

以下代码来自 kinesis-video-pic/src/client/include/com/amazonaws/kinesis/video/client/Include.h 文件。

/**
* Gets information about the storage availability.
*
* @param 1 CLIENT_HANDLE - the client object handle.
* @param 2 PKinesisVideoMetrics - OUT - Kinesis Video metrics to be filled.
*
* @return Status of the function call.
*/
PUBLIC_API STATUS getKinesisVideoMetrics(CLIENT_HANDLE, PKinesisVideoMetrics);

/**
* Gets information about the stream content view.
*
* @param 1 STREAM_HANDLE - the stream object handle.
* @param 2 PStreamMetrics - Stream metrics to fill.
*
* @return Status of the function call.
*/
PUBLIC_API STATUS getKinesisVideoStreamMetrics(STREAM_HANDLE, PStreamMetrics);

getKinesisVideoMetrics 填入的 PClientMetrics 对象包含以下信息：

getKinesisVideoStreamMetrics 填入的 PStreamMetrics 对象包含以下信息：

分解

如果要发送缓冲区中的剩余字节并等待 ACK，您可以使用 stopSync：

kinesis_video_stream->stopSync();            

或者，您可以调用 stop 来结束流式传输：

kinesis_video_stream->stop();            

停止流式传输后，您可以通过调用以下 API 释放流：

kinesis_video_producer_->freeStream(kinesis_video_stream);