AdCOM 1.0 JSON Schema Unofficial

Decision records ·

D-004 What does List: Start Delay Modes accept, when its row >0 stands for every positive number of seconds rather than one code?

Gap Cited on main and at the tag AdCOM1.0-202607.

What the schemas do

A vocabulary of the three codes the list names, 0, -1, and -2, open to a media offset, a whole number of seconds of at least 0, for the >0 row.

Options

  • codes-and-offset Chosen

    A vocabulary of the three codes the list names, 0, -1, and -2, open to a media offset, a whole number of seconds of at least 0, for the >0 row.

  • integer-range

    Any integer of at least -2, with no vocabulary.

  • codes-only

    The three codes alone, so a mid-roll at a given second fails.

Why

The >0 row says a positive value is a mid-roll's start delay, in seconds, so every positive integer is valid and none is a code of its own. The three other rows are codes with labels. A vocabulary of those codes, open to a media offset in seconds, states both: the labels stay with their codes, and a delay of 30 validates. A media offset starts at 0, which is also the pre-roll code, and the two agree: a delay of 0 seconds is a pre-roll. Any integer of at least -2 would accept the same values but lose the codes' labels, and the codes alone would reject every mid-roll at a given second.

What we ask the specification to state

Write the mid-roll row as a range with its unit, such as "1 or more: Mid-Roll, the start delay in seconds", and say whether 0 seconds is the pre-roll code. Today >0 is the only row besides the 500+ vendor ranges that stands for many values, and unlike them it names no first code, so a reader of the table alone can take it for a code.

The specification lines it rests on

Each line is quoted as the record pins it. Expand an item to read the quote.

main

  • List: Start Delay Modes, the row of >0 L4471 at 26c59ba
    >0 | Mid-Roll (value indicates start delay in second)
  • List: Start Delay Modes, the row of 0 L4475 at 26c59ba
    0 | Pre-Roll
  • List: Start Delay Modes, the row of -1 L4479 at 26c59ba
    -1 | Generic Mid-Roll
  • List: Start Delay Modes, the row of -2 L4483 at 26c59ba
    -2 | Generic Post-Roll

Tag AdCOM1.0-202607

  • List: Start Delay Modes, the row of >0 L4471 at d67a6a8
    >0 | Mid-Roll (value indicates start delay in second)
  • List: Start Delay Modes, the row of 0 L4475 at d67a6a8
    0 | Pre-Roll
  • List: Start Delay Modes, the row of -1 L4479 at d67a6a8
    -1 | Generic Mid-Roll
  • List: Start Delay Modes, the row of -2 L4483 at d67a6a8
    -2 | Generic Post-Roll

What it shapes

main: StartDelayMode

Tag AdCOM1.0-202607: StartDelayMode

The record's YAML file