Struct script::dom::htmlmediaelement::HTMLMediaElement

#[repr(C)]
pub struct HTMLMediaElement {

    htmlelement: HTMLElement,
    network_state: Cell<NetworkState>,
    ready_state: Cell<ReadyState>,
    src_object: DomRefCell<Option<SrcObject>>,
    current_src: DomRefCell<String>,
    generation_id: Cell<u32>,
    fired_loadeddata_event: Cell<bool>,
    error: MutNullableDom<MediaError>,
    paused: Cell<bool>,
    defaultPlaybackRate: Cell<f64>,
    playbackRate: Cell<f64>,
    autoplaying: Cell<bool>,
    delaying_the_load_event_flag: DomRefCell<Option<LoadBlocker>>,
    pending_play_promises: DomRefCell<Vec<Rc<Promise>>>,
    in_flight_play_promises_queue: DomRefCell<VecDeque<(Box<[Rc<Promise>]>, Result<(), Error>)>>,
    player: DomRefCell<Option<Arc<Mutex<dyn Player>>>>,
    video_renderer: Arc<Mutex<MediaFrameRenderer>>,
    audio_renderer: DomRefCell<Option<Arc<Mutex<dyn AudioRenderer>>>>,
    show_poster: Cell<bool>,
    duration: Cell<f64>,
    playback_position: Cell<f64>,
    default_playback_start_position: Cell<f64>,
    volume: Cell<f64>,
    seeking: Cell<bool>,
    muted: Cell<bool>,
    resource_url: DomRefCell<Option<ServoUrl>>,
    blob_url: DomRefCell<Option<ServoUrl>>,
    played: DomRefCell<TimeRangesContainer>,
    audio_tracks_list: MutNullableDom<AudioTrackList>,
    video_tracks_list: MutNullableDom<VideoTrackList>,
    text_tracks_list: MutNullableDom<TextTrackList>,
    next_timeupdate_event: Cell<Instant>,
    current_fetch_context: DomRefCell<Option<HTMLMediaElementFetchContext>>,
    id: Cell<u64>,
    media_controls_id: DomRefCell<Option<String>>,
    player_context: WindowGLContext,
}

Fields

htmlelement: HTMLElement

network_state: Cell<NetworkState>

https://html.spec.whatwg.org/multipage/#dom-media-networkstate

ready_state: Cell<ReadyState>

https://html.spec.whatwg.org/multipage/#dom-media-readystate

src_object: DomRefCell<Option<SrcObject>>

https://html.spec.whatwg.org/multipage/#dom-media-srcobject

current_src: DomRefCell<String>

https://html.spec.whatwg.org/multipage/#dom-media-currentsrc

generation_id: Cell<u32>

Incremented whenever tasks associated with this element are cancelled.

fired_loadeddata_event: Cell<bool>

https://html.spec.whatwg.org/multipage/#fire-loadeddata

Reset to false every time the load algorithm is invoked.

error: MutNullableDom<MediaError>

https://html.spec.whatwg.org/multipage/#dom-media-error

paused: Cell<bool>

https://html.spec.whatwg.org/multipage/#dom-media-paused

defaultPlaybackRate: Cell<f64>

https://html.spec.whatwg.org/multipage/#dom-media-defaultplaybackrate

playbackRate: Cell<f64>

https://html.spec.whatwg.org/multipage/#dom-media-playbackrate

autoplaying: Cell<bool>

https://html.spec.whatwg.org/multipage/#attr-media-autoplay

delaying_the_load_event_flag: DomRefCell<Option<LoadBlocker>>

https://html.spec.whatwg.org/multipage/#delaying-the-load-event-flag

pending_play_promises: DomRefCell<Vec<Rc<Promise>>>

https://html.spec.whatwg.org/multipage/#list-of-pending-play-promises

in_flight_play_promises_queue: DomRefCell<VecDeque<(Box<[Rc<Promise>]>, Result<(), Error>)>>

Play promises which are soon to be fulfilled by a queued task.

player: DomRefCell<Option<Arc<Mutex<dyn Player>>>>

video_renderer: Arc<Mutex<MediaFrameRenderer>>

audio_renderer: DomRefCell<Option<Arc<Mutex<dyn AudioRenderer>>>>

show_poster: Cell<bool>

https://html.spec.whatwg.org/multipage/#show-poster-flag

duration: Cell<f64>

https://html.spec.whatwg.org/multipage/#dom-media-duration

playback_position: Cell<f64>

https://html.spec.whatwg.org/multipage/#official-playback-position

default_playback_start_position: Cell<f64>

https://html.spec.whatwg.org/multipage/#default-playback-start-position

volume: Cell<f64>

https://html.spec.whatwg.org/multipage/#dom-media-volume

seeking: Cell<bool>

https://html.spec.whatwg.org/multipage/#dom-media-seeking

muted: Cell<bool>

https://html.spec.whatwg.org/multipage/#dom-media-muted

resource_url: DomRefCell<Option<ServoUrl>>

URL of the media resource, if any.

blob_url: DomRefCell<Option<ServoUrl>>

URL of the media resource, if the resource is set through the src_object attribute and it is a blob.

played: DomRefCell<TimeRangesContainer>

https://html.spec.whatwg.org/multipage/#dom-media-played

audio_tracks_list: MutNullableDom<AudioTrackList>

video_tracks_list: MutNullableDom<VideoTrackList>

text_tracks_list: MutNullableDom<TextTrackList>

https://html.spec.whatwg.org/multipage/#dom-media-texttracks

next_timeupdate_event: Cell<Instant>

Time of last timeupdate notification.

current_fetch_context: DomRefCell<Option<HTMLMediaElementFetchContext>>

Latest fetch request context.

id: Cell<u64>

Player Id reported the player thread

media_controls_id: DomRefCell<Option<String>>

Media controls id. In order to workaround the lack of privileged JS context, we secure the the access to the “privileged” document.servoGetMediaControls(id) API by keeping a whitelist of media controls identifiers.

player_context: WindowGLContext

Implementations

impl HTMLMediaElement

pub fn new_inherited( tag_name: LocalName, prefix: Option<Prefix>, document: &Document, ) -> Self

pub fn get_ready_state(&self) -> ReadyState

fn media_type_id(&self) -> HTMLMediaElementTypeId

fn play_media(&self)

pub fn delay_load_event(&self, delay: bool, can_gc: CanGc)

Marks that element as delaying the load event or not.

Nothing happens if the element was already delaying the load event and we pass true to that method again.

https://html.spec.whatwg.org/multipage/#delaying-the-load-event-flag

fn time_marches_on(&self)

https://html.spec.whatwg.org/multipage/#time-marches-on

fn internal_pause_steps(&self)

https://html.spec.whatwg.org/multipage/#internal-pause-steps

fn is_allowed_to_play(&self) -> bool

fn notify_about_playing(&self)

fn change_ready_state(&self, ready_state: ReadyState, can_gc: CanGc)

fn invoke_resource_selection_algorithm(&self, can_gc: CanGc)

fn resource_selection_algorithm_sync(&self, base_url: ServoUrl, can_gc: CanGc)

fn fetch_request( &self, offset: Option<u64>, seek_lock: Option<SeekLock>, can_gc: CanGc, )

fn resource_fetch_algorithm(&self, resource: Resource, can_gc: CanGc)

fn queue_dedicated_media_source_failure_steps(&self, can_gc: CanGc)

Queues a task to run the dedicated media source failure steps.

fn queue_ratechange_event(&self)

fn in_error_state(&self) -> bool

fn is_potentially_playing(&self) -> bool

fn is_blocked_media_element(&self) -> bool

fn is_paused_for_user_interaction(&self) -> bool

fn is_paused_for_in_band_content(&self) -> bool

fn media_element_load_algorithm(&self, can_gc: CanGc)

fn push_pending_play_promise(&self, promise: &Rc<Promise>)

Appends a promise to the list of pending play promises.

fn take_pending_play_promises(&self, result: Result<(), Error>)

Takes the pending play promises.

The result with which these promises will be fulfilled is passed here and this method returns nothing because we actually just move the current list of pending play promises to the in_flight_play_promises_queue field.

Each call to this method must be followed by a call to fulfill_in_flight_play_promises, to actually fulfill the promises which were taken and moved to the in-flight queue.

fn fulfill_in_flight_play_promises<F>(&self, f: F)

where F: FnOnce(),

Fulfills the next in-flight play promises queue after running a closure.

See the comment on take_pending_play_promises for why this method does not take a list of promises to fulfill. Callers cannot just pop the front list off of in_flight_play_promises_queue and later fulfill the promises because that would mean putting #[allow(crown::unrooted_must_root)] on even more functions, potentially hiding actual safety bugs.

pub fn handle_source_child_insertion(&self, can_gc: CanGc)

Handles insertion of source children.

https://html.spec.whatwg.org/multipage/#the-source-element:nodes-are-inserted

fn seek(&self, time: f64, _approximate_for_speed: bool)

fn seek_end(&self)

pub fn process_poster_image_loaded(&self, image: Arc<Image>)

https://html.spec.whatwg.org/multipage/#poster-frame

fn setup_media_player( &self, resource: &Resource, can_gc: CanGc, ) -> Result<(), ()>

pub fn set_audio_track(&self, idx: usize, enabled: bool)

pub fn set_video_track(&self, idx: usize, enabled: bool)

fn handle_player_event(&self, event: &PlayerEvent, can_gc: CanGc)

fn earliest_possible_position(&self) -> f64

fn render_controls(&self)

fn remove_controls(&self)

pub fn get_current_frame(&self) -> Option<VideoFrame>

pub fn set_audio_renderer( &self, audio_renderer: Arc<Mutex<dyn AudioRenderer>>, can_gc: CanGc, )

By default the audio is rendered through the audio sink automatically selected by the servo-media Player instance. However, in some cases, like the WebAudio MediaElementAudioSourceNode, we need to set a custom audio renderer.

fn send_media_session_event(&self, event: MediaSessionEvent)

pub fn set_duration(&self, duration: f64)

fn set_show_poster(&self, show_poster: bool)

Sets a new value for the show_poster propperty. If the poster is being hidden because new frames should render, updates video_renderer to allow it.

pub fn reset(&self)

impl HTMLMediaElement

fn direction_of_playback(&self) -> PlaybackDirection

Trait Implementations

impl Castable for HTMLMediaElement

fn is<T>(&self) -> bool

where T: DerivedFrom<Self>,

Check whether a DOM object implements one of its deriving interfaces.

fn upcast<T>(&self) -> &T

where T: Castable, Self: DerivedFrom<T>,

Cast a DOM object upwards to one of the interfaces it derives from.

fn downcast<T>(&self) -> Option<&T>

where T: DerivedFrom<Self>,

Cast a DOM object downwards to one of the interfaces it might implement.

impl DomObject for HTMLMediaElement

fn reflector(&self) -> &Reflector

Returns the receiver’s reflector.

fn global(&self) -> Root<Dom<GlobalScope>>

where Self: Sized,

Returns the global scope of the realm that the DomObject was created in.

impl Drop for HTMLMediaElement

fn drop(&mut self)

Executes the destructor for this type.

impl HTMLMediaElementMethods for HTMLMediaElement

fn GetDefaultPlaybackRate(&self) -> Result<Finite<f64>, Error>

https://html.spec.whatwg.org/multipage/#dom-media-defaultplaybackrate

fn SetDefaultPlaybackRate(&self, value: Finite<f64>) -> Result<(), Error>

https://html.spec.whatwg.org/multipage/#dom-media-defaultplaybackrate

fn GetPlaybackRate(&self) -> Result<Finite<f64>, Error>

https://html.spec.whatwg.org/multipage/#dom-media-playbackrate

fn SetPlaybackRate(&self, value: Finite<f64>) -> Result<(), Error>

https://html.spec.whatwg.org/multipage/#dom-media-playbackrate

fn NetworkState(&self) -> u16

fn ReadyState(&self) -> u16

fn Autoplay(&self) -> bool

fn SetAutoplay(&self, value: bool)

fn Loop(&self) -> bool

fn SetLoop(&self, value: bool)

fn DefaultMuted(&self) -> bool

fn SetDefaultMuted(&self, value: bool)

fn Controls(&self) -> bool

fn SetControls(&self, value: bool)

fn Src(&self) -> USVString

fn SetSrc(&self, value: USVString)

fn GetCrossOrigin(&self) -> Option<DOMString>

fn SetCrossOrigin(&self, value: Option<DOMString>)

fn Muted(&self) -> bool

fn SetMuted(&self, value: bool)

fn GetSrcObject(&self) -> Option<MediaStreamOrBlob>

fn SetSrcObject(&self, value: Option<MediaStreamOrBlob>, can_gc: CanGc)

fn Preload(&self) -> DOMString

fn SetPreload(&self, value: DOMString)

fn CurrentSrc(&self) -> USVString

fn Load(&self, can_gc: CanGc)

fn CanPlayType(&self, type_: DOMString) -> CanPlayTypeResult

fn GetError(&self) -> Option<Root<Dom<MediaError>>>

fn Play(&self, comp: InRealm<'_>, can_gc: CanGc) -> Rc<Promise>

fn Pause(&self, can_gc: CanGc)

fn Paused(&self) -> bool

fn Duration(&self) -> f64

fn CurrentTime(&self) -> Finite<f64>

fn SetCurrentTime(&self, time: Finite<f64>)

fn Seeking(&self) -> bool

fn Ended(&self) -> bool

fn FastSeek(&self, time: Finite<f64>)

fn Played(&self) -> Root<Dom<TimeRanges>>

fn Buffered(&self) -> Root<Dom<TimeRanges>>

fn AudioTracks(&self) -> Root<Dom<AudioTrackList>>

fn VideoTracks(&self) -> Root<Dom<VideoTrackList>>

fn TextTracks(&self) -> Root<Dom<TextTrackList>>

fn AddTextTrack( &self, kind: TextTrackKind, label: DOMString, language: DOMString, ) -> Root<Dom<TextTrack>>

fn GetVolume(&self) -> Result<Finite<f64>, Error>

fn SetVolume(&self, value: Finite<f64>) -> Result<(), Error>

impl HasParent for HTMLMediaElement

fn as_parent(&self) -> &HTMLElement

This is used in a type assertion to ensure that the source and webidls agree as to what the parent type is

type Parent = HTMLElement

impl IDLInterface for HTMLMediaElement

fn derives(class: &'static DOMClass) -> bool

Returns whether the given DOM class derives that interface.

impl MallocSizeOf for HTMLMediaElement

fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize

Measure the heap usage of all descendant heap-allocated structures, but not the space taken up by the value itself.

impl MutDomObject for HTMLMediaElement

unsafe fn init_reflector(&self, obj: *mut JSObject)

Initializes the Reflector

impl PartialEq for HTMLMediaElement

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ToJSValConvertible for HTMLMediaElement

unsafe fn to_jsval(&self, cx: *mut JSContext, rval: MutableHandleValue<'_>)

Convert self to a JSVal. JSAPI failure causes a panic.

impl Traceable for HTMLMediaElement

unsafe fn trace(&self, tracer: *mut JSTracer)

Trace self.

impl VirtualMethods for HTMLMediaElement

fn super_type(&self) -> Option<&dyn VirtualMethods>

Returns self as the superclass of the implementation for this trait, if any.

fn attribute_mutated(&self, attr: &Attr, mutation: AttributeMutation<'_>)

Called when attributes of a node are mutated. https://dom.spec.whatwg.org/#attribute-is-set https://dom.spec.whatwg.org/#attribute-is-removed

fn unbind_from_tree(&self, context: &UnbindContext<'_>)

Called when a Node is removed from a tree, where ‘tree_connected’ indicates whether the tree is part of a Document. Implements removing steps: https://dom.spec.whatwg.org/#concept-node-remove-ext

fn attribute_affects_presentational_hints(&self, attr: &Attr) -> bool

Returns true if given attribute attr affects style of the given element.

fn parse_plain_attribute(&self, name: &LocalName, value: DOMString) -> AttrValue

Returns the right AttrValue variant for the attribute with name name on this element.

fn bind_to_tree(&self, context: &BindContext)

Called when a Node is appended to a tree, where ‘tree_connected’ indicates whether the tree is part of a Document.

fn children_changed(&self, mutation: &ChildrenMutation<'_>)

Called on the parent when its children are changed.

fn handle_event(&self, event: &Event)

Called during event dispatch after the bubbling phase completes.

fn adopting_steps(&self, old_doc: &Document)

https://dom.spec.whatwg.org/#concept-node-adopt-ext

fn cloning_steps( &self, copy: &Node, maybe_doc: Option<&Document>, clone_children: CloneChildrenFlag, )

https://dom.spec.whatwg.org/#concept-node-clone-ext

fn pop(&self)

Called on an element when it is popped off the stack of open elements of a parser.

impl DerivedFrom<Element> for HTMLMediaElement

impl DerivedFrom<EventTarget> for HTMLMediaElement

impl DerivedFrom<HTMLElement> for HTMLMediaElement

impl DerivedFrom<HTMLMediaElement> for HTMLAudioElement

impl DerivedFrom<HTMLMediaElement> for HTMLMediaElement

impl DerivedFrom<HTMLMediaElement> for HTMLVideoElement

impl DerivedFrom<Node> for HTMLMediaElement

impl Eq for HTMLMediaElement