Skip to content

docs(mux-player): explain stream-type enum values - #1356

Open
davekiss wants to merge 1 commit into
mainfrom
cursor/stream-type-docs-a4f9
Open

davekiss wants to merge 1 commit into
mainfrom
cursor/stream-type-docs-a4f9

Conversation

@davekiss

@davekiss davekiss commented Sep 14, 2026 •

Copy link
Copy Markdown
Contributor

Docs feedback

It would be good to add what the different options do:

"on-demand" | "live" | "ll-live" | "live:dvr" | "ll-live:dvr"

Problem

The HTML player API reference lists stream-type as "on-demand" | "live" | "ll-live" | "live:dvr" | "ll-live:dvr" with little explanation of what each option does. That page is generated from packages/mux-player/REFERENCE.md.

Change

Expand the existing stream-type attribute and streamType property descriptions (no new page) with concise, per-value behavior:

  • on-demand: VOD / Mux Asset UI (seekable timeline and duration)
  • live: live without DVR — live controls, stays at the live edge (target-live-window is 0)
  • ll-live: low-latency live without DVR — same player behavior as live (low-latency HLS is inferred from the stream); prefer live
  • live:dvr: live with DVR — seekable live window (target-live-window is Infinity), no auto-seek to live
  • ll-live:dvr: low-latency live with DVR — same as live:dvr; prefer live + target-live-window="Infinity"

Also notes that the value is usually inferred from playback-id after media loads.

Behavior was checked against mux-player helpers/base/template, stream-type tests, and the deprecated-stream-type guidance.

No unrelated files changed.

QA

  • Date: 2026-09-24 ET
  • Verified: Live https://www.mux.com/docs/guides/player-api-reference/html (HTTP 200) lists enum without per-value explainers. Main REFERENCE.md enum matches PR: on-demand | live | ll-live | live:dvr | ll-live:dvr. Source packages/mux-player/src/base.ts maps DVR variants → targetLiveWindow = Infinity else 0, and deprecates ll-* in favor of live / target-live-window. Explanations use existing product terms only (Mux Asset, live edge, DVR). Docs-only.
  • Credential QA: N/A (copy-only)
  • Verdict: SHIPPABLE
  • Process note: behind main (process only)
Open in Web Open in Cursor 

Document what each stream-type option means for Mux Player UI and
playback, including live vs DVR and the ll-live aliases.

Co-authored-by: Dave Kiss <davekiss@users.noreply.github.com>
@davekiss
davekiss marked this pull request as ready for review September 14, 2026 13:45
@davekiss
davekiss requested a review from a team as a code owner September 14, 2026 13:45
@vercel

vercel Bot commented Sep 14, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
elements-demo-astro Ready Ready Preview Sep 14, 2026 1:53pm UTC
elements-demo-nextjs Ready Ready Preview Sep 14, 2026 1:53pm UTC
elements-demo-svelte-kit Ready Ready Preview Sep 14, 2026 1:53pm UTC
elements-demo-vanilla Ready Ready Preview Sep 14, 2026 1:53pm UTC
elements-demo-vue Ready Ready Preview Sep 14, 2026 1:53pm UTC

Request Review

@snyk-io

snyk-io Bot commented Sep 14, 2026 •

Copy link
Copy Markdown

✅ Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
✅ Open Source Security 0 0 0 0 0 issues
✅ Licenses 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

This branch was successfully deployed

5 active deployments
Preview – elements-demo-astro — 7fdd57eb Deployed Sep 14, 2026 by vercel[bot]
Preview – elements-demo-vue — 7fdd57eb Deployed Sep 14, 2026 by vercel[bot]
Preview – elements-demo-vanilla — 7fdd57eb Deployed Sep 14, 2026 by vercel[bot]
Preview – elements-demo-nextjs — 7fdd57eb Deployed Sep 14, 2026 by vercel[bot]
Preview – elements-demo-svelte-kit — 7fdd57eb Deployed Sep 14, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants