⚠️ IMPORTANT ⚠️ This repository is no longer actively maintained and will be archived at the end of 2022
For a more scalable multi-platform solution using Amazon IVS Chat, refer to the following repositories:
Amazon IVS Simple Chat demo
A demo web application intended as an educational tool for demonstrating how you can build a very simple Chat backend. In conjunction with Amazon IVS, it can be used to build a compelling customer experience for live streams with chat use-cases.
This project is intended for education purposes only and not for production usage.
This is a serverless web application, leveraging Amazon IVS, AWS Lambda, and WebSockets. The web user interface is a single page application built using responsive web design frameworks and techniques, producing a native app-like experience tailored to the user's device.
The demo showcases how you can implement a simple chat client next to an Amazon IVS stream. Viewers are asked to enter their name the first time they begin chatting. Messages are sent in the format <Username> <Message> as part of each chat "bubble". Chat users can send plain text messages, text links, and emojis. Chat messages have a character limit of 510 characters.
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).
- If you do not have an AWS account, please see How do I create and activate a new Amazon Web Services account?
- Log into the AWS console if you are not already. 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.
- Test locally or deploy to your AWS account. The CloudFormation template will automate the serverless backend and Amazon IVS channel creation.
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.
- Amazon IVS docs
- User Guide
- API Reference
- Setting Up for Streaming with Amazon Interactive Video Service
- Learn more about Amazon IVS on IVS.rocks
- View more demos like this
Security
See CONTRIBUTING for more information.
License
This library is licensed under the MIT-0 License. See the LICENSE file.