com.amazonaws.kinesisvideo.parser.examples.KinesisVideoExample Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of amazon-kinesis-video-streams-parser-library Show documentation
Show all versions of amazon-kinesis-video-streams-parser-library Show documentation
The Amazon Kinesis Video Streams Parser Library for Java enables Java developers to parse the streams
returned by GetMedia calls to Amazon Kinesis Video.
// Generated by delombok at Thu Mar 10 20:43:17 UTC 2022
/*
Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
A copy of the License is located at
http://aws.amazon.com/apache2.0/
or in the "license" file accompanying this file.
This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.
*/
package com.amazonaws.kinesisvideo.parser.examples;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.kinesisvideo.parser.ebml.MkvTypeInfos;
import com.amazonaws.kinesisvideo.parser.mkv.MkvDataElement;
import com.amazonaws.kinesisvideo.parser.mkv.MkvElementVisitException;
import com.amazonaws.kinesisvideo.parser.mkv.MkvElementVisitor;
import com.amazonaws.kinesisvideo.parser.mkv.MkvEndMasterElement;
import com.amazonaws.kinesisvideo.parser.mkv.MkvStartMasterElement;
import com.amazonaws.kinesisvideo.parser.mkv.visitors.CompositeMkvElementVisitor;
import com.amazonaws.kinesisvideo.parser.utilities.FragmentMetadataVisitor;
import com.amazonaws.kinesisvideo.parser.utilities.OutputSegmentMerger;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.kinesisvideo.AmazonKinesisVideo;
import com.amazonaws.services.kinesisvideo.AmazonKinesisVideoClientBuilder;
import com.amazonaws.services.kinesisvideo.model.StartSelector;
import com.amazonaws.services.kinesisvideo.model.StartSelectorType;
import java.io.BufferedOutputStream;
import java.io.Closeable;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.file.StandardOpenOption;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;
/**
* Example for integrating with Kinesis Video.
* This example does:
* 1. Create a stream, deleting and recreating if the stream of the same name already exists.
* It sets the retention period of the created stream to 48 hours.
* 2. Call PutMedia to stream video fragments into the stream.
* 3. Simultaneously call GetMedia to stream video fragments out of the stream.
* 4. It uses the StreamingMkvParser to parse the returned the stream and perform these steps:
* 4.1 The GetMedia output stream has one mkv segment for each fragment. Merge the mkv segments that share track
* information into a single segment.
* 4.2 Log when we receive the start and end of each fragment including the fragment sequence number and
* millis behind now.
*/
public class KinesisVideoExample extends KinesisVideoCommon {
@SuppressWarnings("all")
private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(KinesisVideoExample.class);
private static final long SLEEP_PERIOD_MILLIS = TimeUnit.SECONDS.toMillis(3);
private static final int DATA_RETENTION_IN_HOURS = 48;
private final AmazonKinesisVideo amazonKinesisVideo;
private final InputStream inputStream;
private final ExecutorService executorService;
private PutMediaWorker putMediaWorker;
private final StreamOps streamOps;
private GetMediaProcessingArguments getMediaProcessingArguments;
private boolean noSampleInputRequired = false;
private KinesisVideoExample(Regions region, String streamName, AWSCredentialsProvider credentialsProvider, InputStream inputVideoStream, boolean noSampleInputRequired) {
super(region, credentialsProvider, streamName);
final AmazonKinesisVideoClientBuilder builder = AmazonKinesisVideoClientBuilder.standard();
configureClient(builder);
this.amazonKinesisVideo = builder.build();
this.inputStream = inputVideoStream;
this.streamOps = new StreamOps(region, streamName, credentialsProvider);
this.executorService = Executors.newFixedThreadPool(2);
this.noSampleInputRequired = noSampleInputRequired;
}
/**
* This method executes the example.
*
* @throws InterruptedException the thread is interrupted while waiting for the stream to enter the correct state.
* @throws IOException fails to read video from the input stream or write to the output stream.
*/
public void execute() throws InterruptedException, IOException {
//Create the Kinesis Video stream if it doesn't exist.
streamOps.createStreamIfNotExist();
getMediaProcessingArguments = GetMediaProcessingArguments.create();
try (GetMediaProcessingArguments getMediaProcessingArgumentsLocal = getMediaProcessingArguments) {
//Start a GetMedia worker to read and process data from the Kinesis Video Stream.
GetMediaWorker getMediaWorker = GetMediaWorker.create(getRegion(), getCredentialsProvider(), getStreamName(), new StartSelector().withStartSelectorType(StartSelectorType.NOW), amazonKinesisVideo, getMediaProcessingArgumentsLocal.getMkvElementVisitor());
executorService.submit(getMediaWorker);
if (!noSampleInputRequired) {
//Start a PutMedia worker to write data to a Kinesis Video Stream.
putMediaWorker = PutMediaWorker.create(getRegion(), getCredentialsProvider(), getStreamName(), inputStream, amazonKinesisVideo);
executorService.submit(putMediaWorker);
}
//Wait for the workers to finish.
executorService.shutdown();
executorService.awaitTermination(120, TimeUnit.SECONDS);
if (!executorService.isTerminated()) {
log.warn("Shutting down executor service by force");
executorService.shutdownNow();
} else {
log.info("Executor service is shutdown");
}
}
}
public long getFragmentsPersisted() {
return putMediaWorker.getNumFragmentsPersisted();
}
public long getFragmentsRead() {
return getMediaProcessingArguments.getFragmentCount();
}
private static class LogVisitor extends MkvElementVisitor {
private final FragmentMetadataVisitor fragmentMetadataVisitor;
private long fragmentCount = 0;
@Override
public void visit(MkvStartMasterElement startMasterElement) throws MkvElementVisitException {
if (MkvTypeInfos.EBML.equals(startMasterElement.getElementMetaData().getTypeInfo())) {
fragmentCount++;
log.info("Start of segment {} ", fragmentCount);
}
}
@Override
public void visit(MkvEndMasterElement endMasterElement) throws MkvElementVisitException {
if (MkvTypeInfos.SEGMENT.equals(endMasterElement.getElementMetaData().getTypeInfo())) {
log.info("End of segment {} fragment # {} millisBehindNow {} ", fragmentCount, fragmentMetadataVisitor.getCurrentFragmentMetadata().get().getFragmentNumberString(), fragmentMetadataVisitor.getMillisBehindNow().getAsLong());
}
}
@Override
public void visit(MkvDataElement dataElement) throws MkvElementVisitException {
}
@SuppressWarnings("all")
public LogVisitor(final FragmentMetadataVisitor fragmentMetadataVisitor) {
this.fragmentMetadataVisitor = fragmentMetadataVisitor;
}
@SuppressWarnings("all")
public long getFragmentCount() {
return this.fragmentCount;
}
}
private static class GetMediaProcessingArguments implements Closeable {
private final BufferedOutputStream outputStream;
private final LogVisitor logVisitor;
private final CompositeMkvElementVisitor mkvElementVisitor;
public GetMediaProcessingArguments(BufferedOutputStream outputStream, LogVisitor logVisitor, CompositeMkvElementVisitor mkvElementVisitor) {
this.outputStream = outputStream;
this.mkvElementVisitor = mkvElementVisitor;
this.logVisitor = logVisitor;
}
public static GetMediaProcessingArguments create() throws IOException {
//Fragment metadata visitor to extract Kinesis Video fragment metadata from the GetMedia stream.
FragmentMetadataVisitor fragmentMetadataVisitor = FragmentMetadataVisitor.create();
//A visitor used to log as the GetMedia stream is processed.
LogVisitor logVisitor = new LogVisitor(fragmentMetadataVisitor);
//An OutputSegmentMerger to combine multiple segments that share track and ebml metadata into one
//mkv segment.
OutputStream fileOutputStream = Files.newOutputStream(Paths.get("kinesis_video_example_merged_output2.mkv"), StandardOpenOption.WRITE, StandardOpenOption.CREATE);
BufferedOutputStream outputStream = new BufferedOutputStream(fileOutputStream);
OutputSegmentMerger outputSegmentMerger = OutputSegmentMerger.createDefault(outputStream);
//A composite visitor to encapsulate the three visitors.
CompositeMkvElementVisitor mkvElementVisitor = new CompositeMkvElementVisitor(fragmentMetadataVisitor, outputSegmentMerger, logVisitor);
return new GetMediaProcessingArguments(outputStream, logVisitor, mkvElementVisitor);
}
@Override
public void close() throws IOException {
outputStream.close();
}
public long getFragmentCount() {
return logVisitor.fragmentCount;
}
@SuppressWarnings("all")
public CompositeMkvElementVisitor getMkvElementVisitor() {
return this.mkvElementVisitor;
}
}
@SuppressWarnings("all")
public static class KinesisVideoExampleBuilder {
@SuppressWarnings("all")
private Regions region;
@SuppressWarnings("all")
private String streamName;
@SuppressWarnings("all")
private AWSCredentialsProvider credentialsProvider;
@SuppressWarnings("all")
private InputStream inputVideoStream;
@SuppressWarnings("all")
private boolean noSampleInputRequired;
@SuppressWarnings("all")
KinesisVideoExampleBuilder() {
}
/**
* @return {@code this}.
*/
@SuppressWarnings("all")
public KinesisVideoExample.KinesisVideoExampleBuilder region(final Regions region) {
this.region = region;
return this;
}
/**
* @return {@code this}.
*/
@SuppressWarnings("all")
public KinesisVideoExample.KinesisVideoExampleBuilder streamName(final String streamName) {
this.streamName = streamName;
return this;
}
/**
* @return {@code this}.
*/
@SuppressWarnings("all")
public KinesisVideoExample.KinesisVideoExampleBuilder credentialsProvider(final AWSCredentialsProvider credentialsProvider) {
this.credentialsProvider = credentialsProvider;
return this;
}
/**
* @return {@code this}.
*/
@SuppressWarnings("all")
public KinesisVideoExample.KinesisVideoExampleBuilder inputVideoStream(final InputStream inputVideoStream) {
this.inputVideoStream = inputVideoStream;
return this;
}
/**
* @return {@code this}.
*/
@SuppressWarnings("all")
public KinesisVideoExample.KinesisVideoExampleBuilder noSampleInputRequired(final boolean noSampleInputRequired) {
this.noSampleInputRequired = noSampleInputRequired;
return this;
}
@SuppressWarnings("all")
public KinesisVideoExample build() {
return new KinesisVideoExample(this.region, this.streamName, this.credentialsProvider, this.inputVideoStream, this.noSampleInputRequired);
}
@Override
@SuppressWarnings("all")
public String toString() {
return "KinesisVideoExample.KinesisVideoExampleBuilder(region=" + this.region + ", streamName=" + this.streamName + ", credentialsProvider=" + this.credentialsProvider + ", inputVideoStream=" + this.inputVideoStream + ", noSampleInputRequired=" + this.noSampleInputRequired + ")";
}
}
@SuppressWarnings("all")
public static KinesisVideoExample.KinesisVideoExampleBuilder builder() {
return new KinesisVideoExample.KinesisVideoExampleBuilder();
}
}