diff --git a/README.md b/README.md index dee1baf..5b4d944 100644 --- a/README.md +++ b/README.md @@ -162,67 +162,6 @@ full implementation details. The following tags are being actively considered for adoption into the namespace as part of phase 4. They are a work in progress. -### **\** - [Discuss](https://github.com/Podcastindex-org/podcast-namespace/issues/212) - -
- - - -```xml - - - -``` - - - -Channel - -(optional | multiple) - -This element is used for a feed to deliver a live stream to podcast apps. It takes the same format as a standard `` episode tag, but holds a subset of elements along with -some additional new elements that are appropriate for a live stream context. 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 on those times as anything more than a suggestion. The canonical way to know if a -stream has started is with the `status` attribute. If `status` is "live" then the stream has started. - -This item 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. - - -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 - Becky Smith - - - - -``` - -
- ----- - ### **\** - [Discuss](https://github.com/Podcastindex-org/podcast-namespace/issues/205)
diff --git a/docs/1.0.md b/docs/1.0.md index 07968e6..0ea58cf 100644 --- a/docs/1.0.md +++ b/docs/1.0.md @@ -750,3 +750,58 @@ Example of specifying four different image sizes: https://example.com/images/ep1/pci_avatar-tiny.jpg 150w" /> ``` + + + +



+## 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 `` except for `` which is supplanted in this context with ``. +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 +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. + +### Parent +  `` + +### Count +  Multiple + +### Node Value +All tags that are valid inside of a standard `` tag are also valid here, except for ``. Instead of a normal `` which doesn't make sense in a live context, +the `` tag MUST be used instead. The [`alternateEnclosure`](#alternate-enclosure) tag has robust support for specifying streaming content. + +### Attributes + - **status** (required) A string that must be one of `pending`, `live` or `ended`. + - **start** (required) A string representing an ISO8601 timestamp that denotes the time when the stream is intended to start. + - **end** (required) A string representing an ISO8601 timestamp that denotes the time when the stream is intended to end. + +### Examples +```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 + Becky Smith + + + + +``` \ No newline at end of file