
The symbol
in the annotations indicates an Apple-specific implementation or recommendation.
The reference numbers (for example, §7.2.2) refer to the section in the TTML specification in which the element is explained.
XML Declaration (required) The character encoding of your document must be defined. Apple accepts only UTF-8 encoding as it efficiently encodes non-Roman characters. Important: The TTML file must not contain a byte-order mark (BOM). |
Document Container §7.1.1 (required) The The
|
Language §7.2.2 (required) This is the same format that is described for use in the |
Head Element |
Head §7.1.2 (required) Begins the head element, which specifies document metadata, such as title, and other document-specific information, such as the artists performing. Note: |
Metadata §8.1.1 (required) Begins the metadata block. |
Title §12.1.2 (required) Supplies the title of the song for the lyrics you are delivering. |
Agent §12.1.5 (optional) The For example, if multiple agents are identified, the Apple Music Duet feature shows lyrics on opposite sides of the screen. The attributes supplied with the The
The
|
Name §12.1.6 (optional) The The |
Ends the |
Ends the |
Body Element |
Body §7.1.3 (required) Begins the body element, which is used to determine the lyrics and their timings. The |
Div §7.1.4 (required) Begins the section within the document where you enter the actual text of the lyrics and the timing. Each paragraph is represented by a
The Note: Currently, song parts are not displayed to the users. |
Line-by-line timing example
Example Paragraph §7.1.5 Each Timing (optional): For line-by-line timing, add the timing attributes (
For time value details and rules, see Timing. Agent: When the lyrics are sung by different artists, you can specify which artist sings the line using the
|
Beat-by-beat timing example
Paragraph §7.1.5 Each Span §7.1.6 Use the Timing (required for beat-by-beat timing): Add timing attributes to the
There’s no requirement to use Role §12.2.2 The Place the
|
|