# Reactoo Watch Together SDK for JavaScript
[Overview](#description)
- [Description](#description)
- [Plugin for OTT providers](#plugin-for-ott-providers)
- [Browser support](#browser-support)
- [API Documentation](#api-documentation)
[Usage](#usage)
- [Installation](#installation)
- [Example](#example)
[Questions and feedback](#questions-and-feedback)
## Description
Reactoo Watch Together SDK for JavaScript provides a rich set of client-side functionality that:
* Enables you to manage and join Watch Together video rooms
* Makes it easy to call Reactoo API directly
* Allows OTT broadcasters to synchronise the live stream
* Capture the reactions of participants to key moments
* Facilitates real-time communication between video room participants when you're implementing custom events
[Reactoo Watch Together](https://reactoo.com) is a technology that allows you to create a video room and invite up to five participants to share the emotion of watching a live video. Those in the room will be able to see, hear and chat while watching the live action, allowing them to debate the talking points and celebrate as if they were all together. The person who sets up the room can invite others by simply sharing a link by text, WhatsApp, email or on social media.
Check out our [API Reference](https://api.reactoo.com/v2/) for more detailed information.
## Plugin for OTT providers
This SDK can be implemented as a plugin for OTT services to deliver an interactive watch together experience for their audiences (a video chat room where all users are synchronized to the live stream so they can see and chat to each other while watching the content). Reactoo also allow this to be broadcast live to others (effectively a multi-party Twitch-style live casting experience) and can capture the reactions of participants to key moments in the stream as they watch which are made available for social sharing.
## Browser support
 |  |  |  |  | 
--- | --- | --- | --- | --- | --- |
56+ ✔ | 44+ ✔ | 43+ ✔ | 67+ ✔ | ❌ | ❌ |
## API documentation
[API Documentation](https://api.reactoo.com/v2/) is hosted on Reactoo API pages, and is generated using [ReDoc](https://github.com/Rebilly/ReDoc) following [OpenAPI Specification](https://swagger.io/docs/specification/about/). We support both [JSON](https://api.reactoo.com/v2/swagger.json) and [YAML](https://api.reactoo.com/v2/swagger.yml) formats.
This SDK does not come bundled with Reactoo API specification as latest version will be fetch on initial SDK load instead.
# Usage
## Installation
Reactoo Watch Together SDK for JavaScript is available from `npm` or `unpkg`.
```bash
npm install --save @reactoo/watchtogether-sdk-js
```
```html
```
## Example
### Join an existing videoroom
```js
let WT = WatchTogetherSDK({ debug: true })({ instanceType: 'reactooDemo' });
WT.auth.deviceLogin()
.then(r => WT.room.createSession({ roomId: "...", pinHash: "..." }))
.then(session => {
session.attachPlayer(hls);
return session.connect().then(() => session.publishLocal())
})
```
### Full example
```html
Reactoo Watch Together - Demo
```
# Questions and feedback
Please raise questions, requests for help etc. via [tech@reactoo.com](mailto:tech@reactoo.com).
Feedback and suggestions for improvement always welcome :)