Skip to content

This repository contains a social real-time application for Android devices. The app leverages Amazon IVS Real-time streaming and uses the Amazon IVS Broadcast SDK for the video and audio-only experiences.

License

aws-samples/amazon-ivs-real-time-for-android-demo

Repository files navigation

Amazon IVS Real-time for Android Demo

A demo Android application in Kotlin intended as an educational tool to demonstrate how you can build a feed of real-time streams and audio rooms with Amazon IVS.

A screenshot of the demo application running on an Android phone.

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

Prerequisites

You must deploy the Amazon IVS Real-time Serverless Demo. After deploying the serverless demo, note the outputs: QR code, Customer ID and API key.

Setup

  1. Clone the repository to your local machine.
  2. Open the repository in Android Studio, or an IDE of your choice.
  3. Run the application on an emulated device or a physical device running API level 33 or later.
  4. When prompted, scan the QR code from the Amazon IVS Real-time Serverless Demo.
  • If you are unable to scan the QR code, paste the combined Customer ID and API key in this format: {Customer ID}-{API key} when prompted in the app. For example: a1bcde23456f7g-abcDeFghIQaTbTxd0T95

IMPORTANT NOTE: Joining a stage in the app will create and consume AWS resources, which will cost money.

Known Issues

  • This app has only been tested on devices running Android 13 and API level 33 or later. While this app may work on older versions of Android, they have not been extensively tested.
  • A list of known issues for the Amazon IVS Broadcast SDK is available on the following page: Amazon IVS Broadcast SDK: Android Guide

More Documentation

License

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

About

This repository contains a social real-time application for Android devices. The app leverages Amazon IVS Real-time streaming and uses the Amazon IVS Broadcast SDK for the video and audio-only experiences.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages