Info

Don't use this library yet. It is still WIP. iOS is ready but Android recycling support is still missing.

Amazon IVS React Native Player Extended

This package provides native binding for the Amazon IVS Player for iOS and Android. It is based on the amazon-ivs-react-native package, but aims to ship features and PRs more rapidly as the official repository often lags behind. Moreover, this package offers greater flexibility, enabling the use of the IVS Player in a variety of ways. It supports FlashList and strives to handle recycling cases more effectively, taking inspiration from expo-image. (coming soon)

Installation

install amazon-ivs-react-native-player-extended dependency using yarn or npm

npm install amazon-ivs-react-native-player-extended

install pods for your ios project. Go to ios directory and run

pod install

Usage

import IVSPlayer from 'amazon-ivs-react-native-player-extended';

const URL =
  'https://fcc3ddae59ed.us-west-2.playback.live-video.net/api/video/v1/us-west-2.893648527354.channel.DmumNckWFTqz.m3u8';

function App() {
  return <IVSPlayer streamUrl={URL} />;
}

A more detailed guide about usage can be found here

IVSPlayer component

IVSPlayer is a component that can render a video stream based on the passed URL.

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

Troubleshooting

To hide Home Indicator on iOS when video is in full screen, use this library: https://github.com/flowkey/react-native-home-indicator

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.

hirbod/amazon-ivs-react-native-player-extended