mirror of
https://github.com/classilla/tenfourfox.git
synced 2024-09-10 11:54:40 +00:00
175 lines
5.7 KiB
Plaintext
175 lines
5.7 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
|
||
|
* http://www.whatwg.org/specs/web-apps/current-work/#media-elements
|
||
|
*
|
||
|
* © Copyright 2004-2011 Apple Computer, Inc., Mozilla Foundation, and
|
||
|
* Opera Software ASA. You are granted a license to use, reproduce
|
||
|
* and create derivative works of this document.
|
||
|
*/
|
||
|
|
||
|
interface HTMLMediaElement : HTMLElement {
|
||
|
|
||
|
// error state
|
||
|
readonly attribute MediaError? error;
|
||
|
|
||
|
// network state
|
||
|
[SetterThrows]
|
||
|
attribute DOMString src;
|
||
|
readonly attribute DOMString currentSrc;
|
||
|
|
||
|
[SetterThrows]
|
||
|
attribute DOMString? crossOrigin;
|
||
|
const unsigned short NETWORK_EMPTY = 0;
|
||
|
const unsigned short NETWORK_IDLE = 1;
|
||
|
const unsigned short NETWORK_LOADING = 2;
|
||
|
const unsigned short NETWORK_NO_SOURCE = 3;
|
||
|
readonly attribute unsigned short networkState;
|
||
|
[SetterThrows]
|
||
|
attribute DOMString preload;
|
||
|
[NewObject]
|
||
|
readonly attribute TimeRanges buffered;
|
||
|
void load();
|
||
|
DOMString canPlayType(DOMString type);
|
||
|
|
||
|
// ready state
|
||
|
const unsigned short HAVE_NOTHING = 0;
|
||
|
const unsigned short HAVE_METADATA = 1;
|
||
|
const unsigned short HAVE_CURRENT_DATA = 2;
|
||
|
const unsigned short HAVE_FUTURE_DATA = 3;
|
||
|
const unsigned short HAVE_ENOUGH_DATA = 4;
|
||
|
readonly attribute unsigned short readyState;
|
||
|
readonly attribute boolean seeking;
|
||
|
|
||
|
// playback state
|
||
|
[SetterThrows]
|
||
|
attribute double currentTime;
|
||
|
[Throws]
|
||
|
void fastSeek(double time);
|
||
|
readonly attribute unrestricted double duration;
|
||
|
[ChromeOnly]
|
||
|
readonly attribute boolean isEncrypted;
|
||
|
// TODO: Bug 847376 - readonly attribute any startDate;
|
||
|
readonly attribute boolean paused;
|
||
|
[SetterThrows]
|
||
|
attribute double defaultPlaybackRate;
|
||
|
[SetterThrows]
|
||
|
attribute double playbackRate;
|
||
|
[NewObject]
|
||
|
readonly attribute TimeRanges played;
|
||
|
[NewObject]
|
||
|
readonly attribute TimeRanges seekable;
|
||
|
readonly attribute boolean ended;
|
||
|
[SetterThrows]
|
||
|
attribute boolean autoplay;
|
||
|
[SetterThrows]
|
||
|
attribute boolean loop;
|
||
|
[Throws]
|
||
|
void play();
|
||
|
[Throws]
|
||
|
void pause();
|
||
|
|
||
|
// TODO: Bug 847377 - mediaGroup and MediaController
|
||
|
// media controller
|
||
|
// attribute DOMString mediaGroup;
|
||
|
// attribute MediaController? controller;
|
||
|
|
||
|
// controls
|
||
|
[SetterThrows]
|
||
|
attribute boolean controls;
|
||
|
[SetterThrows]
|
||
|
attribute double volume;
|
||
|
attribute boolean muted;
|
||
|
[SetterThrows]
|
||
|
attribute boolean defaultMuted;
|
||
|
|
||
|
// TODO: Bug 847379
|
||
|
// tracks
|
||
|
[Pref="media.track.enabled"]
|
||
|
readonly attribute AudioTrackList audioTracks;
|
||
|
[Pref="media.track.enabled"]
|
||
|
readonly attribute VideoTrackList videoTracks;
|
||
|
[Pref="media.webvtt.enabled"]
|
||
|
readonly attribute TextTrackList? textTracks;
|
||
|
[Pref="media.webvtt.enabled"]
|
||
|
TextTrack addTextTrack(TextTrackKind kind,
|
||
|
optional DOMString label = "",
|
||
|
optional DOMString language = "");
|
||
|
};
|
||
|
|
||
|
// Mozilla extensions:
|
||
|
partial interface HTMLMediaElement {
|
||
|
[ChromeOnly]
|
||
|
readonly attribute MediaSource? mozMediaSourceObject;
|
||
|
attribute MediaStream? srcObject;
|
||
|
// TODO: remove prefixed version soon (1183495).
|
||
|
attribute MediaStream? mozSrcObject;
|
||
|
|
||
|
attribute boolean mozPreservesPitch;
|
||
|
readonly attribute boolean mozAutoplayEnabled;
|
||
|
|
||
|
// NB: for internal use with the video controls:
|
||
|
[Func="IsChromeOrXBL"] attribute boolean mozMediaStatisticsShowing;
|
||
|
[Func="IsChromeOrXBL"] attribute boolean mozAllowCasting;
|
||
|
[Func="IsChromeOrXBL"] attribute boolean mozIsCasting;
|
||
|
|
||
|
// Mozilla extension: stream capture
|
||
|
[Throws, UnsafeInPrerendering]
|
||
|
MediaStream mozCaptureStream();
|
||
|
[Throws, UnsafeInPrerendering]
|
||
|
MediaStream mozCaptureStreamUntilEnded();
|
||
|
readonly attribute boolean mozAudioCaptured;
|
||
|
|
||
|
// Mozilla extension: return embedded metadata from the stream as a
|
||
|
// JSObject with key:value pairs for each tag. This can be used by
|
||
|
// player interfaces to display the song title, artist, etc.
|
||
|
[Throws]
|
||
|
object? mozGetMetadata();
|
||
|
|
||
|
// Mozilla extension: provides access to the fragment end time if
|
||
|
// the media element has a fragment URI for the currentSrc, otherwise
|
||
|
// it is equal to the media duration.
|
||
|
readonly attribute double mozFragmentEnd;
|
||
|
|
||
|
// Mozilla extension: an audio channel type for media elements.
|
||
|
// Read AudioChannel.webidl for more information about this attribute.
|
||
|
[SetterThrows, Pref="media.useAudioChannelAPI"]
|
||
|
attribute AudioChannel mozAudioChannelType;
|
||
|
|
||
|
// In addition the media element has this new events:
|
||
|
// * onmozinterruptbegin - called when the media element is interrupted
|
||
|
// because of the audiochannel manager.
|
||
|
// * onmozinterruptend - called when the interruption is concluded
|
||
|
[Pref="media.useAudioChannelAPI"]
|
||
|
attribute EventHandler onmozinterruptbegin;
|
||
|
|
||
|
[Pref="media.useAudioChannelAPI"]
|
||
|
attribute EventHandler onmozinterruptend;
|
||
|
};
|
||
|
|
||
|
#ifdef MOZ_EME
|
||
|
// Encrypted Media Extensions
|
||
|
partial interface HTMLMediaElement {
|
||
|
[Pref="media.eme.apiVisible"]
|
||
|
readonly attribute MediaKeys? mediaKeys;
|
||
|
|
||
|
// void, not any: https://www.w3.org/Bugs/Public/show_bug.cgi?id=26457
|
||
|
[Pref="media.eme.apiVisible", NewObject]
|
||
|
Promise<void> setMediaKeys(MediaKeys? mediaKeys);
|
||
|
|
||
|
[Pref="media.eme.apiVisible"]
|
||
|
attribute EventHandler onencrypted;
|
||
|
};
|
||
|
#endif
|
||
|
|
||
|
// This is just for testing
|
||
|
partial interface HTMLMediaElement {
|
||
|
[Pref="media.useAudioChannelService.testing"]
|
||
|
readonly attribute double computedVolume;
|
||
|
[Pref="media.useAudioChannelService.testing"]
|
||
|
readonly attribute boolean computedMuted;
|
||
|
};
|