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

Tulis dan periksa kodenya

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 sebuah 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 sebuah instance dari KinesisVideoStream

Anda membuat KinesisVideoStream objek dengan memanggil KinesisVideoProducer::CreateStream metode dengan StreamDefinition parameter. Contoh membuat ProducerTestFixture.h file KinesisVideoStream dalam dengan jenis trek sebagai video, dan dengan track id sebagai 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));

StreamDefinitionObjek memiliki bidang berikut:

Tambahkan 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 addTrack fungsi. Anda juga dapat mengirim data pribadi codec setelah membuat KinesisVideoStream objek sambil memanggil metode awal di KinesisVideoStream.

Masukkan bingkai ke dalam aliran video Kinesis

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

FrameObjek memiliki bidang berikut:

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

Menempatkan KinesisVideoFrame ke dalam trek tertentu KinesisVideoStream

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

Ini PutFrameHelper memiliki bidang-bidang berikut:

Akses metrik dan pencatatan metrik

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

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

Kode berikut adalah 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);

PClientMetricsObjek yang diisi oleh getKinesisVideoMetrics berisi informasi berikut:

PStreamMetricsObjek yang diisi oleh getKinesisVideoStreamMetrics berisi informasi berikut:

Pembongkaran

Jika Anda ingin mengirim byte yang tersisa dalam buffer dan menungguACK, Anda dapat menggunakan: stopSync

kinesis_video_stream->stopSync();            

Atau Anda dapat menelepon stop untuk mengakhiri streaming:

kinesis_video_stream->stop();            

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

kinesis_video_producer_->freeStream(kinesis_video_stream);