Two coordinate systems need a map
RFC 8216 describes X-TIMESTAMP-MAP linking a local WebVTT cue time with the MPEG media timestamp used by other renditions. The two numeric forms have different units and origins. Comparing their raw integers as if both were wall-clock seconds would be incorrect.
For an original explanatory model, think of a caption cue at a known local position and a corresponding anchor on the media clock. Later cue positions follow the applicable relationship. The mapping does not translate the words or select the user's language; it locates their presentation in time.
Segment boundaries do not necessarily end a cue
The HLS rules allow cue display intervals to extend across the period represented by one subtitle segment. A segment can also contain no cues when no subtitles should display during its period. An empty subtitle interval is therefore not automatically a missing translation or corrupt download.
If a long line is cut at every media boundary, an authorised developer should inspect cue coverage and mapping rather than only a global subtitle delay slider. A fixed slider may hide one symptom while leaving boundary handling wrong elsewhere. Preserve the exact content position and relevant media configuration.
Keep source-specific evidence
A useful report distinguishes a caption request failure, invalid WebVTT, a selected but hidden track and timing that is wrong after otherwise successful rendering. These states lead to different investigations. An image of late text cannot independently identify which timestamp field caused it.
The format also needs careful handling of its timestamp domain and wrap behaviour. Viewers should use the supported player and report the symptom, while authorised developers inspect the applicable fields. This reference does not supply private subtitle resources, claim a tested implementation or assert that IPTV Australia uses a particular clock mapping. It clarifies why text validity and media alignment require separate evidence.
Questions about this guide
Does valid WebVTT text prove audiovisual alignment?
No. Its cue clock must map correctly to the media timeline.
Is an empty subtitle segment always a failure?
No. It can represent an interval in which no captions should be shown.
