Skip to content

Editorial review: Add information on missing MP4/HEVC codec parameter values #40081

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

chrisdavidmills
Copy link
Contributor

Description

Chrome 136 adds support to the MediaRecorder API for HEVC encoding, introducing the hvc1.* codec string, and adds new codecs (hev1.* and avc3.*) supporting variable resolution video in MP4. See https://chromestatus.com/feature/6375884229181440 for more details.

This PR attempts to add some information about the new codecs to the https://developer.mozilla.org/en-US/docs/Web/Media/Guides/Formats/codecs_parameter page. The relevant MediaRecorder features all point to this page for the actual codec details, but to make sure the support is clear, I've also added compat data entries for them: mdn/browser-compat-data#27142.

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner June 25, 2025 15:56
@chrisdavidmills chrisdavidmills requested review from hamishwillee and removed request for a team June 25, 2025 15:56
@chrisdavidmills chrisdavidmills marked this pull request as draft June 25, 2025 15:56
@github-actions github-actions bot added Content:Media Media docs size/s [PR only] 6-50 LoC changed labels Jun 25, 2025
@chrisdavidmills chrisdavidmills changed the title Add information on HEVC codec parameter values Technical review: Add information on missing MP4/HEVC codec parameter values Jun 25, 2025
Copy link
Contributor

github-actions bot commented Jun 25, 2025

Preview URLs

External URLs (3)

URL: /en-US/docs/Web/Media/Guides/Formats/codecs_parameter
Title: Codecs in common media types

(comment last updated: 2025-07-04 08:35:05)

Copy link
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ping me when this is done. FWIW, I like where it is heading.

@chrisdavidmills chrisdavidmills marked this pull request as ready for review July 3, 2025 05:40
@chrisdavidmills chrisdavidmills changed the title Technical review: Add information on missing MP4/HEVC codec parameter values Editorial review: Add information on missing MP4/HEVC codec parameter values Jul 3, 2025
@chrisdavidmills
Copy link
Contributor Author

Ping me when this is done. FWIW, I like where it is heading.

@hamishwillee OK, this one has had a technical review and been approved (over email, rather than on GitHub). It is ready for you to look at now. Cheers mate!

Copy link
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@chrisdavidmills Thanks for this - looks great.

  1. I think we need some cross linking to https://developer.mozilla.org/en-US/docs/Web/Media/Guides/Formats/Video_codecs#hevc_h.265. You could do this instead of the wikipedia link - pushing that to a see also.

  2. The BCD update is also relevant. That probably should go under each section in https://developer.mozilla.org//en-US/docs/Web/Media/Guides/Formats/Video_codecs and not this. Perhaps a problem for another day?

@chrisdavidmills
Copy link
Contributor Author

@chrisdavidmills Thanks for this - looks great.

1. I think we need some cross linking to https://developer.mozilla.org/en-US/docs/Web/Media/Guides/Formats/Video_codecs#hevc_h.265. You could do this instead of the wikipedia link - pushing that to a see also.

Agreed. I've updated it just as you suggested.

2. The BCD update is also relevant. That probably should go under each section in https://developer.mozilla.org//en-US/docs/Web/Media/Guides/Formats/Video_codecs and not this. Perhaps a problem for another day?

The whole "how to represent media support" conversation is a hot one on BCD right now, and I don't think a conclusion has been reached yet. It would be better to leave that for now, IMO.

Copy link
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be great if we could also have a link back from https://developer.mozilla.org/en-US/docs/Web/Media/Guides/Formats/Video_codecs#hevc_h.265. There is a link to the container section from this doc which then links to this section, but it is a bit of a round tip.

But I don't want to block on that so merging and up to you if you create that link in a post process. Thanks!

@hamishwillee hamishwillee merged commit 69f8100 into mdn:main Jul 6, 2025
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:Media Media docs size/s [PR only] 6-50 LoC changed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants