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
andAVDuration
are currently ignored by the platform. SuccessiveStartTime
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 theComponentNumber
. For example: ifComponentTypeName
= Chapter andComponentNumber
= 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
<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>