place.stream.playback.getLiveSegment

did:web:stream.place

Documentation

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.

main query

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.

Parameters

seg string Required

`init` for the track's init segment, or the segment's media-sequence number. A trailing `.m4s` is accepted and ignored.

sid string Optional

Opaque playback session identifier, propagated from the media playlist that referenced this segment. Logged for view-count correlation; not used for access control.

streamer string Required

The streamer: a DID or a Bluesky handle (resolved to its DID).

track string Required

Track ID (stringified u32 matching the MUXL container).

Output

Encodingvideo/mp4

Errors

StreamNotLive No live window for this streamer on this node.
SegmentNotFound The requested segment has slid out of the window, or never existed.
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
`init` for the track's init segment, or the segment's media-sequence number. A trailing `.m4s` is accepted and ignored.
Opaque playback session identifier, propagated from the media playlist that referenced this segment. Logged for view-count correlation; not used for access control.
The streamer: a DID or a Bluesky handle (resolved to its DID).
Track ID (stringified u32 matching the MUXL container).
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "StreamNotLive",
      "description": "No live window for this streamer on this node."
    },
    {
      "name": "SegmentNotFound",
      "description": "The requested segment has slid out of the window, or never existed."
    }
  ],
  "output": {
    "schema": null,
    "encoding": "video/mp4"
  },
  "parameters": {
    "type": "params",
    "required": [
      "streamer",
      "track",
      "seg"
    ],
    "properties": {
      "seg": {
        "type": "string",
        "description": "`init` for the track's init segment, or the segment's media-sequence number. A trailing `.m4s` is accepted and ignored."
      },
      "sid": {
        "type": "string",
        "description": "Opaque playback session identifier, propagated from the media playlist that referenced this segment. Logged for view-count correlation; not used for access control."
      },
      "track": {
        "type": "string",
        "description": "Track ID (stringified u32 matching the MUXL container)."
      },
      "streamer": {
        "type": "string",
        "description": "The streamer: a DID or a Bluesky handle (resolved to its DID)."
      }
    }
  },
  "description": "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."
}

Lexicon Garden

@