What is the ListFragments API?

You can use the ListFragments API to return a list of Fragments from the specified video stream and start location - using the fragment number or timestamps - within the retained data.

What is the Kinesis Video Streams Producer SDK?

The Amazon Kinesis Video Streams Producer SDK are a set of easy-to-use and highly configurable libraries that you can install and customize for your specific producers. The SDK makes it easy to build an on-device application that securely connects to a video stream, and reliably publishes video and other media data to Kinesis Video Streams. It takes care of all the underlying tasks required to package the frames and fragments generated by the device's media pipeline. The SDK also handles stream creation, token rotation for secure and uninterrupted streaming, processing acknowledgements returned by Kinesis Video Streams, and other tasks.

How does Kinesis Video Streams bill for data stored in streams?

Kinesis Video Streams will charge you for total amount of data durably stored under any given stream. The total amount of stored data per video stream can be controlled using retention hours.

How much does it cost to use server-side encryption?

When you apply server-side encryption, you are subject to AWS KMS API usage and key costs. Unlike custom AWS KMS keys, the (Default) aws/kinesis-video KMS key is offered free of charge. However, you still pay for the API usage costs that Kinesis Video Streams incurs on your behalf. API usage costs apply for every KMS key, including custom ones. Kinesis Video Streams calls AWS KMS approximately every 45 minutes when it is rotating the data key. In a 30-day month, the total cost of AWS KMS API calls that are initiated by a Kinesis Video Streams stream should be less than a few dollars. This cost scales with the number of user credentials that you use on your data producers and consumers because each user credential requires a unique API call to AWS KMS.

What is the delay in the playback of video on the Kinesis Video Streams management console?

For a producer that is transmitting video data into the video stream, you will experience a 2 - 10 second lag in the live playback experience in the Kinesis Video Streams management console. The majority of the latency is added by the producer device as it accumulates frames into fragments before it transmits data over the internet. Once the data enters into the Kinesis Video Streams endpoint and you request playback, the console will get H.264 media type fragments from the durable storage, trans-package the fragments into a media format suitable for playback across different internet browsers. The trans-packaged media content will then be transferred to your location where you requested the playback from over the internet.

What can I build using Kinesis Video Streams WebRTC capability?

With Kinesis Video Streams WebRTC, you can easily build applications for live media streaming or real-time audio or video interactivity between camera IoT devices, web browsers, and mobile devices for usecases such as helping parents keep an eye on their baby’s room, enable home-owners use a video doorbell to check who’s at the door, allow owners of camera-enabled robot vacuums to remotely control the robot by viewing the live camera stream on a mobile phone, and much more.

A producer is a general term used to refer to a device or source that puts data into a Kinesis video stream. A producer can be any video-generating device, such as a security camera, a body-worn camera, a smartphone camera, or a dashboard camera. A producer can also send non-video time-encoded data, such as audio feeds, images, or RADAR data. One producer can generate one or more video streams. For example, a video camera can push video data to one Kinesis video stream and audio data to another.

What are common use cases for Kinesis Video Streams?

Kinesis Video Streams is ideal for building media streaming applications for camera-enabled IoT devices and for building real-time computer vision-enabled ML applications that are becoming prevalent in a wide range of use cases such as the following: Smart Home With Kinesis Video Streams, you can easily stream video and audio from camera-equipped home devices such as baby monitors, webcams, and home surveillance systems to AWS. You can then use the streams to build a variety of smart home applications ranging from simple media playback to intelligent lighting, climate control systems, and security solutions. Smart City Many cities have installed large numbers of cameras at traffic lights, parking lots, shopping malls, and just about every public venue, capturing video 24/7. You can use Kinesis Video Streams to securely and cost-effectively ingest, store, playback, and analyze this massive volume of media data to help solve traffic problems, help prevent crime, dispatch emergency responders, and much more. Industrial Automation You can use Kinesis Video Streams to collect a variety of time-encoded data such as RADAR and LIDAR signals, temperature profiles, and depth data from industrial equipment. You can then analyze the data using your favorite machine learning framework including Apache MxNet, TensorFlow, and OpenCV for industrial automation use cases like predictive maintenance. For example, you can predict the lifetime of a gasket or valve and schedule part replacement in advance, reducing downtime and defects in a manufacturing line.

How am I charged for using Kinesis Video Streams WebRTC capability?

For using the Amazon Kinesis Video Streams WebRTC capability, you are charged based on the number of signaling channels that are active in a given month, number of signaling messages sent and received, and TURN streaming minutes used for relaying media. A signaling channel is considered active in a month if at any time during the month a device or an application connects to it. TURN streaming minutes are metered in 1 minute increments. Please see the pricing page for more details.

How long can I store data in Kinesis Video Streams?

You can store data in their streams for as long as you like. Kinesis Video Streams allows you to configure the data retention period to suit your archival and storage requirements.

In which programming platforms is the Kinesis Video Streams Producer SDK available?

Kinesis Video Streams Producer SDK's core is built in C, so it is efficient and portable to a variety of hardware platforms. Most developers will prefer to use the C, C++ or Java versions of the Kinesis Video Streams producer SDK. There is also an Android version of the producer SDK for mobile app developers who want to stream video data from Android devices.

How do I get started with Kinesis Video Streams WebRTC capability?

You can get started by building and running the sample applications in the Kinesis Video Streams SDKs for WebRTC available for Web browsers, Android or iOS based mobile devices, and for Linux, Raspbian, and MacOS based IoT devices. You can also run a quick demo of this capability in the Kinesis Video Streams management console by creating a signaling channel, and running the demo application to live stream audio and video from your laptop’s built-in camera and microphone.

Consumers are your custom applications that consume and process data in Kinesis video streams in real time, or after the data is durably stored and time-indexed when low latency processing is not required. You can create these consumer applications to run on Amazon EC2 instances. You can also use other Amazon AI services such as Amazon Rekognition, or third party video analytics providers to process your video streams.

What are the available playback modes for HLS or DASH streaming in Kinesis Video Streams?

There are two different playback modes supported by both HLS and DASH: Live and On Demand. LIVE: For live sessions, the HLS media playlist is continually updated with the latest fragments as they become available. When this type of session is played in a media player, the user interface typically displays a "live" notification, with no scrubber control for choosing the position in the playback window to display. ON DEMAND: For on-demand, the HLS media playlist contains all the fragments for the session, up to the number that is specified in MaxMediaPlaylistFragmentResults. The playlist can only be retrieved once for each session. Additionally, HLS also supports playback in LIVE_REPLAY mode. In this mode, the HLS media playlist is updated similarly to how it is updated for LIVE mode except that it starts by including fragments from a given start time. This mode is useful for cases when you want to start playback from a point in the past from stored media and continue into live streaming.

What is the Kinesis Video Streams parser library?

The Kinesis Video Streams parser library makes it easy for developers to consume and process the output of Kinesis Video Streams GetMedia operation. Application developers will include the library in their video analytics and processing applications that operate on video streams. The applications themselves will run on your EC2 instances, although they can be run elsewhere. The library has features that make it easy to get a frame-level object and its associated metadata, extract and collect Kinesis Video Streams-specific metadata attached to fragments, and consecutive fragments. You can then build custom applications that can more easily use the raw video data for your use cases.

What should I be aware of before getting started with the Kinesis Video Streams producer SDK?

The Kinesis Video Streams producer SDK does all the heavy lifting of packaging frames and fragments, establishes a secure connection, and reliably streams video to AWS. However there are many different varieties of hardware devices and media pipelines running on them. To make the process of integration with the media pipeline easier, we recommend having some knowledge of: 1) the frame boundaries, 2) the type of a frame used for the boundaries, I-frame or non I-frame, and 3) the frame encoding time stamp.

What is a Signaling Channel?

A signaling channel is a resource that enables applications to discover, set up, control, and terminate a peer-to-peer connection by exchanging signaling messages. Signaling messages are metadata that two applications exchange with each other to establish peer-to-peer connectivity. This metadata includes local media information such as media codecs and codec parameters, and possible network candidate paths for the two applications to connect with each other for live streaming.

Upon receiving the data from a producer, Kinesis Video Streams stores incoming media data as chunks. Each chunk consists of the actual media fragment, a copy of media metadata sent by the producer, and the Kinesis Video Streams-specific metadata such as the fragment number, and server-side and producer-side timestamps. When a consumer requests media data through the GetMedia API operation, Kinesis Video Streams returns a stream of chunks, starting with the fragment number that you specify in the request.

If I have a custom processing application that needs to use the frames (and fragments) carried by the Kinesis video stream, how do I do that?

In general, if you want to consume video streams and then manipulate them to fit your custom application's needs, then there are two key steps to consider. First, get the bytes in a frame from the formatted stream vended by the GetMedia API. You can use the stream parser library to get the frame objects. Next, get the metadata necessary to decode a frame such as the pixel height, width, codec id, and codec private data. Such metadata is embedded in the track elements. The parser library makes extracting this information easier by providing helper classes to collect the track information for a fragment. The steps after this are highly application dependent. You may wish to decode frames, format them for a playback engine, transcode them for content distribution, or feed them into a custom deep learning application format. The Kinesis Video Streams stream parser library is open-sourced so that you can extend it for your specific use cases.

How do applications use a signaling channel to enable peer-to-peer connectivity?

Streaming applications can maintain persistent connectivity with a signaling channel and wait for other applications to connect to them or they can connect to a signaling channel only when they need to live stream media. The signaling channel enables applications to connect with each other in a one to few model using the concept of one master connecting to multiple viewers. The application that initiates the connection assumes the responsibility of a master via the ConnectAsMaster API and wait for viewers. Upto 10 applications can then connect to that signaling channel by assuming the viewer responsibility via the ConnectAsViewer API. Once connected to the signaling channel, the master and viewer applications can send each other signaling messages to establish peer-t0-peer connectivity for live media streaming.

How do I think about latency in Amazon Kinesis Video Streams?

There are four key contributors to latency in an end-to-end media data flow. Time spent in the device’s hardware media pipeline: This pipeline can comprise of the image sensor and any hardware encoders as appropriate. In theory, this can be as little as a single frame duration. In practice it rarely is. All encoders in order to work effectively for media encoding (compression) will accumulate several frames to construct a fragment. This process and any corresponding motion compensation algorithms will add anywhere from one second to several seconds of latency on the device before the data is packaged for transmission. Latency incurred on actual data transmission on the internet: The quality of the network throughput and latency can vary significantly based on where the producing device is located. Latency added by the Kinesis Video Streams as it receives data from the producer device: The incoming data is made available immediately on the GetMedia API operation for any consuming application. If you choose to retain data, then Kinesis Video Streams will ensure that the data is encrypted using AWS Key Management Service (AWS KMS) and generate a time-based index on the individual fragments in the video stream. When you access this retained data using the GetMediaforFragmentList API, Kinesis Video Streams fetches the fragments from durable storage, decrypt the data, and make it available for the consuming application. Time latency on data transmission back to the consumer: There can be consuming devices on the internet or other AWS regions that request the media data. The quality of the network throughput and latency can vary significantly based on where the consuming device is located.

What is the delay in the playback of video using the API?

The latency for live playback is typically between 3 and 5 seconds, but this could vary. We strongly recommend running your own tests and proof-of-concepts to determine the target latencies. There are a variety of factors that impact latencies, including the use case, how the producer generates the video fragments, the size of the video fragment, the player tuning, and network conditions both streaming into AWS and out of AWS for playback. For low-latency playback, see the FAQs on WebRTC–based streaming.

How do applications live stream peer-to-peer media when they are located behind a NAT or a firewall?

Applications use Kinesis Video Streams STUN end point to discover their public IP address when they are located behind a NAT or a firewall. An application provides its public IP address as a possible location where it can receive connection requests from other applications for live streaming. The default option for all WebRTC communication is direct peer-to-peer connectivity but if the NAT or firewall does now allow direct connectivity (e.g. in case of symmetric NATs), applications can connect to the Kinesis Video Streams TURN end points for relaying media via the cloud. The GetIceServerConfig API provides the necessary TURN end point information that applications can use in their WebRTC configuration. This configuration allows applications to use TURN relay as a fallback when they are unable to establish a direct peer-to-peer connection for live streaming.

What are the relevant limits to using HLS or DASH?

A Kinesis video stream supports a maximum of ten active HLS or DASH streaming sessions. If a new session is created when the maximum number of sessions is already active, the oldest (earliest created) session is closed. The number of active GetMedia connections on a Kinesis video stream does not count against this limit, and the number of active HLS sessions does not count against the active GetMedia connection limit. See Kinesis Video Streams Limits for more details.

How does Kinesis Video Streams secure the live media streaming with WebRTC?

End to end encryption is a mandatory feature of WebRTC, and Kinesis Video Streams enforces it on all the components, including signaling and media or data streaming. Regardless of whether the communication is peer-to-peer or relayed via Kinesis Video Streams TURN end points, all WebRTC communications are securely encrypted through standardized encryption protocols. The signaling messages are exchanged using secure Websockets (WSS), data streams are encrypted using Datagram Transport Layer Security (DTLS), and media streams are encrypted using Secure Real-time Transport Protocol (SRTP).

What’s the difference between Kinesis Video Streams and AWS Elemental MediaLive?

AWS Elemental MediaLive is a broadcast-grade live video encoding service. It lets you create high-quality video streams for delivery to broadcast televisions and internet-connected multiscreen devices, like connected TVs, tablets, smart phones, and set-top boxes. The service functions independently or as part of AWS Media Services. Amazon Kinesis Video Streams makes it easy to securely stream video from connected devices to AWS for real-time and batch-driven machine learning (ML), video playback, analytics, and other processing. It enables customers to build machine-vision based applications that power smart homes, smart cities, industrial automation, security monitoring, and more.

Amazon Kinesis Video Streams FAQs

NA"},"metadata":{"tags":[{"id":"GLOBAL#product#kinesis-video","name":"Amazon Kinesis Video Streams","namespaceId":"GLOBAL#product","description":"Amazon Kinesis Video Streams","metadata":{}},{"id":"GLOBAL#pattern#faq","name":"FAQ","namespaceId":"GLOBAL#pattern","description":"FAQ","metadata":{}}]}},{"fields":{"topic":"How do I playback the video captured in my own application?","id":"product-faqs#faq-kinesis-video-streams-playing-1","customSortOrder":"1","content":"

You can use Amazon Kinesis Video Streams’ HTTP Live Streams (HLS) and Dynamic Adaptive Streaming over HTTP (DASH) capabilities to playback the ingested video in fragmented MP4 or MPEG_TS packaged format. HLS and DASH are industry-standard, HTTP-based media streaming protocols. As you capture video from devices using Amazon Kinesis Video Streams, you can use the HLS or DASH APIs to playback live or recorded video. This capability is fully managed, so you do not have to build any cloud-based infrastructure to support video playback. For low-latency playback and two-way media streaming, see the FAQs on WebRTC–based streaming."},"metadata":{"tags":[{"id":"GLOBAL#pattern#faq","name":"FAQ","namespaceId":"GLOBAL#pattern","description":"FAQ","metadata":{}},{"id":"GLOBAL#product#kinesis-video","name":"Amazon Kinesis Video Streams","namespaceId":"GLOBAL#product","description":"Amazon Kinesis Video Streams","metadata":{}},{"id":"product-faqs#kinisis-video-stream-faqs#playing-back-video-from-streams","name":"Playing back video from streams","namespaceId":"product-faqs#kinisis-video-stream-faqs","description":"

Playing back video from streams","metadata":{}}]}},{"fields":{"topic":"What is the GetMedia API?","id":"product-faqs#faq-kinesis-video-streams-reading-1","customSortOrder":"1","content":"

You can use the GetMedia API to retrieve media content from a Kinesis video stream. In the request, you identify stream name or stream Amazon Resource Name (ARN), and the starting chunk. Kinesis Video Streams then returns a stream of chunks in order by fragment number. When you put media data (fragments) on a stream, Kinesis Video Streams stores each incoming fragment and related metadata in what is called a \"chunk.\" The GetMedia API returns a stream of these chunks starting from the chunk that you specify in the request."},"metadata":{"tags":[{"id":"GLOBAL#pattern#faq","name":"FAQ","namespaceId":"GLOBAL#pattern","description":"FAQ","metadata":{}},{"id":"GLOBAL#product#kinesis-video","name":"Amazon Kinesis Video Streams","namespaceId":"GLOBAL#product","description":"Amazon Kinesis Video Streams","metadata":{}},{"id":"product-faqs#kinisis-video-stream-faqs#reading-from-streams","name":"Reading data from streams","namespaceId":"product-faqs#kinisis-video-stream-faqs","description":"

Reading data from streams","metadata":{}}]}},{"fields":{"topic":"How do I publish data to my Kinesis video stream?","id":"product-faqs#faq-kinesis-video-streams-publishing-1","customSortOrder":"1","content":"

You can publish media data to a Kinesis video stream via the PutMedia operation, or use the Kinesis Video Streams Producer SDKs in Java, C++, or Android. If you choose to use the PutMedia operation directly, you will be responsible for packaging the media stream according to the Kinesis Video Streams data specification, handle the stream creation, token rotation, and other actions necessary for reliable streaming of media data to the AWS cloud. We recommend using the Producer SDKs to make these tasks simpler and get started faster."},"metadata":{"tags":[{"id":"GLOBAL#pattern#faq","name":"FAQ","namespaceId":"GLOBAL#pattern","description":"FAQ","metadata":{}},{"id":"GLOBAL#product#kinesis-video","name":"Amazon Kinesis Video Streams","namespaceId":"GLOBAL#product","description":"Amazon Kinesis Video Streams","metadata":{}},{"id":"product-faqs#kinisis-video-stream-faqs#publishing-to-streams","name":"Publishing data to streams","namespaceId":"product-faqs#kinisis-video-stream-faqs","description":"

Publishing data to streams","metadata":{}}]}},{"fields":{"topic":"What does the Amazon Kinesis Video Streams SLA guarantee?","id":"product-faqs#faq-kinesis-video-streams-sla-1","customSortOrder":"1","content":"

Our Amazon Kinesis Video Streams SLA guarantees a Monthly Uptime Percentage of at least 99.9% for Amazon Kinesis Video Streams."},"metadata":{"tags":[{"id":"product-faqs#kinisis-video-stream-faqs#service-level-agreement","name":"Service Level Agreement","namespaceId":"product-faqs#kinisis-video-stream-faqs","description":"

Service Level Agreement","metadata":{}},{"id":"GLOBAL#product#kinesis-video","name":"Amazon Kinesis Video Streams","namespaceId":"GLOBAL#product","description":"Amazon Kinesis Video Streams","metadata":{}},{"id":"GLOBAL#pattern#faq","name":"FAQ","namespaceId":"GLOBAL#pattern","description":"FAQ","metadata":{}}]}},{"fields":{"topic":"Is Amazon Kinesis Video Streams available in AWS Free Tier?","id":"product-faqs#faq-kinesis-video-streams-pricing-1","customSortOrder":"1","content":"

No. Amazon Kinesis Video Streams is not available in AWS Free Tier."},"metadata":{"tags":[{"id":"GLOBAL#product#kinesis-video","name":"Amazon Kinesis Video Streams","namespaceId":"GLOBAL#product","description":"Amazon Kinesis Video Streams","metadata":{}},{"id":"GLOBAL#pattern#faq","name":"FAQ","namespaceId":"GLOBAL#pattern","description":"FAQ","metadata":{}},{"id":"product-faqs#kinisis-video-stream-faqs#pricing-and-billing","name":"Pricing and billing","namespaceId":"product-faqs#kinisis-video-stream-faqs","description":"

Pricing and billing","metadata":{}}]}},{"fields":{"topic":"What Is Server-Side Encryption for Kinesis Video Streams?","id":"product-faqs#faq-kinesis-video-streams-encryption-1","customSortOrder":"1","content":"

Server-side encryption is a feature in Kinesis Video Streams that automatically encrypts data before it's at rest by using an AWS KMS key that you specify. Data is encrypted before it is written to the Kinesis Video Streams storage layer, and it is decrypted after it is retrieved from storage. As a result, your data is always encrypted at rest within the Kinesis Video Streams service."},"metadata":{"tags":[{"id":"GLOBAL#pattern#faq","name":"FAQ","namespaceId":"GLOBAL#pattern","description":"FAQ","metadata":{}},{"id":"GLOBAL#product#kinesis-video","name":"Amazon Kinesis Video Streams","namespaceId":"GLOBAL#product","description":"Amazon Kinesis Video Streams","metadata":{}},{"id":"product-faqs#kinisis-video-stream-faqs#encryption","name":"Encryption","namespaceId":"product-faqs#kinisis-video-stream-faqs","description":"

Encryption","metadata":{}}]}},{"fields":{"topic":"What is the Kinesis Video Streams management console?","id":"product-faqs#faq-kinesis-video-streams-console-1","customSortOrder":"1","content":"

The Kinesis Video Streams management console enables you to create, update, manage, and monitor your video streams. It console can also playback your media streams live or on an on-demand basis, as long as the content in the streams is in the supported media type. Using the player controls, you can view the live stream, skip forwards or backwards 10 seconds, use the date and time picker to rewind to a point in the past when you have set the corresponding retention period for the video stream. The Kinesis Video Streams management console's video playback capabilities are offered as a quick diagnostic tool for development and test scenarios for developers as they build solutions using Kinesis Video Streams."},"metadata":{"tags":[{"id":"GLOBAL#product#kinesis-video","name":"Amazon Kinesis Video Streams","namespaceId":"GLOBAL#product","description":"Amazon Kinesis Video Streams","metadata":{}},{"id":"GLOBAL#pattern#faq","name":"FAQ","namespaceId":"GLOBAL#pattern","description":"FAQ","metadata":{}},{"id":"product-faqs#kinisis-video-stream-faqs#console","name":"Console","namespaceId":"product-faqs#kinisis-video-stream-faqs","description":"

Console","metadata":{}}]}},{"fields":{"topic":"What is WebRTC and how does Kinesis Video Streams support this capability?","id":"product-faqs#faq-kinesis-video-streams-latency-1","customSortOrder":"1","content":"