Skip to content

Add serverside livestreaming docs#115

Merged
Karolk99 merged 5 commits into
mainfrom
livestreaming-docs
May 30, 2025
Merged

Add serverside livestreaming docs#115
Karolk99 merged 5 commits into
mainfrom
livestreaming-docs

Conversation

@Karolk99

Copy link
Copy Markdown
Contributor

Description

Closes FCE-1488

Adds server-side livestreaming documentation.

Things worth doing before merging this PR:

  • rename room type: broadcast -> livestream in server SDKs
  • rename createBroadcastViewerToken to createLivestreamViewerToken in js-server-sdk
  • add client-side docs and link them correctly in server-side docs

@linear

linear Bot commented May 27, 2025

Copy link
Copy Markdown

Comment thread docs/livestreaming.mdx Outdated
Comment thread docs/livestreaming.mdx Outdated
Comment thread docs/livestreaming.mdx Outdated
Comment thread docs/livestreaming.mdx Outdated
Comment thread docs/livestreaming.mdx Outdated
Comment thread docs/livestreaming.mdx Outdated
</TabItem>
</Tabs>

Now, you can connect peer normally to the room as described in our [React Native](/react-native/connecting) and [React](/react/connecting) docs.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (blocking):

Suggested change
Now, you can connect peer normally to the room as described in our [React Native](/react-native/connecting) and [React](/react/connecting) docs.
Now, you can connect the peer normally to the room as described in our [React Native](/react-native/connecting) and [React](/react/connecting) docs.

Comment thread docs/livestreaming.mdx Outdated
</TabItem>
</Tabs>

Now you can connect viewer to the livestream as described in our [React Native] and [React] docs.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (blocking):

Suggested change
Now you can connect viewer to the livestream as described in our [React Native] and [React] docs.
Now you can connect the viewer to the livestream as described in our [React Native] and [React] docs.

Comment thread docs/livestreaming.mdx
Now you can connect viewer to the livestream as described in our [React Native] and [React] docs.

:::info
Viewers connect using [WHEP](https://blog.swmansion.com/introducing-react-native-whip-whep-ac9e5588d4da) standard, allowing the use of any player that supports the WHEP standard.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggestion (blocking): I would link to something different here, and specify that there is React Native whip/whep for the mobile ecosystem.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

something different... like RFC?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

something like our article would be the best, but it's yet to be created :p

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

imo lets not waste time here and approach this incrementally

Comment thread docs/livestreaming.mdx Outdated
<TabItem value="ts" label="Typescript">

```ts
// createdRoom ... previously created room

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

issue (blocking): I would include the required part of the previous snippet with createdRoom init.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It could suggest that you can do it twice, create one room for peer and another for viewer. What do you think?

Comment thread docs/livestreaming.mdx Outdated

### Viewers

To view the streamed content you need to obtain viewer token that can be generated using [Server SDKs](/production/server).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (blocking):

Suggested change
To view the streamed content you need to obtain viewer token that can be generated using [Server SDKs](/production/server).
To view the streamed content you need to obtain a viewer token that can be generated using [Server SDKs](/production/server).

Comment thread docs/livestreaming.mdx
- Compatible with WHEP standard
<!-- * TODO: compatibility with WHIP -->

## How Do I Use It?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (blocking):

Suggested change
## How Do I Use It?
## How do I use it?

Comment thread docs/livestreaming.mdx Outdated
Main differences:

- Livestream rooms are 20% cheaper than regular rooms
- Livestream rooms allows for greater scalability

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (blocking):

Suggested change
- Livestream rooms allows for greater scalability
- Livestream rooms allow for greater scalability

Comment thread docs/livestreaming.mdx Outdated

# Live streaming

For live streaming purposes we suggest using livestream rooms specifically optimized for this use case.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (blocking):

Suggested change
For live streaming purposes we suggest using livestream rooms specifically optimized for this use case.
For livestreaming purposes, we suggest using livestream rooms specifically optimized for this use case.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's correct

Comment thread docs/livestreaming.mdx Outdated

### Streamer

To create a livestream room, you must set the `roomType` field to `broadcaster` when creating a room using our [Server SDKs](/production/server). Then you have to create one peer that will be used to stream your content.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (blocking):

Suggested change
To create a livestream room, you must set the `roomType` field to `broadcaster` when creating a room using our [Server SDKs](/production/server). Then you have to create one peer that will be used to stream your content.
To create a livestream room, you must set the `roomType` field to `broadcaster` when creating a room using our [Server SDKs](/production/server). Then you have to create a peer that will be used to stream your content.

Comment thread docs/livestreaming.mdx Outdated

### Viewers

To view the streamed content you need to obtain viewer token that can be generated using [Server SDKs](/production/server).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (blocking):

Suggested change
To view the streamed content you need to obtain viewer token that can be generated using [Server SDKs](/production/server).
To view the streamed content, you need to obtain viewer token that can be generated using [Server SDKs](/production/server).

@Karolk99 Karolk99 force-pushed the livestreaming-docs branch from f985045 to 239d2c6 Compare May 28, 2025 18:06
@Karolk99 Karolk99 force-pushed the livestreaming-docs branch from 19aaa5e to e0de89e Compare May 29, 2025 14:37
Comment thread docs/livestreaming.mdx
Now you can connect viewer to the livestream as described in our [React Native] and [React] docs.

:::info
Viewers connect using [WHEP](https://blog.swmansion.com/introducing-react-native-whip-whep-ac9e5588d4da) standard, allowing the use of any player that supports the WHEP standard.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

imo lets not waste time here and approach this incrementally

@Karolk99 Karolk99 merged commit 948dd8b into main May 30, 2025
1 check passed
@Karolk99 Karolk99 deleted the livestreaming-docs branch May 30, 2025 07:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants