Skip to content

Add Dolby Vision Profile 10 Playback Support #2830

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.

Sign up for GitHub

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

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
+140 −5
Open

Add Dolby Vision Profile 10 Playback Support #2830

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
937e1fa
Merge pull request #24 from androidx/main
ybai001 Oct 9, 2025
e7a50e9
Add Dolby Vision Profile 10 Playback Support
ybai001 Oct 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions libraries/common/src/main/java/androidx/media3/common/MimeTypes.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -444,7 +444,8 @@ public static String getMediaMimeType(@Nullable String codec) {
} else if (codec.startsWith("dvav")
|| codec.startsWith("dva1")
|| codec.startsWith("dvhe")
|| codec.startsWith("dvh1")) {
|| codec.startsWith("dvh1")
|| codec.startsWith("dav1")) {
return MimeTypes.VIDEO_DOLBY_VISION;
} else if (codec.startsWith("av01")) {
return MimeTypes.VIDEO_AV1;
Expand Down Expand Up @@ -599,8 +600,8 @@ public static boolean isDolbyVisionCodec(
if (codecs == null) {
return false;
}
if (codecs.startsWith("dvhe") || codecs.startsWith("dvh1")) {
// profile 5
if (codecs.startsWith("dvhe") || codecs.startsWith("dvh1") || codecs.startsWith("dav1")) {
// profiles 5, 10.0 and 20.0
return true;
}
if (supplementalCodecs == null) {
Expand Down
3 changes: 3 additions & 0 deletions libraries/container/src/main/java/androidx/media3/container/Mp4Box.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,9 @@ public abstract class Mp4Box {
@SuppressWarnings("ConstantCaseForConstants")
public static final int TYPE_dvvC = 0x64767643;

@SuppressWarnings("ConstantCaseForConstants")
public static final int TYPE_dav1 = 0x64617631;

@SuppressWarnings("ConstantCaseForConstants")
public static final int TYPE_dvwC = 0x64767743;

Expand Down
5 changes: 4 additions & 1 deletion ...ries/exoplayer/src/main/java/androidx/media3/exoplayer/mediacodec/MediaCodecRenderer.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1682,7 +1682,10 @@ protected DecoderReuseEvaluation onInputFormatChanged(FormatHolder formatHolder)
// * b/229399008#comment9
// * https://github.com/androidx/media/issues/2408
if ((Objects.equals(newFormat.sampleMimeType, MimeTypes.VIDEO_AV1)
|| Objects.equals(newFormat.sampleMimeType, MimeTypes.VIDEO_VP9))
|| Objects.equals(newFormat.sampleMimeType, MimeTypes.VIDEO_VP9)
|| (Objects.equals(newFormat.sampleMimeType, MimeTypes.VIDEO_DOLBY_VISION)
&& Objects.equals(MediaCodecUtil.getDolbyVisionBlMimeType(newFormat),
MimeTypes.VIDEO_AV1)))
&& !newFormat.initializationData.isEmpty()) {
newFormat = newFormat.buildUpon().setInitializationData(null).build();
}
Expand Down
33 changes: 33 additions & 0 deletions libraries/exoplayer/src/main/java/androidx/media3/exoplayer/mediacodec/MediaCodecUtil.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@
import androidx.annotation.Nullable;
import androidx.annotation.RequiresApi;
import androidx.annotation.VisibleForTesting;
import androidx.media3.common.C;
import androidx.media3.common.Format;
import androidx.media3.common.MimeTypes;
import androidx.media3.common.util.CodecSpecificDataUtil;
Expand Down Expand Up @@ -365,6 +366,33 @@ public static Pair<Integer, Integer> getHevcBaseLayerCodecProfileAndLevel(Format
return getHevcProfileAndLevel(codecs, parts, format.colorInfo);
}

/**
* Returns a Dolby Vision base layer codec MIME type of the provided {@link Format}.
*
* @param format The media format.
* @return A Dolby Vision base layer MIME type, or null if a Dolby Vision profile is not
* identified.
*/
@Nullable
public static String getDolbyVisionBlMimeType(Format format) {

if (MimeTypes.VIDEO_DOLBY_VISION.equals(format.sampleMimeType)) {
@Nullable Pair<Integer, Integer> codecProfileAndLevel = getCodecProfileAndLevel(format);
if (codecProfileAndLevel != null) {
int profile = codecProfileAndLevel.first;
if (profile == CodecProfileLevel.DolbyVisionProfileDvheDtr
|| profile == CodecProfileLevel.DolbyVisionProfileDvheSt) {
return MimeTypes.VIDEO_H265;
} else if (profile == CodecProfileLevel.DolbyVisionProfileDvavSe) {
return MimeTypes.VIDEO_H264;
} else if (profile == CodecProfileLevel.DolbyVisionProfileDvav110) {
return MimeTypes.VIDEO_AV1;
}
}
}
return null;
}

/**
* Returns an alternative codec MIME type (besides the default {@link Format#sampleMimeType}) that
* can be used to decode samples of the provided {@link Format}.
Expand Down Expand Up @@ -394,6 +422,11 @@ public static String getAlternativeCodecMimeType(Format format) {
} else if (profile == CodecProfileLevel.DolbyVisionProfileDvavSe) {
return MimeTypes.VIDEO_H264;
} else if (profile == CodecProfileLevel.DolbyVisionProfileDvav110) {
if (format.colorInfo != null
&& format.colorInfo.colorTransfer == C.COLOR_TRANSFER_ST2084
&& format.colorInfo.colorRange == C.COLOR_RANGE_FULL) {
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Here, it means this is a DV profile 10.0 content, which is not backward compatible to AV1 so that it cannot be played as AV1 content on non-Dolby licensed device.
Instead, DV profile 10.1 and 10.4 can be played as AV1 content on non-Dolby licensed device.
See more details on https://professionalsupport.dolby.com/s/article/What-is-Dolby-Vision-Profile?language=en_US, table 2.

return null;
}
return MimeTypes.VIDEO_AV1;
}
}
Expand Down
46 changes: 46 additions & 0 deletions ...player_dash/src/main/java/androidx/media3/exoplayer/dash/manifest/DashManifestParser.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@
import android.util.Xml;
import androidx.annotation.Nullable;
import androidx.media3.common.C;
import androidx.media3.common.ColorInfo;
import androidx.media3.common.DrmInitData;
import androidx.media3.common.DrmInitData.SchemeData;
import androidx.media3.common.Format;
Expand Down Expand Up @@ -848,6 +849,9 @@ protected Format buildFormat(
codecs = MimeTypes.CODEC_E_AC3_JOC;
}
}

ColorInfo colorInfo = getColorInfoForFormat(codecs, supplementalCodecs, supplementalProfiles);

if (MimeTypes.isDolbyVisionCodec(codecs, supplementalCodecs)) {
sampleMimeType = MimeTypes.VIDEO_DOLBY_VISION;
codecs = supplementalCodecs != null ? supplementalCodecs : codecs;
Expand All @@ -868,6 +872,7 @@ protected Format buildFormat(
.setPeakBitrate(bitrate)
.setSelectionFlags(selectionFlags)
.setRoleFlags(roleFlags)
.setColorInfo(colorInfo)
.setLanguage(language)
.setTileCountHorizontal(tileCounts != null ? tileCounts.first : Format.NO_VALUE)
.setTileCountVertical(tileCounts != null ? tileCounts.second : Format.NO_VALUE);
Expand Down Expand Up @@ -2174,6 +2179,47 @@ private boolean isDvbProfileDeclared(String[] profiles) {
return false;
}

private static ColorInfo getColorInfoForFormat(
@Nullable String codecs,
@Nullable String supplementalCodecs,
@Nullable String supplementalProfiles) {

@C.ColorSpace int colorSpace = Format.NO_VALUE;
@C.ColorRange int colorRange = Format.NO_VALUE;
@C.ColorTransfer int colorTransfer = Format.NO_VALUE;

if (MimeTypes.isDolbyVisionCodec(codecs, supplementalCodecs)) {
if (codecs.startsWith("dvhe") || codecs.startsWith("dvh1") || codecs.startsWith("dav1")) {
// profiles 5, 10.0 and 20.0
colorSpace = C.COLOR_SPACE_BT2020;
colorTransfer = C.COLOR_TRANSFER_ST2084;
colorRange = C.COLOR_RANGE_FULL;
} else if (supplementalProfiles != null) {
if (supplementalProfiles.equals("db1p")) {
//BL signal cross-compatibility ID = 1 (e.g profile 8.1)
colorSpace = C.COLOR_SPACE_BT2020;
colorTransfer = C.COLOR_TRANSFER_ST2084;
colorRange = C.COLOR_RANGE_LIMITED;
} else if (supplementalProfiles.startsWith("db4")) { // db4g or db4h
//BL signal cross-compatibility ID = 4 (e.g profile 8.4)
colorSpace = C.COLOR_SPACE_BT2020;
colorTransfer = C.COLOR_TRANSFER_HLG;
colorRange = C.COLOR_RANGE_LIMITED;
}
}
}

if (colorSpace == Format.NO_VALUE) {
return null;
}

return new ColorInfo.Builder()
.setColorSpace(colorSpace)
.setColorRange(colorRange)
.setColorTransfer(colorTransfer)
.build();
}

/** A parsed Representation element. */
protected static final class RepresentationInfo {

Expand Down
1 change: 1 addition & 0 deletions libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/HlsMediaPeriod.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -913,6 +913,7 @@ private static Format deriveVideoFormat(Format variantFormat) {
.setFrameRate(variantFormat.frameRate)
.setSelectionFlags(variantFormat.selectionFlags)
.setRoleFlags(variantFormat.roleFlags)
.setColorInfo(variantFormat.colorInfo)
.build();
}

Expand Down
47 changes: 47 additions & 0 deletions ...exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/playlist/HlsPlaylistParser.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@
import android.util.Base64;
import androidx.annotation.Nullable;
import androidx.media3.common.C;
import androidx.media3.common.ColorInfo;
import androidx.media3.common.DrmInitData;
import androidx.media3.common.DrmInitData.SchemeData;
import androidx.media3.common.Format;
Expand Down Expand Up @@ -394,6 +395,47 @@ private static int skipIgnorableWhitespace(BufferedReader reader, boolean skipLi
return c;
}

private static ColorInfo getColorInfoForFormat(
@Nullable String codecs,
@Nullable String supplementalCodecs,
@Nullable String supplementalProfiles) {

@C.ColorSpace int colorSpace = Format.NO_VALUE;
@C.ColorRange int colorRange = Format.NO_VALUE;
@C.ColorTransfer int colorTransfer = Format.NO_VALUE;

if (MimeTypes.isDolbyVisionCodec(codecs, supplementalCodecs)) {
if (codecs.startsWith("dvhe") || codecs.startsWith("dvh1") || codecs.startsWith("dav1")) {
// profiles 5, 10.0 and 20.0
colorSpace = C.COLOR_SPACE_BT2020;
colorTransfer = C.COLOR_TRANSFER_ST2084;
colorRange = C.COLOR_RANGE_FULL;
} else if (supplementalProfiles != null) {
if (supplementalProfiles.equals("db1p")) {
//BL signal cross-compatibility ID = 1 (e.g profile 8.1)
colorSpace = C.COLOR_SPACE_BT2020;
colorTransfer = C.COLOR_TRANSFER_ST2084;
colorRange = C.COLOR_RANGE_LIMITED;
} else if (supplementalProfiles.startsWith("db4")) { // db4g or db4h
//BL signal cross-compatibility ID = 4 (e.g profile 8.4)
colorSpace = C.COLOR_SPACE_BT2020;
colorTransfer = C.COLOR_TRANSFER_HLG;
colorRange = C.COLOR_RANGE_LIMITED;
}
}
}

if (colorSpace == Format.NO_VALUE) {
return null;
}

return new ColorInfo.Builder()
.setColorSpace(colorSpace)
.setColorRange(colorRange)
.setColorTransfer(colorTransfer)
.build();
}

private static boolean isDolbyVisionFormat(
@Nullable String videoRange,
@Nullable String codecs,
Expand Down Expand Up @@ -484,6 +526,10 @@ private static HlsMultivariantPlaylist parseMultivariantPlaylist(
supplementalProfiles = codecsAndProfiles[1];
}
}

ColorInfo colorInfo =
getColorInfoForFormat(codecs, supplementalCodecs, supplementalProfiles);

String videoCodecs = Util.getCodecsOfType(codecs, C.TRACK_TYPE_VIDEO);
if (isDolbyVisionFormat(
videoRange, videoCodecs, supplementalCodecs, supplementalProfiles)) {
Expand Down Expand Up @@ -545,6 +591,7 @@ private static HlsMultivariantPlaylist parseMultivariantPlaylist(
.setHeight(height)
.setFrameRate(frameRate)
.setRoleFlags(roleFlags)
.setColorInfo(colorInfo)
.build();
Variant variant =
new Variant(
Expand Down
3 changes: 2 additions & 1 deletion libraries/extractor/src/main/java/androidx/media3/extractor/mp4/BoxParser.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1228,7 +1228,8 @@ private static StsdData parseStsd(
|| childAtomType == Mp4Box.TYPE_dva1
|| childAtomType == Mp4Box.TYPE_dvhe
|| childAtomType == Mp4Box.TYPE_dvh1
|| childAtomType == Mp4Box.TYPE_apv1) {
|| childAtomType == Mp4Box.TYPE_apv1
|| childAtomType == Mp4Box.TYPE_dav1) {
parseVideoSampleEntry(
stsd,
childAtomType,
Expand Down