Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

步骤 2：编写并检查代码

在 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 函数时传递。您还可以在创建KinesisVideoStream对象后发送编解码器的私有数据，同时在中调用 start 方法。KinesisVideoStream

在 Kinesis 视频流中存储 FRAES

您可以使用KinesisVideoStream::putFrame传入包含标题和媒体数据的Frame对象将媒体放入 Kinesis 视频流。此示例调用 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 Video Streams 数据模型。

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

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

PutFrameHelper具有以下字段：

指标和指标日志

C++ 创建者开发工具包包括指标和指标日志记录的功能。

您可以使用getKinesisVideoMetrics和 getKinesisVideoStreamMetrics API 操作来检索有关 Kinesis Video Streams 和您的活跃直播的信息。

以下代码来自 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); 
            

下一步

步骤 3：运行并验证代码