Lexicon Garden

place.stream.playback.getVideoPlaylist

Get an HLS CMAF playlist for a video. Returns a master playlist when `track` is omitted, or a single-track media playlist when `track` is supplied. The playlist references each segment + per-track init segment via getVideoBlob, addressed by content hash. The `uri` is an AT-URI pointing at a playable record — today only place.stream.video records are supported, but the surface is collection-agnostic so other record types can join later.

Repository @stream.place did:plc:rbvrr34edl5ddpuwcubjiost not from the namespace authority
Details · query
Kindquery
Authorityplayback.stream.place
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

end

integer

End time in milliseconds. Omit to include all remaining content. Local to the clip's timeline when playing back a sourceClip record.

sid

string

Opaque playback session identifier. Omit on the master playlist request; the server generates one and embeds it in every sub-playlist URL it returns. Players never have to construct it themselves — they just follow the URLs the master playlist hands them, which carry the sid into media-playlist + segment requests. Used downstream to correlate a player's playlist + segment fetches for view-count accounting.

start

integer

Start time in milliseconds from the beginning of the video. Defaults to 0. For a place.stream.video record whose source is a place.stream.media.defs#sourceClip, this is in the clip's local timeline (0 == the clip's start).

track

string

Track ID (stringified u32 matching the MUXL container) for a single-track media playlist. Omit for the master playlist.

uri

requiredstring · at-uri

AT-URI of the record to play back (e.g. at://did:plc:.../place.stream.video/<rkey>).

Output

*/*

Errors

VideoNotFound

No record indexed at the supplied AT-URI.

TrackNotFound

The requested track ID is not present in the video's blob.

BlobNotFound

The record references a blob this node hasn't indexed an origin for.

UnsupportedCollection

The AT-URI points at a collection this endpoint doesn't know how to play back.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • place.stream.playback.getLivePlaylist

    query not from the namespace authority

    Get an HLS CMAF playlist for a live stream. Returns a master playlist when `track` is omitted, or a single-track media playlist when `track` is supplied. The playlist references each segment + per-track init segment via getLiveSegment. Segments come from an in-memory sliding window fed as the stream is ingested (or replicated to this node), so a playlist is only available while the stream is live here.

  • place.stream.playback.getVideoBlob

    query not from the namespace authority

    Fetch a content-addressed MUXL playback blob by CID. Serves either a primary fMP4 archive or a per-track init segment — both are CID-addressed and indistinguishable from the endpoint's point of view. HTTP `Range` headers are honored; HLS media playlists generated by getVideoPlaylist reference this endpoint with `EXT-X-BYTERANGE` to serve segments out of the primary blob. The `did` identifies the owning account for egress accounting: the blob itself is content-addressed and owner-agnostic, so the

  • place.stream.playback.getLiveSegment

    query not from the namespace authority

    Fetch a single live HLS segment, or a track's init segment, from the in-memory live window. `seg` is `init` for the EXT-X-MAP init segment, otherwise the segment's media-sequence number; a cosmetic `.m4s` suffix is accepted (and ignored) so ffmpeg-based HLS players will fetch it. HTTP Range is honored. Segments are the verbatim signed canonical .m4s, so provenance travels with playback.

  • place.stream.media.getVideo

    query not from the namespace authority

    Get a hydrated view of a place.stream.video record — the record itself plus author info plus aggregated view counts summed across every reporting node we've indexed. View counts come from place.stream.media.viewCount records; consumers see one number per metric, with the underlying multi-reporter detail collapsed away.

  • place.stream.playback.getPlaybackSession

    query not from the namespace authority

    Mint the caller's own playback session for their live stream. Every playback URL carries a signed session as `sid`; the anonymous one a playlist hands out opens published streams only, while the owner session this returns also opens the caller's unpublished (pre-live) stream to their own player. Requires an authenticated session; the result is bound to the caller's DID. Pass it as `sid` on getLivePlaylist.