|
| 1 | +# Cloudinary Video Live Streaming (Beta) |
| 2 | + |
| 3 | +Use the Video Live Streaming API to create and manage your RTMP live streams. This includes managing outputs as well as manually starting and stopping streams. See the [live streaming guide](https://cloudinary.com/documentation/video_live_streaming) for information on how to use the Live Streaming API to stream video to your users. |
| 4 | + |
| 5 | + **Note**: The Live Streaming API is currently in development and is available as a Public Beta, which means we value your feedback, so please feel free to [share any thoughts with us](https://support.cloudinary.com/hc/en-us/requests/new). |
| 6 | + |
| 7 | + The API supports Basic Authentication using your Cloudinary API Key and API Secret (which can be found on the Dashboard page of your [Cloudinary Console](https://console.cloudinary.com/pm)). |
| 8 | + |
| 9 | + |
| 10 | +### API Endpoints |
| 11 | + |
| 12 | +All URIs are relative to *https://api.cloudinary.com/v2/CLOUD_NAME/video* |
| 13 | + |
| 14 | +| Class | Method | HTTP request | Description | |
| 15 | +| ------------ | ------------- | ------------- | ------------- | |
| 16 | +*LiveStreamApi* | [**activateLiveStream**](LiveStreamApi.md#activateLiveStream) | **POST** /live_streams/{liveStreamId}/activate | Manually activate a live stream |
| 17 | +*LiveStreamApi* | [**createLiveStream**](LiveStreamApi.md#createLiveStream) | **POST** /live_streams | Create a new live stream |
| 18 | +*LiveStreamApi* | [**createLiveStreamOutput**](LiveStreamApi.md#createLiveStreamOutput) | **POST** /live_streams/{liveStreamId}/outputs | Create a new live stream output |
| 19 | +*LiveStreamApi* | [**deleteLiveStream**](LiveStreamApi.md#deleteLiveStream) | **DELETE** /live_streams/{liveStreamId} | Delete a live stream |
| 20 | +*LiveStreamApi* | [**deleteLiveStreamOutput**](LiveStreamApi.md#deleteLiveStreamOutput) | **DELETE** /live_streams/{liveStreamId}/outputs/{liveStreamOutputId} | Delete a live stream output |
| 21 | +*LiveStreamApi* | [**getLiveStream**](LiveStreamApi.md#getLiveStream) | **GET** /live_streams/{liveStreamId} | Get a single live stream |
| 22 | +*LiveStreamApi* | [**getLiveStreamOutput**](LiveStreamApi.md#getLiveStreamOutput) | **GET** /live_streams/{liveStreamId}/outputs/{liveStreamOutputId} | Get a single live stream output |
| 23 | +*LiveStreamApi* | [**getLiveStreamOutputs**](LiveStreamApi.md#getLiveStreamOutputs) | **GET** /live_streams/{liveStreamId}/outputs | Get a list of live stream outputs |
| 24 | +*LiveStreamApi* | [**getLiveStreams**](LiveStreamApi.md#getLiveStreams) | **GET** /live_streams | Get a list of live streams |
| 25 | +*LiveStreamApi* | [**idleLiveStream**](LiveStreamApi.md#idleLiveStream) | **POST** /live_streams/{liveStreamId}/idle | Manually idle a live stream |
| 26 | +*LiveStreamApi* | [**updateLiveStream**](LiveStreamApi.md#updateLiveStream) | **PATCH** /live_streams/{liveStreamId} | Update a live stream |
| 27 | +*LiveStreamApi* | [**updateLiveStreamOutput**](LiveStreamApi.md#updateLiveStreamOutput) | **PATCH** /live_streams/{liveStreamId}/outputs/{liveStreamOutputId} | Update a live stream output |
| 28 | + |
| 29 | + |
| 30 | +### Models |
| 31 | + |
| 32 | + - [ErrorWrappedResponse](ErrorWrappedResponse.md) |
| 33 | + - [LiveStreamCreatePayload](LiveStreamCreatePayload.md) |
| 34 | + - [LiveStreamInputCreatePayload](LiveStreamInputCreatePayload.md) |
| 35 | + - [LiveStreamInputResponse](LiveStreamInputResponse.md) |
| 36 | + - [LiveStreamOutputCreatePayload](LiveStreamOutputCreatePayload.md) |
| 37 | + - [LiveStreamOutputResponse](LiveStreamOutputResponse.md) |
| 38 | + - [LiveStreamOutputUpdatePayload](LiveStreamOutputUpdatePayload.md) |
| 39 | + - [LiveStreamOutputWrappedResponse](LiveStreamOutputWrappedResponse.md) |
| 40 | + - [LiveStreamOutputsWrappedResponse](LiveStreamOutputsWrappedResponse.md) |
| 41 | + - [LiveStreamResponse](LiveStreamResponse.md) |
| 42 | + - [LiveStreamUpdatePayload](LiveStreamUpdatePayload.md) |
| 43 | + - [LiveStreamWrappedResponse](LiveStreamWrappedResponse.md) |
| 44 | + - [LiveStreamsWrappedResponse](LiveStreamsWrappedResponse.md) |
| 45 | + - [MessageWrappedResponse](MessageWrappedResponse.md) |
| 46 | + - [MessageWrappedResponseData](MessageWrappedResponseData.md) |
| 47 | + |
| 48 | + |
| 49 | +## Installation |
| 50 | +```bash |
| 51 | +npm install @cloudinary/video-live-streaming |
| 52 | +``` |
| 53 | + |
| 54 | +## Get Help |
| 55 | +If you run into an issue or have a question, you can either: |
| 56 | +- Issues related to the SDK: [Open a Github issue](https://github.com/cloudinary/media-editing-js/issues) |
| 57 | +- Issues related to your account: [Open a support ticket](https://cloudinary.com/contact) |
| 58 | + |
| 59 | +## Additional Resources |
| 60 | +- [Cloudinary Transformation and REST API References](https://cloudinary.com/documentation/cloudinary_references): Comprehensive references, including syntax and examples for all SDKs. |
| 61 | +- [MediaJams.dev](https://mediajams.dev/): Bite-size use-case tutorials written by and for Cloudinary Developers |
| 62 | +- [DevJams](https://www.youtube.com/playlist?list=PL8dVGjLA2oMr09amgERARsZyrOz_sPvqw): Cloudinary developer podcasts on YouTube. |
| 63 | +- [Cloudinary Academy](https://training.cloudinary.com/): Free self-paced courses, instructor-led virtual courses, and on-site courses. |
| 64 | +- [Code Explorers and Feature Demos](https://cloudinary.com/documentation/code_explorers_demos_index): A one-stop shop for all code explorers, Postman collections, and feature demos found in the docs. |
| 65 | +- [Cloudinary Roadmap](https://cloudinary.com/roadmap): Your chance to follow, vote, or suggest what Cloudinary should develop next. |
| 66 | +- [Cloudinary Facebook Community](https://www.facebook.com/groups/CloudinaryCommunity): Learn from and offer help to other Cloudinary developers. |
| 67 | +- [Cloudinary Account Registration](https://cloudinary.com/users/register/free): Free Cloudinary account registration. |
| 68 | +- [Cloudinary Website](https://cloudinary.com) |
| 69 | + |
| 70 | + |
| 71 | +## Licence |
| 72 | +Released under the MIT license. |
0 commit comments