RaBe Content Reference Identifier Specification
The RaBe Content Reference Idenitifier Spcification (CRID) defines how we use
the crid: URL scheme as defined by ETSI TS 102 822-4
for CRIDs that use a dns portion delegated to RaBe.
Table of Contents
Overview
The TV-Anytime content reference described in ETSI TS 102 82204 aims at allowing acquisition of a specific instance of a specific item of content. To acheive this, it provides the possibility to refer to content independent of it's location. It also describes how such a reference can be resolved into one or more locations for obtaining the content.
RaBe does not plan on fully adopting and implementing the full ETSI TS 102 82204 stack. Specifically we do not plan to implement an actual authority and it's corresponding XML interfaces.
This specification defines how we structure the data part of a CRID for the rabe.ch domain name.
Notations and Terminology
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
Versioning
This specification is versioned using git tag. It uses go-semantic-release for tagging new versions following the Conventional Commits v1.0.0 specification.
Authority
The TV-anytime specification uses DNS to provide unique names for each authority, ours are these:
rabe.ch
The RaBe CRID authority is responsible for creating unambiguous CRIDs.
The RaBe CRID authority SHALL NOT provide centralized CRID resolution services. We rely on involved parties to resolve RaBe CRIDs on their own.
CRID
RaBe CRIDs are as simple as possible:
<version> data part
To allow for future change, all of RaBe's CRIDs are versioned. Versioning SHALL follow semantic versioning conventions but is more similar to ie. Kubernetes API-versions.
<data-content> data part
RaBe CRID's define the data-content as the lowercased, normalized and dasherized name of a show as the primary URL path segment for a show. These are mostly based on the current URL slugs from the RaBe Website. The show part of a RaBe CRID is considered optional, allowing to reference a location in our broadcast without prior knowledge.
We SHOULD provide further guidance on normalization down the road.
For references to specific times, we support a media-frag URI-part and SHOULD use
the #t=code=<iso-timestamp> format as described in the
Media Fragments 1.0 (advanced) specification.
ABNF definition
RaBe CRIDs SHALL conform to the following ABNF definition.
crid = "crid://rabe.ch/" version [ "/" data-content ] [ "#" media-frags ]
version = "v" 1*DIGIT [ pre-release ] ; ie. v1, v2,
pre-release = ( "alpha" / "beta" / "rc" ) *DIGIT ; v1alpha, v1alpha1, v1beta, ...
data-content = show-name
show-name = 1*ALPHA ; show name string derived from website
media-frags = utc-range ; based on https://www.w3.org/TR/media-frags/
utc-range = "t=clock=" utc-date-time [ "-" utc-date-time ]
utc-date-time = utc-date "T" utc-time "Z"
utc-date = 8DIGIT ; < YYYYMMDD >
utc-time = 6DIGIT [ "." fraction ] ; < HHMMSS.fraction >
fraction = 1*2DIGIT ; 0-99
Examples
This section is non-normative.
| Show | Description | Web URL | CRID |
|---|---|---|---|
| Der Morgen (Freitag) | morning show, is a different show for each day of the week, does not have repeats and no individual episodes on the website | https://rabe.ch/der-morgen-freitag/ |
crid://rabe.ch/v1/der-morgen-freitag |
| RaBe Info | news, different on each day of the week, gets repeated once on air and published as podcast, has a page per episode on the web site | https://rabe.ch/info/ |
crid://rabe.ch/v1/info |
| Klangbecken | Always on show, gets used as a filler if nothing is scheduled and has it's own schedule, no repeats, no episodes | https://rabe.ch/klangbecken/ |
crid://rabe.ch/v1/klangbecken |
| Klangbecken | A specific point-in-time of the Klanbecken show, usually the start of a new track we play | https://rabe.ch/klangbecken/ |
crid://rabe.ch/v1/klangbecken#t=clock=20211201T131200.00Z |
| - | Minimal unconstrained RaBe CRID, references RaBe as a whole without any specific and is both valid and useless | https://rabe.ch |
crid://rabe.ch/v1 |
Links
This section is non-normative.
License
This specification is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.
Copyright
Copyright (c) 2022 Radio Bern RaBe