PlaybackEvent

A served file took longer than the server's slow-serve threshold (2 s) to be ready, and was then delivered. waited is the whole wait.

A served file never landed within the production window, and the request was answered with the miss (an aborted transfer for media, an empty WebVTT for subtitles). AVPlayer usually reports an error next.

A request is waiting on the producer and the producer has not cut a segment for since — whether or not it is still reading. lastPTS is the newest packet timestamp it did read, in seconds on the source's timeline (nil before the first): one far past the waited segment means reading without cutting, one standing still means a starved read. (Through 3.5.2 the clock was the last read, which a producer reading toward a boundary it never reached kept resetting.)

Measured only while a serve is pending, and never while the producer is deliberately parked, so a paused player does not look stalled.

The source origin answered 429/503/509. retryAfter is what its Retry-After header asked for, when it sent one.

Origin admission is shared by every session reading the same origin, so every session on that origin sees this, including one whose own requests were never refused — they are all held back by it.

The first good response from a throttled origin. Shared like originThrottled.

This session is playing sequentially because the source's seek index did not load within the startup budget, and a background load has now read it in full and stored it in the keyframe index cache. A successor (makeSession(changing:), same keyframeIndexCacheDirectory) plans from that map: a VOD playlist of segments entries, seekable anywhere, where this session can only grow its EVENT playlist.

Only ever sent once the map is stored — never for a source whose version cannot be proven (see keyframeIndexCacheDirectory), because a successor of that source would face the same budget and most likely play sequentially again. This session itself does not change.

A read of the source failed mid-session, and production carried on: the producer re-opened the source and re-anchored at the segment it was producing. cause is the failure it recovered from; attempt counts re-opens inside the current 60 s window, the one the cap of 3 applies to — so attempt == 3 means the next failure inside that window ends the session.

Planned sessions only (see the README's Streaming section). While it re-opens, fetches of unproduced segments are held exactly as for a seek, so AVPlayer sees a slow segment rather than an error.

The producer stopped for good: remuxFailure is now set, to this same classification. Sent exactly once per session that fails, and never for a stop(). A failure during startup sends it too — start() throws the same failure there.