Receiving a Live Stream With Amazon IVS in React Native

In short

This article introduces the <rte-code>amazon-ivs-react-native-player<rte-code> package, which simplifies the process of adding streaming players to React Native apps. It utilizes Amazon IVS (Interactive Video Service), a managed live streaming solution by AWS, allowing developers to set up live interactive video experiences easily. With just a few lines of code, developers can integrate streaming players without the need for custom native code, thanks to the provided package.

Amazon-ivs-react-native-player

I thought this would require a bunch of custom native code, custom solutions, and basically a bunch of work. But it turns out that some time ago <rte-code>amazon-ivs-react-native-player<rte-code> package got published, and it allows us to add streaming players in just a few lines of code. In this post, I will present how to use this library.

What is Amazon IVS?

But first things first. Let’s start by explaining what Amazon IVS is. It stands for “Interactive Video Service,” and it is a managed live streaming solution offered by Amazon Web Services (AWS). It allows developers to quickly set up live interactive video experiences in their own applications. Amazon IVS is essentially built in the same technology that powers Twitch, one of the world's leading live streaming platforms.

Project setup

I’ll present an example of how you can set up an app and use this library. You can check out the repo containing the whole example app which I’ll build.

To create a stream you will need IVS Channel details. Check how to do it in a guide on getting started with Amazon IVS. There’s also a broadcast stream available e.g. with this Vercel Guide.

You may also check a sample stream; it’s working at the time of writing this article.

For the sake of this article, I’ll create a simple app with React Native CLI:

1. First, we need to run <rte-code>npx react-native@latest init SampleApp<rte-code> to create an app

2. Then we need to run the app on Android or iOS, we can do that simply by running <rte-code>run-ios<rte-code> or <rte-code>run-android<rte-code> commands

screenshot with welcome to React Native

3. Now we need to add some UI; for this, we’ll use react-native-paper library which we maintain at Callstack. I created a simple <rte-code>DashboardScreen<rte-code> with one <rte-code>TextInput<rte-code> for passing URL and <rte-code>Button<rte-code> which will navigate to <rte-code>StreamScreen<rte-code>, which I will create next.

screenshot of DashboardScreen
DashboardScreen

4. In this step we need to implement navigation and add second screen <rte-code>StreamScreen<rte-code>, for navigation I used <rte-code>react-navigation<rte-code> library. <rte-code>StreamScreen<rte-code> will contain stream player. You can check changes for this step in this PR: Pull Request #1.​

5. Then if we want to run app on iOS we need to install Pods, we can do it with:

6. And finally to use this library we need to imports IVSPlayer, and pass the url to stream as <rte-code>streamUrl<rte-code> prop

Now finally we can test it, so here I’m passing a URL to the stream and IVSPlayer component correctly displays stream

Thanks to the <rte-code>amazon-ivs-react-native-player<rte-code> package, you can set up a streaming player with just a few steps without any custom native code. You can also play with the example app that is inside the repository - it contains more complex usage and all props that you can use 🎉 Give it a try!

Latest update:
October 6, 2023

FAQ

No items found.
React Galaxy City
Get our newsletter

By subscribing to the newsletter, you give us consent to use your email address to deliver curated content. We will process your email address until you unsubscribe or otherwise object to the processing of your personal data for marketing purposes. You can unsubscribe or exercise other privacy rights at any time. For details, visit our Privacy Policy.

Callstack astronaut
Download our ebook

I agree to receive electronic communications By checking any of the boxes, you give us consent to use your email address for our direct marketing purposes, including the latest tech & biz updates. We will process your email address and names (if you have entered them into the above form) until you withdraw your consent to the processing of your names, or unsubscribe, or otherwise object to the processing of your personal data for marketing purposes. You can unsubscribe or exercise other privacy rights at any time. For details, visit our Privacy Policy.

By pressing the “Download” button, you give us consent to use your email address to send you a copy of the Ultimate Guide to React Native Optimization.