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 ?

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

3 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 .. 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 ?

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

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

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

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

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

9 147 RTSP and Docker .. 148 Prerequisites .. 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.

10 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" .. 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.