Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Scrivi ed esamina il codice

In questa sezione diUsa la libreria Producer C++, si esamina il codice nel test harness C++ (tst/ProducerTestFixture.he in altri file). Hai scaricato questo codice nella sezione precedente.

L'esempio di C++ indipendente dalla piattaforma mostra i seguenti modelli di codifica:

Le sezioni seguenti forniscono ulteriori informazioni su questo modello di codifica.

Crea un'istanza di KinesisVideoProducer

Per creare l'oggetto KinesisVideoProducer, richiama il metodo KinesisVideoProducer::createSync. L'esempio seguente crea KinesisVideoProducer nel file ProducerTestFixture.h:

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

Il metodo createSync accetta i parametri seguenti:

Crea un'istanza di KinesisVideoStream

Per creare l'oggetto KinesisVideoStream, richiama il metodo KinesisVideoProducer::CreateStream con un parametro StreamDefinition. L'esempio crea KinesisVideoStream nel file ProducerTestFixture.h con il tipo di traccia video e con id traccia pari a 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));

L'oggetto StreamDefinition dispone dei campi seguenti:

Aggiungere una traccia audio allo stream video Kinesis

È possibile aggiungere i dettagli della traccia audio a una definizione di flusso di tracce video utilizzando il addTrack metodo diStreamDefinition:

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

Il addTrack metodo richiede i seguenti parametri:

Se disponi di dati privati del codec per la traccia audio, puoi passarli quando chiami la addTrack funzione. È inoltre possibile inviare i dati privati del codec dopo aver creato l' KinesisVideoStream oggetto durante la chiamata al metodo start in. KinesisVideoStream

Inserisci un fotogramma nel flusso video di Kinesis

I file multimediali vengono inseriti nel flusso video di Kinesis utilizzandoKinesisVideoStream::putFrame, passando un Frame oggetto che contiene l'intestazione e i dati multimediali. L'esempio richiama putFrame nel file ProducerApiTest.cpp:

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

L'oggetto Frame dispone dei campi seguenti:

Per ulteriori informazioni sul formato della cornice, vedere. Modello di dati Kinesis Video Streams

Inserisci un KinesisVideoFrame in una traccia specifica di KinesisVideoStream

Puoi usare la PutFrameHelper classe per inserire i dati del frame in una traccia specifica. Innanzitutto, chiama il getFrameDataBuffer per ottenere un puntatore a uno dei buffer preallocati per inserire i dati. KinesisVideoFrame Quindi, puoi chiamare il putFrameMultiTrack per inviare il KinesisVideoFrame insieme al valore booleano per indicare il tipo di dati del frame. Utilizza "true" se si tratta di dati video o "false" se il frame contiene dati audio. Il putFrameMultiTrack metodo utilizza un meccanismo di accodamento per garantire che i MKV frammenti mantengano timestamp dei frame crescenti in modo monotono e che due frammenti non si sovrappongano. Ad esempio, il MKV timestamp del primo fotogramma di un frammento deve essere sempre maggiore del timestamp dell'ultimo fotogramma del frammento precedente. MKV

Ha i seguenti campi: PutFrameHelper

Accedi alle metriche e alla registrazione delle metriche

Il produttore C++ SDK include funzionalità per le metriche e la registrazione delle metriche.

È possibile utilizzare le getKinesisVideoStreamMetrics API operazioni getKinesisVideoMetrics and per recuperare informazioni su Kinesis Video Streams e sugli stream attivi.

Il seguente codice è tratto dal file 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);

L'oggetto PClientMetrics compilato da getKinesisVideoMetrics contiene le seguenti informazioni:

L'oggetto PStreamMetrics compilato da getKinesisVideoStreamMetrics contiene le seguenti informazioni:

Teardown:

Se desideri inviare i byte rimanenti in un buffer e attendere il ACK, puoi utilizzare stopSync:

kinesis_video_stream->stopSync();            

In alternativa, puoi chiamare stop per terminare lo streaming:

kinesis_video_stream->stop();            

Dopo aver interrotto lo streaming, puoi liberarlo invocando quanto segue: API

kinesis_video_producer_->freeStream(kinesis_video_stream);