gecko-dev/dom/webidl/MediaCapabilities.webidl
alwu 25e584800a Bug 1898344 - part5 : implement MediaCapabilitiesDecodingInfo. r=media-playback-reviewers,webidl,smaug,padenot
This patch implement a MediaKeySystemAccess in
MediaCapabilitiesDecodingInfo per spec [1], but we haven't implemented
the configuration part yet.

Currently Chromium doesn't implement the configuration [2] and WebKit
[3] only implements the configuration but no key system access.

[1] https://www.w3.org/TR/media-capabilities/#media-capabilities-interface
[2] https://bit.ly/3RcwuaV
[3] https://searchfox.org/wubkat/source/Source/WebCore/Modules/mediacapabilities/MediaCapabilitiesDecodingInfo.idl

Differential Revision: https://phabricator.services.mozilla.com/D212324
2024-06-10 23:20:44 +00:00

111 lines
2.9 KiB
Plaintext

/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/.
*
* The origin of this IDL file is
* https://w3c.github.io/media-capabilities/
*
* Copyright © 2018 the Contributors to the Media Capabilities Specification
*/
dictionary MediaConfiguration {
VideoConfiguration video;
AudioConfiguration audio;
};
// https://w3c.github.io/media-capabilities/#dictdef-mediaconfiguration
dictionary MediaDecodingConfiguration : MediaConfiguration {
required MediaDecodingType type;
MediaCapabilitiesKeySystemConfiguration keySystemConfiguration;
};
dictionary MediaEncodingConfiguration : MediaConfiguration {
required MediaEncodingType type;
};
// https://w3c.github.io/media-capabilities/#mediacapabilitieskeysystemconfiguration
dictionary MediaCapabilitiesKeySystemConfiguration {
required DOMString keySystem;
DOMString initDataType = "";
MediaKeysRequirement distinctiveIdentifier = "optional";
MediaKeysRequirement persistentState = "optional";
sequence<DOMString> sessionTypes;
KeySystemTrackConfiguration audio;
KeySystemTrackConfiguration video;
};
dictionary KeySystemTrackConfiguration {
DOMString robustness = "";
DOMString? encryptionScheme = null;
};
enum MediaDecodingType {
"file",
"media-source",
};
enum MediaEncodingType {
"record",
"transmission"
};
dictionary VideoConfiguration {
required DOMString contentType;
required unsigned long width;
required unsigned long height;
required unsigned long long bitrate;
required double framerate;
boolean hasAlphaChannel;
HdrMetadataType hdrMetadataType;
ColorGamut colorGamut;
TransferFunction transferFunction;
DOMString scalabilityMode;
};
enum HdrMetadataType {
"smpteSt2086",
"smpteSt2094-10",
"smpteSt2094-40"
};
enum ColorGamut {
"srgb",
"p3",
"rec2020"
};
enum TransferFunction {
"srgb",
"pq",
"hlg"
};
dictionary AudioConfiguration {
required DOMString contentType;
DOMString channels;
unsigned long long bitrate;
unsigned long samplerate;
};
dictionary MediaCapabilitiesInfo {
required boolean supported;
required boolean smooth;
required boolean powerEfficient;
};
// https://w3c.github.io/media-capabilities/#dictdef-mediacapabilitiesinfo
dictionary MediaCapabilitiesDecodingInfo : MediaCapabilitiesInfo {
// This doesn't match the spec, see https://github.com/w3c/media-capabilities/issues/219
required MediaKeySystemAccess? keySystemAccess;
// TODO : implement configuration
};
[Exposed=(Window, Worker)]
interface MediaCapabilities {
[NewObject]
Promise<MediaCapabilitiesDecodingInfo> decodingInfo(MediaDecodingConfiguration configuration);
[NewObject]
Promise<MediaCapabilitiesInfo> encodingInfo(MediaEncodingConfiguration configuration);
};