Skip to main content
Skip table of contents

Importing audio tables of contents from ONIX 3

The ONIX 3 standard allows audio/video tables of contents to be filled in via the ContentItem block. Chapters are registered by name, with no relationship to the track that contains the chapter. The timestamp is set from the beginning of the audiobook.

ONIX Structure

See group P.18 Content item of the ONIX specifications for more details.

Tag

Multiplicity

Note

<ContentItem>

0..n

One per chapter.

..<AVItem>

1

....<AVItemType>

1

Value 01 "Audiovisual work" or 03 "Body matter".

....<TimeRun>

1

......<StartTime>

1

Mandatory, timestamp in hhhmmss format, from the beginning of the audio book.

......<EndTime>

0..1

Optional.

....<AVDuration>

0..1

Ignored if EndTime, mandatory if EndTime is missing.

..<TitleDetail>

0..1

One per chapter. Preferred way to provide a chapter's title.

....<TitleType>

1

Value 01 ("Item title").

....<TitleElement>

1

......<TitleElementLevel>

1

Value 04 ("Content item").

......<TitleText>

1

Chapter title.

..<ComponentTypeName>

0..1

Used if TitleDetail is missing. Contains only the type of component (ex: "Chapter"). The number must be provided in ComponentNumber.

..<ComponentNumber>

0..1

Used if TitleDetail is missing. Contains only the component number (ex: "5").

Notes

  • EndTime and AVDuration are currently ignored by the platform. Successive StartTime tags are used to establish the timestamp and chapter sequence. However, it is recommended that a valid ONIX structure be maintained by providing one or the other.

  • StartTime should be calculated from the beginning of the audiobook (not from the beginning of the track).

  • In the absence of a TitleDetail, the chapter title will be made up from the ComponentTypeName and the ComponentNumber. For example: if ComponentTypeName = Chapter and ComponentNumber = 5, the chapter's title would be= "Chapter 5"

  • Incomplete tables of contents (without titles or timestamps) are rejected.

  • See the ONIX 3 example below.

ONIX 3 Example

CODE
        <ContentDetail>
            <ContentItem>
                <AVItem>
                    <AVItemType>03</AVItemType>
                    <TimeRun>
                        <StartTime>0000000</StartTime>
                    </TimeRun>
                    <AVDuration>0010720</AVDuration>
                </AVItem>
                <TitleDetail>
                    <TitleType>01</TitleType>
                    <TitleElement>
                        <TitleElementLevel>04</TitleElementLevel>
                        <TitleText>Chapter 1</TitleText>
                    </TitleElement>
                </TitleDetail>
            </ContentItem>
            <ContentItem>
                <AVItem>
                    <AVItemType>03</AVItemType>
                    <TimeRun>
                        <StartTime>0010721</StartTime>
                        <EndTime>0013214</EndTime>
                    </TimeRun>
                </AVItem>           
                <TitleDetail>
                    <TitleType>01</TitleType>
                    <TitleElement>
                        <TitleElementLevel>04</TitleElementLevel>
                        <TitleText>Chapter 2</TitleText>
                    </TitleElement>
                </TitleDetail>
            </ContentItem>
        </ContentDetail>
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.