Skip to content

This repository shows how you can build a web dashboard to edit and send TimedMetadata events to Amazon IVS Channels.

License

Notifications You must be signed in to change notification settings

aws-samples/amazon-ivs-putmetadata-dashboard-web-demo

Amazon IVS PutMetaData Dashboard demo

A demo web application intended as an educational tool to demonstrate how to implement and use a PutMetadata dashboard to send TimedMetadata JSON payloads to Amazon IVS channels.

Amazon IVS PutMetadata Dashboard demo

This project is intended for education purposes only and not for production usage.

This is a serverless web application, leveraging Amazon IVS, AWS Lambda, API Gateway and DynamoDB. The client application is a javascript webapp built on reactjs.

This demo is intended to help Amazon IVS customers send JSON TimedMetadata to their live channels. Data is sent using the PutMetadata API, which inserts the data into a video stream.

TimedMetadata is useful because it is synchronized with the audio and video frames. During playback, all viewers of the stream receive the data at the same time relative to the stream. The timecode serves as a cue point, which can be used to trigger an action based on the data, such as:

Getting Started

IMPORTANT NOTE: Deploying this demo application in your AWS account will create and consume AWS resources, which will cost money.

This demo is comprised of two parts: serverless (the demo backend) and web-ui (the demo frontend).

  1. If you do not have an AWS account, create one by following this guide: How do I create and activate a new Amazon Web Services account?
  2. Log into the AWS console if you are not already logged in. Note: If you are logged in as an IAM user, ensure your account has permissions to create and manage the necessary resources and components for this application.
  3. Deploy the serverless app to your AWS account.

Known issues and limitations

  • The application was written for demonstration purposes and not for production use.
  • Currently only tested in the us-west-2 (Oregon) region. Additional regions may be supported depending on service availability.

About Amazon IVS

Amazon Interactive Video Service (Amazon IVS) is a managed live streaming solution that is quick and easy to set up, and ideal for creating interactive video experiences. Learn more.

Security

See CONTRIBUTING for more information.

License

This library is licensed under the MIT-0 License. See the LICENSE file.