Capabilities - PhenixRTS Docs
Capabilities
Supported Stream Capabilities
Transformations
Please be aware that capabilities that perform transformations on published content (e.g., aspect-ratio) will only take effect if the multi-bitrate capability is also used.
| Value | Token Type | Description |
|---|---|---|
| aspect-ratio=WxH | publish | Crop the stream to the desired aspect ratio during multi-bitrate transcoding. Example: aspect-ratio=9x16 crops the image to portrait mode in 9 by 16 format. The cropping produces the highest resolution possible limited only by the resolution of the multi-bitrate layer. |
| audio-only | publish + subscribe | The stream will only have an audio track. |
| contribution=balanced-quality | publish | Allow for up to 1 second of additional delay on publishing. This can help ensure high-quality streams and VOD assets from user-generated content (UGC) published over poor network conditions. |
| high-fidelity | publish | Use high fidelity audio bitrate configuration for high-quality reproduction of sound. |
| insertable-streams | subscribe | Enable Frame-Ready feature. This allows for the transformation of the raw media prior to rendering for viewers. |
| mpegts-unicast-ingest | publish | Publish to Phenix, only transcoding if multi-bitrate is also set. |
| multi-bitrate | publish | Provide multi-bitrate ABR for each viewer of the stream. The platform transcodes, in real-time, to multiple quality levels for each stream. The number of quality levels depends on the contribution quality of the stream as selected with the quality capabilities. |
| multi-bitrate-contribution | publish | Provide streams to Phenix platform at multiple bitrates. Only for use with MBR-capable encoders. |
| on-demand | publish | Persist the transcoded live stream as HLS for on-demand playback. The stream features the same capabilities as the adaptive multi-bit rate live stream and can be accessed time delayed. |
| on-demand | subscribe | Use adaptive on-demand streaming using HLS or MPEG+DASH. This can be used to access the stream after it was recorded. It requires the publisher stream to have the "on-demand" capability. |
| on-demand-formats=dash | publish | Record streams as DASH. Requires that the "on-demand" capability also be set. |
| on-demand-formats=hls | publish | Record streams as HLS. Requires that the "on-demand" capability also be set. |
| on-demand-formats=hls,dash | publish | Record streams as both HLS and DASH. Requires that the "on-demand" capability also be set. |
| on-demand-lite | publish | Only create one rendition for the on-demand stream that corresponds to the highest quality level. Requires that the "on-demand" capability also be set. |
| publish-uri | publish | Required when publishing content from a remote URI. |
| real-time | subscribe | Use real-time streaming with typically less than 300 milliseconds delivery latency. This is the default. |
| source-uri-ingest | publish | Publish to Phenix. This option always transcodes the incoming content. For high frame rate content, the frame rate is reduced by half (e.g., 60fps is transcoded to 30fps). This is the default value if another ingest type (e.g., mpegts-unicast-intgest) is not set. |
| streaming | publish | In addition to real-time streaming, create a transcoded live stream using adaptive HLS and MPEG+DASH streaming. The live stream contains multiple quality options from audio-only to highest video quality. |
| streaming | subscribe | Use adaptive live streaming using HLS or MPEG+DASH with about 8-12 seconds delivery latency. This can be used for broadcasts to clients with network connections with limited bandwidth or highly fluctuating bandwidth. It requires the publisher stream to have the "streaming" capability. |
| streaming-lite | publish | Only create one rendition for the live stream that corresponds to the highest quality level. Requires that the "streaming" capability also be set. |
| token-auth | publish | Protects the live stream with edge auth tokens. When enabled it requires a ?streamToken=<edgeAuthToken> to be provided when accessing the manifests on all HTTP requests. |
| video-only | publish + subscribe | The stream will only have a video track. |
Supported Quality Capabilities
Note that the quality levels listed below only apply when the multi-bitrate capability is also used.
| Value | Video Size | Desc. | Token Type | Video Bit Rate, kbps | Audio Bit Rate, kbps* | Rec. Bandwidth, kbps** |
|---|---|---|---|---|---|---|
| uld | 144p | Ultra low definition | Publish | 80 | 60 | 400 |
| vvld | 144p | Very very low definition | Publish | 192 | 60 | 550 |
| vld | 240p | Very low definition | Publish | 350 | 60 | 600 |
| ld | 360p | Low definition | Publish | 520 | 60 | 1000 |
| sd | 480p | Standard definition - default | Publish | 830 | 60 | 1500 |
| hd | 720p | High definition | Publish | 1600 | 60 | 3000 |
| fhd | 1080p | Full high definition | Publish | 3000 | 60 | 5000 |
| xhd | 1080p | Extended high definition | Publish | 5500 | 60 | 10000 |
- In case of high fidelity audio capability, audio bitrate is 160kbps.
** - A stable low latency internet connection is recommended for best experience. Note that some Wifi and DSL lines may experience high latency periodically or under load which makes their effective throughput significantly less than their nominal bandwidth.
NB: For publishing, please make sure to select local user media option matching the quality of the stream. For example, it causes overhead if you select a user media with larger size than the recommended size for the quality level.
Live/On-Demand Renditions
| ID | Quality | Video Size | Video Frame Rate, fps | Video Codec | Video Bit Rate, kbps | Audio Codec | Audio Bit Rate, kbps |
|---|---|---|---|---|---|---|---|
| qcif | uld+ | 144p | 15 | h264 baseline 3.0 (avc1.42c01e) | 80 | AAC LC (mp4a.40.2) | 64 |
| sif | vld+ | 240p | 15 | h264 baseline 3.1 (avc1.42c01f) | 350 | AAC LC (mp4a.40.2) | 64 |
| ld | ld+ | 360p | 15 | h264 baseline 3.1 (avc1.42c01f) | 520 | AAC LC (mp4a.40.2) | 64 |
| sd | sd+ | 480p | 30 | h264 main 3.1 (avc1.42c01f) | 830 | AAC LC (mp4a.40.2) | 128 |
| hd | hd+ | 720p | 30 | h264 main 3.1 (avc1.42c01f) | 1600 | AAC LC (mp4a.40.2) | 128 |
| fhd | fhd+ | 1080p | 30 | h264 high 4.1 (avc1.640029) | 3000 | AAC LC (mp4a.40.2) | 128 |
| xhd | xhd+ | 1080p | 30 | h264 high 4.1 (avc1.640029) | 5500 | AAC LC (mp4a.40.2) | 128 |
When enabling streaming or on-demand, each of the above rendition is made available if the stream quality is equal or better than the rendition itself.
The playlist for HLS and DASH leverage an adaptive bitrate configuration based on the available video and audio renditions. Example: A stream with hd quality will have two audio and five video renditions.
When using the streaming-lite capability, only the top layer is generated. Example: A stream with hd quality and streaming-lite rendition has one audio and one video rendition corresponding the hd rendition.