Skip to content

docs: add format opt-out examples to codecs and formats page - #1099

Open
tsi wants to merge 2 commits into
masterfrom
docs/VIDEO-21243-format-opt-out-demo
Open

tsi wants to merge 2 commits into
masterfrom
docs/VIDEO-21243-format-opt-out-demo

Conversation

@tsi

@tsi tsi commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

Jira: VIDEO-21243

Follow-up to #1097. Adds shareable demos of the new format options. Not for merge: this PR exists for its deploy preview.

As-is delivery page

New as-is-delivery.html (linked from the examples index) shows sourceTypes: ['']:

  • The original file: sourceTypes: [''] delivers .../upload/sea_turtle, with no transformation.
  • With your own transformations: sourceTypes: [''], transformation: { width: 640, crop: 'limit' } delivers c_limit,w_640/sea_turtle, still without f_auto.

Each example shows the delivered URL, content type and file size, measured live in the viewer's browser. The original example also shows the size of the default f_auto:video delivery for comparison (in Chrome: 27.9 MB original vs 1.6 MB webm/vp9). The page also covers when to use it, the trade-offs, a sourceTypes URL reference and example code.

Codecs and formats page

What changed

Three new players on codec-formats.html and es-modules/codec-formats.html:

Example Delivery URL
transformation: { fetch_format: 'mp4' } f_mp4/product-gallery-tutorial_hlk0na
transformation: { format: 'mp4' } (alias) f_mp4/product-gallery-tutorial_hlk0na
sourceTypes: [''] (as-is, no f_auto) product-gallery-tutorial_hlk0na

The new players don't autoplay. With six autoplaying players on one page, Chrome only buffers some of them, and the rest stay stuck on load.

Known issue

With transformation: { fetch_format: 'mp4' }, the seek-thumbnails sprite URL becomes f_mp4/fl_sprite/...vtt (400). Playback isn't affected. Fixed in #1100.

Testing

Checked on the local docs server:

  • All new players play, and the URLs match the tables above.
  • The as-is page loads all live details, with no console errors and no horizontal scroll at 375px.

@tsi
tsi requested a review from a team as a code owner October 20, 2026 09:36
@netlify

netlify Bot commented Oct 20, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for cld-video-player ready!

Name Link
🔨 Latest commit 04109a7
🔍 Latest deploy log https://app.netlify.com/projects/cld-video-player/deploys/6ad742b4e31487aa87dd4fba
😎 Deploy Preview https://deploy-preview-1099--cld-video-player.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Oct 20, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for cld-vp-esm-pages ready!

Name Link
🔨 Latest commit 04109a7
🔍 Latest deploy log https://app.netlify.com/projects/cld-vp-esm-pages/deploys/6ad742b49cbcabf473ee5223
😎 Deploy Preview https://deploy-preview-1099--cld-vp-esm-pages.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

This branch has not been deployed

No deployments
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.

1 participant