Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Schreiben und untersuchen Sie den Code

In diesem Abschnitt von untersuchen Sie den Code im C++-Testcode (tst/ProducerTestFixture.hund anderen Dateien). Verwenden Sie die C++-Producer-Bibliothek Sie haben diesen Code im vorherigen Abschnitt heruntergeladen.

Das plattformunabhängige C++-Beispiel zeigt das folgende Codierungsmuster:

In den folgenden Abschnitten finden Sie weitere Informationen zu diesem Codierungsmuster.

Erstellen Sie eine Instanz von KinesisVideoProducer

Das KinesisVideoProducer-Objekt wird durch einen Aufruf der Methode KinesisVideoProducer::createSync erstellt. Im folgenden Beispiel wird KinesisVideoProducer in der Datei ProducerTestFixture.h erstellt:

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

Die Methode createSync verwendet die folgenden Parameter:

Erstellen Sie eine Instanz von KinesisVideoStream

Sie erstellen das KinesisVideoStream-Objekt, indem Sie die Methode KinesisVideoProducer::CreateStream mit einem StreamDefinition-Parameter aufrufen. Das Beispiel erstellt den KinesisVideoStream in der Datei ProducerTestFixture.h mit dem Track-Typ als Video und der 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));

Das StreamDefinition-Objekt enthält folgende Felder:

Fügen Sie dem Kinesis-Videostream eine Audiospur hinzu

Sie können einer Videotrack-Stream-Definition Details zur Audiospur hinzufügen, indem Sie die addTrack folgende Methode verwendenStreamDefinition:

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

Die addTrack Methode erfordert die folgenden Parameter:

Wenn Sie private Codec-Daten für den Audiotrack haben, können Sie diese beim Aufrufen der addTrack Funktion übergeben. Sie können dem Codec auch private Daten senden, nachdem Sie das KinesisVideoStream Objekt erstellt haben, während Sie die Startmethode in aufrufen. KinesisVideoStream

Fügen Sie einen Frame in den Kinesis-Videostream ein

Sie fügen Medien in den Kinesis-Videostream einKinesisVideoStream::putFrame, indem Sie ein Frame Objekt übergeben, das den Header und die Mediendaten enthält. Das Beispiel ruft putFrame in der Datei ProducerApiTest.cpp auf:

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));

Das Frame-Objekt enthält folgende Felder:

Weitere Informationen zum Format des Frames erhalten Sie unter Kinesis Video Streams Streams-Datenmodell.

Fügen Sie einen KinesisVideoFrame in einen bestimmten Track ein von KinesisVideoStream

Sie können die PutFrameHelper Klasse verwenden, um Frame-Daten in eine bestimmte Spur einzufügen. Rufen Sie zunächst den getFrameDataBuffer auf, um einen Zeiger auf einen der vorab zugewiesenen Puffer zum Ausfüllen der KinesisVideoFrame Daten zu erhalten. Dann können Sie den aufrufen, putFrameMultiTrack um den KinesisVideoFrame zusammen mit dem booleschen Wert zu senden, der den Typ der Frame-Daten angibt. Verwenden Sie "true", wenn es sich um Videodaten handelt, oder "false", wenn der Frame Audiodaten enthält. Die putFrameMultiTrack Methode verwendet einen Warteschlangenmechanismus, um sicherzustellen, dass die MKV Fragmente monoton ansteigende Frame-Zeitstempel beibehalten und sich zwei beliebige Fragmente nicht überlappen. Beispielsweise sollte der MKV Zeitstempel des ersten Frames eines Fragments immer größer sein als der MKV Zeitstempel des letzten Frames des vorherigen Fragments.

Das PutFrameHelper hat die folgenden Felder:

Zugriff auf Metriken und Metrikprotokollierung

Der C++-Producer SDK umfasst Funktionen für Metriken und die Protokollierung von Metriken.

Sie können die getKinesisVideoStreamMetrics API Operationen getKinesisVideoMetrics und verwenden, um Informationen über Kinesis Video Streams und Ihre aktiven Streams abzurufen.

Der folgende Code stammt aus der Datei 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);

Das von getKinesisVideoMetrics gefüllte PClientMetrics-Objekt folgende Informationen enthalten:

Das von getKinesisVideoStreamMetrics gefüllte PStreamMetrics-Objekt folgende Informationen enthalten:

Abbruch

Wenn Sie die verbleibenden Bytes in einem Puffer senden und auf das ACK warten möchten, können Sie stopSync verwenden:

kinesis_video_stream->stopSync();            

Oder Sie können stop aufrufen, um das Streamen zu beenden:

kinesis_video_stream->stop();            

Nachdem Sie den Stream gestoppt haben, können Sie den Stream freigeben, indem Sie Folgendes API aufrufen:

kinesis_video_producer_->freeStream(kinesis_video_stream);