diff --git a/docs/1.0.md b/docs/1.0.md index f41d53e..6011855 100644 --- a/docs/1.0.md +++ b/docs/1.0.md @@ -756,8 +756,16 @@ Example of specifying four different image sizes:



## Live Item ``

-The `liveItem` tag is used for a feed to deliver a live stream to podcast apps. It takes the same format as a standard `` episode tag, and all tags that are allowed inside of -a normal `` tag are also allowed as children of ``. Podcast apps should support both `` and `` for greatest compatibility. +The `liveItem` tag is used for a feed to deliver a live audio or video stream to podcast apps. It takes the same format as a standard `` episode tag, and all tags that are +allowed inside of a normal `` tag are also allowed as children of ``. + +The [``](#alternate-enclosure) tag is highly encouraged over the use of `` since it gives the broadest coverage of possible stream types and is +much more explicit in it's definition of what transport protocol and media codecs are being used. If `` cannot be used, `` can be used as a fallback, +however feed owners must limit the stream to using only the two most widely supported protocols (mp3 and mp4/h.264) to ensure compatibility with the broadest number of apps on various +platforms. Choosing a streaming format for `` outside of this narrow list will exclude many apps from playing your content. + +The `` tag is also highly encouraged to ensure that listeners have a fallback option in case their chosen app cannot play the given content stream directly. Podcasters +who live stream to multiple platforms at once can also use the `` tag to provide links to those various platforms. The `start` and `end` attributes denote when the live stream "should" start and end. But, real life dictates that those times might not be adhered to. Apps are therefore encouraged not to rely solely on those times as anything more than an approximation. The canonical way to know if a stream has started is with the `status` attribute. If `status` is "live" then @@ -766,6 +774,9 @@ the stream has started. This tag will also make use of the [podping](https://podping.cloud) notification network. A podping notification SHOULD be sent out by the host when the live stream starts, to let apps know. +The function of `` within a live item tag is the same as it is within a regular item. If the `` of a `` changes, it MUST be considered a new stream by +podcast apps. + ### Parent   `` @@ -774,7 +785,8 @@ apps know. ### Node Value All tags that are valid inside of a standard `` tag are also valid here. The [`alternateEnclosure`](#alternate-enclosure) tag has robust support for specifying streaming content -in a myriad of ways and is encouraged over `` where possible. +in a myriad of ways and is highly encouraged over the use of `` where possible. A `` tag is also highly encouraged as a fallback for apps to display when +they cannot play the content directly. ### Attributes - **status** (required) A string that must be one of `pending`, `live` or `ended`. @@ -782,32 +794,18 @@ in a myriad of ways and is encouraged over `` where possible. - **end** (required) A string representing an ISO8601 timestamp that denotes the time when the stream is intended to end. ### Examples -A very simple example: +A complete example: ```xml - Podcasting 2.0 Live Show - e32b4890-983b-4ce5-8b46-f2d6bc1d8819 - John Doe (john@example.com) - - -``` - -A more complex example: -```xml - Podcasting 2.0 Live Show A look into the future of podcasting and how we get to Podcasting 2.0! https://example.com/podcast/live https://example.com/live John Doe (john@example.com) - Adam Curry Dave Jones @@ -815,5 +813,54 @@ A more complex example: + + YouTube! + Twitch! + Listen Live! +``` + +A bare bones example: +```xml + + Podcasting 2.0 Live Stream + e32b4890-983b-4ce5-8b46-f2d6bc1d8819 + + Listen Live! + +``` + + + +



+## Content Link +``

+The `contentLink` tag is used in multiple tags to indicate that the content begin delivered by the parent element can be found at an external location +instead of, or in addition to, being delivered directly to the tag itself within an app. In most instances it is used as a fallback link for the user +to use when the app itself can't handle a certain content delivery directly. + +For instance, perhaps a podcast feed specifies a `` to deliver a live stream to apps. The feed may also give a `` +pointing to YouTube and Twitch versions of the live stream as well, just in case the listener uses an app that doesn't fully support live streaming content. + +Currently this tag is only indicated for use in the `` tag. In the future, its use will be expanded. + +### Parent +  `` + +### Count +  Multiple + +### Node Value +The node value is a free form string meant to explain to the user where this content link points and/or the nature of it's purpose. + +### Attributes + - **href** (required) A string that is the uri pointing to content outside of the application. + +### Examples +```xml +Live on YouTube! +``` + +```xml +Chat on Twitter! ``` \ No newline at end of file