place.stream.playback.getLivePlaylist

did:web:stream.place

Documentation

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.

main query

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.

Parameters

sid string Optional

Opaque playback session identifier. Omit on the master playlist request; the server generates one and threads it through the sub-playlist + segment URLs it returns, for view-count correlation.

streamer string Required

The streamer to play back: a DID (did:plc/did:web/did:key) or a Bluesky handle, which is resolved to its DID.

track string Optional

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

Output

Encoding*/*

Errors

StreamNotLive No live segments are currently windowed for this streamer on this node.
TrackNotFound The requested track ID is not present in the live stream.
StreamUnavailable The streamer's account is unavailable (e.g. banned).
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Opaque playback session identifier. Omit on the master playlist request; the server generates one and threads it through the sub-playlist + segment URLs it returns, for view-count correlation.
The streamer to play back: a DID (did:plc/did:web/did:key) or a Bluesky handle, which is resolved to its DID.
Track ID (stringified u32 matching the MUXL container) for a single-track media playlist. Omit for the master playlist.
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "StreamNotLive",
      "description": "No live segments are currently windowed for this streamer on this node."
    },
    {
      "name": "TrackNotFound",
      "description": "The requested track ID is not present in the live stream."
    },
    {
      "name": "StreamUnavailable",
      "description": "The streamer's account is unavailable (e.g. banned)."
    }
  ],
  "output": {
    "schema": null,
    "encoding": "*/*"
  },
  "parameters": {
    "type": "params",
    "required": [
      "streamer"
    ],
    "properties": {
      "sid": {
        "type": "string",
        "description": "Opaque playback session identifier. Omit on the master playlist request; the server generates one and threads it through the sub-playlist + segment URLs it returns, for view-count correlation."
      },
      "track": {
        "type": "string",
        "description": "Track ID (stringified u32 matching the MUXL container) for a single-track media playlist. Omit for the master playlist."
      },
      "streamer": {
        "type": "string",
        "description": "The streamer to play back: a DID (did:plc/did:web/did:key) or a Bluesky handle, which is resolved to its DID."
      }
    }
  },
  "description": "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."
}

Lexicon Garden

@