Usa la libreria C producer - Amazon Kinesis Video Streams

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à.

Usa la libreria C producer

Puoi utilizzare la libreria C producer fornita da Amazon Kinesis Video Streams per scrivere codice applicativo per inviare dati multimediali da un dispositivo a un flusso video Kinesis.

Modello a oggetti

La libreria di produttori Kinesis Video Streams C si basa su un componente comune chiamato Platform Independent Codebase (PIC), disponibile GitHub all'indirizzo -pic/. https://github.com/awslabs/ amazon-kinesis-video-streams Il PIC contiene una logica di business indipendente dalla piattaforma per i componenti fondamentali. La libreria di produttori Kinesis Video Streams C include PIC con un livello di API aggiuntivo che consente callback ed eventi specifici per scenari e piattaforme. La libreria di produttori Kinesis Video Streams C ha i seguenti componenti basati su PIC:

  • Provider di informazioni sui dispositivi: espone la DeviceInfo struttura che può essere fornita direttamente all'API PIC. È possibile configurare un set di provider, incluso un provider ottimizzato per gli scenari applicativi in grado di ottimizzare l'archivio di contenuti in base al numero e ai tipi di flussi gestiti dall'applicazione e alla quantità di buffering richiesta configurata in base alla quantità di RAM disponibile.

  • Stream info provider: espone la StreamInfo struttura che può essere fornita direttamente all'API PIC. Esiste una serie di provider specifici per i tipi di applicazioni e i tipi più comuni di scenari di streaming. Questi includono provider come video, audio e multitraccia audio e video. Ciascuno di questi scenari presenta impostazioni predefinite che è possibile personalizzare in base ai requisiti dell'applicazione.

  • Provider di callback: espone la ClientCallbacks struttura che può essere fornita direttamente all'API PIC. Ciò include un set di provider di callback per il networking (callback API basati su CURL), l'autorizzazione (API delle AWS credenziali) e lo streaming di nuovi tentativi in caso di callback di errori. L'API Callback Provider richiede una serie di argomenti per la configurazione, come le informazioni di autorizzazione e. Regione AWS Questa operazione viene eseguita utilizzando certificati IoT o utilizzando AWS AccessKeyId SecretKey, o SessionToken. È possibile potenziare i provider di callback con callback personalizzati se l'applicazione ha bisogno di ulteriori elaborazioni di un determinato callback per raggiungere la logica specifica dell'applicazione.

  • FrameOrderCoordinator— Aiuta a gestire la sincronizzazione audio e video per scenari multitraccia. Ha un comportamento predefinito, che è possibile personalizzare per gestire la logica specifica dell'applicazione. Inoltre, semplifica l'imballaggio dei metadati dei frame nella struttura PIC Frame prima di inviarli all'API PIC di livello inferiore. Per gli scenari non multitraccia, questo componente è un punto di passaggio all'API putFrame PIC.

La libreria C fornisce i seguenti oggetti per gestire l'invio di dati a un flusso video di Kinesis:

  • KinesisVideoClient— Contiene informazioni sul dispositivo e mantiene i callback per segnalare gli eventi di Kinesis Video Streams.

  • KinesisVideoStream— Rappresenta informazioni sui parametri del flusso video, come nome, periodo di conservazione dei dati e tipo di contenuto multimediale.

Inserite contenuti multimediali nello stream

È possibile utilizzare i metodi forniti dalla libreria C (ad esempioPutKinesisVideoFrame) per inserire dati nell'KinesisVideoStreamoggetto. La libreria gestisce quindi lo stato interno dei dati, che può includere le seguenti attività:

  • Esecuzione dell'autenticazione.

  • Controllo della latenza di rete. Se la latenza è troppo elevata, la libreria potrebbe scegliere di eliminare i fotogrammi.

  • Monitoraggio dello stato dello streaming in corso.

Procedura: utilizzare C Producer SDK

Questa procedura dimostra come utilizzare il client Kinesis Video Streams e le sorgenti multimediali in un'applicazione C per inviare fotogrammi video con codifica H.264 al flusso video Kinesis.

La procedura include le seguenti fasi: