Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tulis dan periksa kode

Di bagian iniGunakan pustaka produser C++, Anda memeriksa kode di C++ test harness (tst/ProducerTestFixture.hdan file lainnya). Anda mengunduh kode ini di bagian sebelumnya.

Contoh Platform Independent C++ menunjukkan pola pengkodean berikut:

Bagian berikut memberikan informasi lebih lanjut tentang pola pengkodean ini.

Buat instance dari KinesisVideoProducer

Anda membuat KinesisVideoProducer objek dengan memanggil KinesisVideoProducer::createSync metode. Contoh berikut membuat KinesisVideoProducer dalam ProducerTestFixture.h file:

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

createSyncMetode ini mengambil parameter berikut:

Buat instance dari KinesisVideoStream

Anda membuat KinesisVideoStream objek dengan memanggil KinesisVideoProducer::CreateStream metode dengan StreamDefinition parameter. Contoh membuat ProducerTestFixture.h file dengan jenis trek sebagai video, dan dengan id trek sebagai 1: KinesisVideoStream

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

Ob StreamDefinition jek memiliki bidang berikut:

Menambahkan trek audio ke aliran video Kinesis

Anda dapat menambahkan detail trek audio ke definisi aliran trek video dengan menggunakan addTrack metodeStreamDefinition:

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

addTrackMetode ini membutuhkan parameter berikut:

Jika Anda memiliki data pribadi codec untuk trek audio, maka Anda dapat meneruskannya saat memanggil fungsi AddTrack. Anda juga dapat mengirim data pribadi codec setelah membuat KinesisVideoStream objek saat memanggil metode start di KinesisVideoStream.

Masukkan bingkai ke dalam aliran video Kinesis

Anda memasukkan media ke dalam aliran video Kinesis menggunakanKinesisVideoStream::putFrame, meneruskan Frame objek yang berisi header dan data media. Contoh panggilan putFrame dalam ProducerApiTest.cpp file:

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

Ob Frame jek memiliki bidang berikut:

Untuk informasi lebih lanjut tentang format bingkai, lihatModel data Streaming Video Kinesis.

Masukkan KinesisVideoFrame ke dalam trek tertentu KinesisVideoStream

Anda dapat menggunakan PutFrameHelper kelas untuk menempatkan data bingkai ke trek tertentu. Pertama, panggil getFrameDataBuffer untuk mendapatkan pointer ke salah satu buffer yang telah dialokasikan sebelumnya untuk mengisi data. KinesisVideoFrame Kemudian, Anda dapat memang putFrameMultiTrack gil untuk mengirim KinesisVideoFrame bersama dengan nilai Boolean untuk menunjukkan jenis data bingkai. Gunakan true jika itu data video atau false jika frame berisi data audio. putFrameMultiTrackMetode ini menggunakan mekanisme antrian untuk memastikan bahwa Fragmen MKV mempertahankan cap waktu bingkai yang meningkat secara monoton dan dua fragmen tidak tumpang tindih. Misalnya, stempel waktu MKV dari bingkai pertama fragmen harus selalu lebih besar dari stempel waktu MKV dari bingkai terakhir dari fragmen sebelumnya.

Ini PutFrameHelper memiliki bidang berikut:

Akses metrik dan pencatatan metrik

SDK produsen C++ menyertakan fungsionalitas untuk metrik dan pencatatan metrik.

Anda dapat menggunakan operasi getKinesisVideoMetrics dan getKinesisVideoStreamMetrics API untuk mengambil informasi tentang Kinesis Video Streams dan aliran aktif Anda.

Kode berikut berasal dari kinesis-video-pic/src/client/include/com/amazonaws/kinesis/video/client/Include.h file.

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

Ob PClientMetrics jek yang diisi getKinesisVideoMetrics berisi informasi berikut:

Ob PStreamMetrics jek yang diisi getKinesisVideoStreamMetrics berisi informasi berikut:

Membongkar

Jika Anda ingin mengirim sisa byte dalam buffer dan menungguACK, Anda dapat menggunakanstopSync:

kinesis_video_stream->stopSync();            

Atau Anda dapat menelep stop on untuk mengakhiri streaming:

kinesis_video_stream->stop();            

Setelah menghentikan streaming, Anda dapat membebaskan streaming dengan memanggil API berikut:

kinesis_video_producer_->freeStream(kinesis_video_stream);