Amazon Kinesis Video Streams - AWS Documentation

1 Amazon Kinesis Video StreamsDeveloper GuideAmazon Kinesis Video Streams Developer GuideAmazon Kinesis Video Streams : Developer GuideCopyright 2020 Amazon Web Services, Inc. and/or its affiliates. All rights 's trademarks and trade dress may not be used in connection with any product or service that is notAmazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages ordiscredits Amazon . All other trademarks not owned by Amazon are the property of their respective owners, who mayor may not be affiliated with, connected to, or sponsored by Kinesis Video Streams Developer GuideTable of ContentsWhat Is Amazon Kinesis Video Streams ? .. 1 Are You a First-Time User of Kinesis Video Streams ? .. 2 System Requirements .. 3 Camera Requirements .. 3 Tested Cameras .. 3 Tested Operating Systems .. 4 SDK Storage Requirements.

2 4 How It Works .. 5 API and Producer Libraries .. 6 Kinesis Video Streams API .. 6 Producer Libraries .. 8 Video Playback .. 9 Video Playback with HLS .. 9 Video Playback with MPEG-DASH .. 12 Using Streaming Metadata .. 15 Adding Metadata to a Kinesis Video Stream .. 16 Consuming Metadata Embedded in a Kinesis Video Stream .. 17 Streaming Metadata Limitations .. 18 Data 18 Stream Header Elements .. 19 Stream Track Data .. 22 Frame Header Elements .. 23 MKV Frame Data .. 23 Getting Started .. 24 Step 1: Set Up an Account .. 24 Sign Up for AWS .. 24 Create an Administrator IAM User .. 25 Create an AWS Account Key .. 25 Next Step .. 25 Step 2: Create a Kinesis Video Stream .. 26 Create a Video Stream Using the Console .. 26 Create a Video Stream Using the AWS CLI .. 26 Next Step .. 26 Step 3: Send Data to a Kinesis Video Stream .. 26 Download the C++ Producer SDK.

3 27 Compile the GStreamer Example .. 27 Run the GStreamer Example .. 27 Consume Media 28 Next Step .. 29 What's Next? .. 29 Security .. 30 Data Protection .. 30 What Is Server-Side Encryption for Kinesis Video Streams ? .. 31 Costs, Regions, and Performance Considerations .. 31 How Do I Get Started with Server-Side Encryption? .. 31 Creating and Using User-Generated AWS KMS master Keys .. 32 Permissions to Use User-Generated AWS KMS master Keys .. 32 Controlling Access to Kinesis Video Streams Resources Using IAM .. 33 Policy Syntax .. 34 Actions for Kinesis Video Streams .. 34 Amazon Resource Names (ARNs) for Kinesis Video Streams .. 35 Granting Other IAM Accounts Access to a Kinesis Video Stream .. 35 Example Policies .. 36 Controlling Access to Kinesis Video Streams Resources Using AWS IoT .. 37iiiAmazon Kinesis Video Streams Developer GuideIoT ThingName as Stream Name.

4 38 IoT CertificateId as Stream Name .. 43 Compliance Validation .. 43 Resilience .. 44 Infrastructure Security .. 44 Security Best Practices .. 44 Implement least privilege access .. 45 Use IAM roles .. 45 Use CloudTrail to Monitor API Calls .. 45 Producer Libraries .. 46 Kinesis Video Streams Producer Client .. 46 Kinesis Video Streams Producer Library .. 47 Related Topics .. 47 Java Producer Library .. 47 Procedure: Using the Java Producer SDK .. 48 Step 1: Download and Configure the Code .. 48 Step 2: Write and Examine the Code .. 49 Step 3: Run and Verify the Code .. 50 Android Producer Library .. 51 Procedure: Using the Android Producer SDK .. 51 Step 1: Download and Configure the Code .. 52 Step 2: Examine the 54 Step 3: Run and Verify the Code .. 55C++ Producer Library .. 56 Object Model .. 56 Putting Media into the Stream .. 56 Callback Interfaces.

5 56 Procedure: Using the C++ Producer SDK .. 57 Step 1: Download and Configure the Code .. 59 Step 2: Write and Examine the Code .. 59 Step 3: Run and Verify the Code .. 64 Using the C++ Producer SDK as a GStreamer Plugin .. 65 Using the C++ Producer SDK as a GStreamer Plugin in a Docker Container .. 65 Using the C++ Producer SDK on Windows .. 65 Using the C++ Producer SDK on Raspberry Pi .. 70 Using 75C Producer Library .. 76 Object Model .. 76 Putting Media Into the Stream .. 77 Procedure: Using the C Producer SDK .. 77 Step 1: Download the Code .. 79 Step 2: Write and Examine the Code .. 79 Step 3: Run and Verify the Code .. 81 Reference .. 82 Producer SDK Limits .. 82 Error Code Reference .. 84 NAL Adaptation Flags .. 108 Producer Structures .. 108 Stream Structures .. 122 Stream Parser Library .. 128 Procedure: Using the Kinesis Video Stream Parser Library.

6 128 Prerequisites .. 128 Step 1: Download and Configure the Code .. 129 Next Step .. 129 Step 2: Write and Examine the Code .. 129ivAmazon Kinesis Video Streams Developer GuideStreamingMkvReader .. 129 FragmentMetadataVisitor .. 130 OutputSegmentMerger .. 132 Next Step .. 134 Step 3: Run and Verify the Code .. 135 Examples: Sending Data to Kinesis Video Streams .. 135 Examples: Retrieving Data from Kinesis Video Streams .. 135 Examples: Playing Back Video Data .. 135 Prerequisites .. 135 GStreamer .. 136 Download, Build, and Configure the GStreamer Element .. 137 Run the GStreamer Element .. 137 Launch 137 Run the GStreamer Element in a Docker Container .. 139 Parameter Reference .. 141 PutMedia 144 Step 1: Download and Configure the Code .. 145 Step 2: Write and Examine the Code .. 145 Step 3: Run and Verify the Code .. 147 RTSP and Docker .. 148 Prerequisites.

7 148 Build the Docker Image .. 148 Run the RTSP Example 148 Renderer .. 149 Prerequisites .. 149 Running the Renderer Example .. 149 How It Works .. 150 Amazon SageMaker .. 151 Prerequisites .. 152 Creating the Application .. 152 Monitoring the 154 Extending the Application .. 155 Cleaning up the 157 Monitoring Metrics with CloudWatch .. 157 CloudWatch Metrics Guidance .. 164 Logging API Calls with CloudTrail .. 167 Kinesis Video Streams and CloudTrail .. 167 Example: Amazon Kinesis Video Streams Log File Entries .. 171 Control Plane API limits .. 171 Media and Archived Media API limits .. 172 Troubleshooting .. 175 Troubleshooting General Issues .. 175 Latency too high .. 175 Troubleshooting API Issues .. 175 Error: "Unknown options" .. 176 Error: "Unable to determine service/operation name to be authorized" .. 176 Error: "Failed to put a frame in the stream".

8 176 Error: "Service closed connection before final AckEvent was received" .. 176 Error: "STATUS_STORE_OUT_OF_MEMORY" .. 177 Troubleshooting HLS Issues .. 177 Retrieving HLS streaming session URL succeeds, but playback fails in Video player .. 177 Latency too high between producer and player .. 178 Troubleshooting Java Issues .. 178vAmazon Kinesis Video Streams Developer GuideEnabling Java logs .. 179 Troubleshooting Producer Library Issues .. 179 Cannot compile the Producer SDK .. 180 Video stream does not appear in the console .. 180 Error: "Security token included in the request is invalid" when streaming data using theGStreamer demo application .. 180 Error: "Failed to submit frame to Kinesis Video client" .. 180 GStreamer application stops with "streaming stopped, reason not-negotiated" message on OSX .. 181 Error: "Failed to allocate heap" when creating Kinesis Video Client in GStreamer demo onRaspberry Pi.

9 181 Error: "Illegal Instruction" when running GStreamer demo on Raspberry Pi .. 181 Camera fails to load on Raspberry Pi .. 181 Camera can't be found on macOS High Sierra .. file not found when compiling on macOS High Sierra .. 182 Curl errors when running the GStreamer demo application .. 182 Timestamp/range assertion at runtime on Raspberry Pi .. 182 Assertion on gst_value_set_fraction_range_full on Raspberry Pi .. 183 STATUS_MKV_INVALID_ANNEXB_NALU_IN_FRAME_ DATA (0x3200000d) error on Android .. 183 Maximum Fragment Duration Was Reached Error .. 183"Invalid thing name passed" error when using IoT authorization .. 183 Troubleshooting Stream Parser Library Issues .. 184 Cannot access a single frame from the stream .. 184 Fragment decoding error .. 184 Document History .. 185 API Reference .. 188 Actions .. 188 Amazon Kinesis Video Streams .. 189 Amazon Kinesis Video Streams Media.

10 244 Amazon Kinesis Video Streams Archived Media .. 255 Amazon Kinesis Video Signaling Channels .. 281 Data Types .. 287 Amazon Kinesis Video Streams .. 287 Amazon Kinesis Video Streams Media .. 298 Amazon Kinesis Video Streams Archived Media .. 300 Amazon Kinesis Video Signaling Channels .. 309 Common Errors .. 311 Common Parameters .. 312viAmazon Kinesis Video Streams Developer GuideWhat Is Amazon Kinesis VideoStreams? Amazon Kinesis Video Streams is a fully managed AWS service that you can use to stream live Video fromdevices to the AWS Cloud, or build applications for real-time Video processing or batch-oriented Video Streams isn't just storage for Video data. You can use it to watch your Video Streams in realtime as they are received in the cloud. You can either monitor your live Streams in the AWS ManagementConsole, or develop your own monitoring application that uses the Kinesis Video Streams API library todisplay live can use Kinesis Video Streams to capture massive amounts of live Video data from millions ofsources, including smartphones, security cameras, webcams, cameras embedded in cars, drones, andother sources.