本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

撰寫並檢查程式碼

在的這一節中使用 C ++ 生產者庫，您會檢查 C++ 測試工具 (tst/ProducerTestFixture.h和其他檔案) 中的程式碼。您在上一節中下載了此程式碼。

平台獨立 C++ 範例顯示下列編碼模式：

以下各節提供有關此編碼模式的更多信息。

建立執行個體 KinesisVideoProducer

您呼叫 KinesisVideoProducer 方法建立 KinesisVideoProducer::createSync 物件。下列範例在 KinesisVideoProducer 檔案中建立 ProducerTestFixture.h：

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 Video Streams 資料模型。

把一個 KinesisVideoFrame 到一個特定的軌道 KinesisVideoStream

您可以使用該PutFrameHelper類將幀數據放入特定軌道中。首先，調用getFrameDataBuffer以獲取指向其中一個預先分配緩衝區的指針以填充數KinesisVideoFrame據。然後，您可以呼叫傳putFrameMultiTrack送與 Boolean 值一KinesisVideoFrame起傳送，以指示訊框資料的類型。如果是視訊資料，使用 true，或者，如果影格包含音訊資料，則使用 false。該putFrameMultiTrack方法使用隊列機制來確保MKV片段保持單調增加的幀時間戳，並且任何兩個片段不重疊。例如，片段第一個影格的MKV時間戳記應該永遠大於前一個片段最後一個影格的MKV時間戳記。

具PutFrameHelper有下列欄位：

存取指標和指標記錄

C++ 生產者SDK包含指標和指標記錄的功能。

您可以使用getKinesisVideoMetrics和getKinesisVideoStreamMetricsAPI操作來擷取 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);