# Live Stream

![](https://2352509137-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MX0mOAVWkotGme0iRzu%2F-MX6Re7-tRbASr6IDHFT%2F-MX6RqyGv_Z11_GjLppB%2Fimage%20\(4\).png?alt=media\&token=07208f25-f273-4860-a873-7849a5f79354)

{% hint style="warning" %}
There is a limitation to the maximum number of concurrent live events. Reach out to us at[ community.social.plus.co](https://community.amity.co/) with your use-case and we will determine if the current limit can be raised.
{% endhint %}

### Create a stream 

To create a stream, follow the code below. This will return an instance of the created `Stream`.

\
**isSecure**: By setting `isSecure` as  `true` the created stream will be available as `https` url.

{% hint style="info" %}
Note that the TypeScript SDK does not support broadcasting a live stream directly. Instead, it allows the creation of a stream object. You can then retrieve the streaming URL from this object and implement it with a third-party library or a streaming tool like OBS.
{% endhint %}

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/7de66470a4630e01f19864e39c0234f0>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/1d8c8f2000ec3ccb85687e57131aac8b>" %}
{% endtab %}

{% tab title="Typescript" %}
{% embed url="<https://gist.github.com/amythee/75cdb3d62f3d3bb986a66eeb83b9de8e>" %}
{% endtab %}
{% endtabs %}

### Create child streams

The SDK supports creating a post with multiple streams, and the **AmityStream** object maintains the parent–child relationship. In the case of a stream post, only the parent stream will be linked to the post.

To create a child stream that is related to a parent stream, the **parentStreamId** must be passed as a parameter, and the parent stream must be created first.

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/5d92b154be82fbd75dfc10c858ad76c8>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/39145812d944042f502eab53e9dab78e>" %}
{% endtab %}

{% tab title="Typescript" %}
{% embed url="<https://gist.github.com/887be9c7c8f766c719695b8aa823de61>" %}
{% endtab %}
{% endtabs %}

The following fields are added to the **AmityStream** object to specify the relationship:

* **isParent**: `true` if the stream is a parent, `false` if the stream is a child
* **parentStreamId**: the ID of the parent stream
* **childStreamIds**: contains all child streams of the parent stream

To retrieve the child stream objects, we provide the **getChildStreams** property inside the parent stream object.

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/4fb6ad5ded37698551c478ac39931a03>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/455112924bfd62a804be81473925b9b7>" %}
{% endtab %}

{% tab title="Typescript" %}
{% embed url="<https://gist.github.com/4e409d1cd9bc5bf5b621a1797211d63f>" %}
{% endtab %}
{% endtabs %}

### Enable live chat channel and reaction in a stream

The **livestream chat** and **reaction** features are enabled by setting the `channelEnabled` field when creating a stream object.\
These features are supported **only** for livestream posts created within a community.

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/7e76c3813948b784c72d1823d9b79fb1>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/0b0d4ff7de9725a119e8488f04ab66ae>" %}
{% endtab %}

{% tab title="Typescript" %}
{% embed url="<https://gist.github.com/amythee/be1315f1e0b75dc63c7c2d3816a169f8#file-getlivechat-ts>" %}
{% endtab %}
{% endtabs %}

\
After creating a stream post, the stream object will include the following properties to indicate related information:

<pre class="language-json"><code class="lang-json">{
  ...
<strong>  referenceId: 'postId',
</strong>  referenceType: 'post',
  targetId: 'communityId',
  targetType: 'community',
  postId: 'postId',
  channelId: 'channelId',
  channelEnabled: true,
  ...
}
</code></pre>

**Note:** When `getLiveChat()` is called on the **streamer** side, the SDK creates a new live chat channel linked to the stream **if one does not already exist**. On the **viewer** side, calling `getLiveChat()` returns the live chat channel object **only if it has already been created**.

### Delete a stream&#x20;

To delete a stream, you will need the ID of the stream that you want to delete. The function will return true if successfully deleted, otherwise, it will throw an error.

{% tabs %}
{% tab title="Typescript" %}
{% embed url="<https://gist.github.com/amythee/f80fd898ee60c0e078cb41e9843d0b80>" %}
{% endtab %}
{% endtabs %}

### Dispose a stream&#x20;

Disposing a stream means updating the streaming status to ended and invalidating the streaming URL.&#x20;

To dispose a stream, you need the ID of the stream that you want to dispose. The function will return true if successfully deleted, otherwise, it will throw an error.

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/61fd4e82636a161186776440b083aab3>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/a720413f18381aa4c35aa91b3891f76d>" %}
{% endtab %}

{% tab title="Typescript" %}
{% embed url="<https://gist.github.com/amythee/5ec52719ca044545369b9964850c0c41>" %}
{% endtab %}
{% endtabs %}