/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* vim: set ts=8 sts=2 et sw=2 tw=80: */ /* 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/. */ #ifndef mozilla_dom_HTMLMediaElement_h #define mozilla_dom_HTMLMediaElement_h #include "nsIDOMHTMLMediaElement.h" #include "nsGenericHTMLElement.h" #include "MediaDecoderOwner.h" #include "nsCycleCollectionParticipant.h" #include "nsIObserver.h" #include "mozilla/CORSMode.h" #include "DOMMediaStream.h" #include "DecoderTraits.h" #include "nsIAudioChannelAgent.h" #include "mozilla/Attributes.h" #include "mozilla/dom/Promise.h" #include "mozilla/dom/TextTrackManager.h" #include "mozilla/WeakPtr.h" #include "MediaDecoder.h" #ifdef MOZ_EME #include "mozilla/dom/MediaKeys.h" #endif #include "mozilla/StateWatching.h" #include "nsGkAtoms.h" // X.h on Linux #defines CurrentTime as 0L, so we have to #undef it here. #ifdef CurrentTime #undef CurrentTime #endif #include "mozilla/dom/HTMLMediaElementBinding.h" // Define to output information on decoding and painting framerate /* #define DEBUG_FRAME_RATE 1 */ typedef uint16_t nsMediaNetworkState; typedef uint16_t nsMediaReadyState; namespace mozilla { class ErrorResult; class MediaResource; class MediaDecoder; class VideoFrameContainer; namespace dom { class MediaKeys; class TextTrack; class TimeRanges; class WakeLock; class MediaTrack; } // namespace dom } // namespace mozilla class AutoNotifyAudioChannelAgent; class nsIChannel; class nsIHttpChannel; class nsILoadGroup; class nsIRunnable; class nsITimer; class nsRange; namespace mozilla { namespace dom { // Number of milliseconds between timeupdate events as defined by spec #define TIMEUPDATE_MS 250 class MediaError; class MediaSource; class TextTrackList; class AudioTrackList; class VideoTrackList; class HTMLMediaElement : public nsGenericHTMLElement, public nsIDOMHTMLMediaElement, public nsIObserver, public MediaDecoderOwner, public nsIAudioChannelAgentCallback, public SupportsWeakPtr { friend AutoNotifyAudioChannelAgent; public: typedef mozilla::TimeStamp TimeStamp; typedef mozilla::layers::ImageContainer ImageContainer; typedef mozilla::VideoFrameContainer VideoFrameContainer; typedef mozilla::MediaStream MediaStream; typedef mozilla::MediaResource MediaResource; typedef mozilla::MediaDecoderOwner MediaDecoderOwner; typedef mozilla::MetadataTags MetadataTags; MOZ_DECLARE_WEAKREFERENCE_TYPENAME(HTMLMediaElement) CORSMode GetCORSMode() { return mCORSMode; } explicit HTMLMediaElement(already_AddRefed& aNodeInfo); /** * This is used when the browser is constructing a video element to play * a channel that we've already started loading. The src attribute and * children are ignored. * @param aChannel the channel to use * @param aListener returns a stream listener that should receive * notifications for the stream */ nsresult LoadWithChannel(nsIChannel *aChannel, nsIStreamListener **aListener); // nsIDOMHTMLMediaElement NS_DECL_NSIDOMHTMLMEDIAELEMENT NS_DECL_NSIOBSERVER NS_DECL_NSIAUDIOCHANNELAGENTCALLBACK // nsISupports NS_DECL_ISUPPORTS_INHERITED NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(HTMLMediaElement, nsGenericHTMLElement) virtual bool ParseAttribute(int32_t aNamespaceID, nsIAtom* aAttribute, const nsAString& aValue, nsAttrValue& aResult) override; // SetAttr override. C++ is stupid, so have to override both // overloaded methods. nsresult SetAttr(int32_t aNameSpaceID, nsIAtom* aName, const nsAString& aValue, bool aNotify) { return SetAttr(aNameSpaceID, aName, nullptr, aValue, aNotify); } virtual nsresult SetAttr(int32_t aNameSpaceID, nsIAtom* aName, nsIAtom* aPrefix, const nsAString& aValue, bool aNotify) override; virtual nsresult UnsetAttr(int32_t aNameSpaceID, nsIAtom* aAttr, bool aNotify) override; virtual nsresult AfterSetAttr(int32_t aNameSpaceID, nsIAtom* aName, const nsAttrValue* aValue, bool aNotify) override; virtual nsresult BindToTree(nsIDocument* aDocument, nsIContent* aParent, nsIContent* aBindingParent, bool aCompileEventHandlers) override; virtual void UnbindFromTree(bool aDeep = true, bool aNullParent = true) override; virtual void DoneCreatingElement() override; virtual bool IsHTMLFocusable(bool aWithMouse, bool *aIsFocusable, int32_t *aTabIndex) override; virtual int32_t TabIndexDefault() override; /** * Call this to reevaluate whether we should start/stop due to our owner * document being active, inactive, visible or hidden. */ void NotifyOwnerDocumentActivityChanged(); // This method does the work necessary for the // NotifyOwnerDocumentActivityChanged() notification. It returns true if the // media element was paused as a result. virtual bool NotifyOwnerDocumentActivityChangedInternal(); // Called by the video decoder object, on the main thread, // when it has read the metadata containing video dimensions, // etc. virtual void MetadataLoaded(const MediaInfo* aInfo, nsAutoPtr aTags) final override; // Called by the decoder object, on the main thread, // when it has read the first frame of the video or audio. virtual void FirstFrameLoaded() final override; // Called by the video decoder object, on the main thread, // when the resource has a network error during loading. virtual void NetworkError() final override; // Called by the video decoder object, on the main thread, when the // resource has a decode error during metadata loading or decoding. virtual void DecodeError() final override; // Return true if error attribute is not null. virtual bool HasError() const final override; // Called by the video decoder object, on the main thread, when the // resource load has been cancelled. virtual void LoadAborted() final override; // Called by the video decoder object, on the main thread, // when the video playback has ended. virtual void PlaybackEnded() final override; // Called by the video decoder object, on the main thread, // when the resource has started seeking. virtual void SeekStarted() final override; // Called by the video decoder object, on the main thread, // when the resource has completed seeking. virtual void SeekCompleted() final override; // Called by the media stream, on the main thread, when the download // has been suspended by the cache or because the element itself // asked the decoder to suspend the download. virtual void DownloadSuspended() final override; // Called by the media stream, on the main thread, when the download // has been resumed by the cache or because the element itself // asked the decoder to resumed the download. // If aForceNetworkLoading is True, ignore the fact that the download has // previously finished. We are downloading the middle of the media after // having downloaded the end, we need to notify the element a download in // ongoing. virtual void DownloadResumed(bool aForceNetworkLoading = false) final override; // Called to indicate the download is progressing. virtual void DownloadProgressed() final override; // Called by the media decoder to indicate whether the media cache has // suspended the channel. virtual void NotifySuspendedByCache(bool aIsSuspended) final override; virtual bool IsActive() const final override; virtual bool IsHidden() const final override; // In order to create overlayImageContainer to support DOMHwMediaStream. VideoFrameContainer* GetOverlayImageVideoFrameContainer(); // Called by the media decoder and the video frame to get the // ImageContainer containing the video data. B2G_ACL_EXPORT virtual VideoFrameContainer* GetVideoFrameContainer() final override; layers::ImageContainer* GetImageContainer(); // Dispatch events virtual nsresult DispatchAsyncEvent(const nsAString& aName) final override; // Triggers a recomputation of readyState. void UpdateReadyState() override { UpdateReadyStateInternal(); } // Dispatch events that were raised while in the bfcache nsresult DispatchPendingMediaEvents(); // Return true if we can activate autoplay assuming enough data has arrived. bool CanActivateAutoplay(); // Notify that state has changed that might cause an autoplay element to // start playing. // If the element is 'autoplay' and is ready to play back (not paused, // autoplay pref enabled, etc), it should start playing back. void CheckAutoplayDataReady(); // Check if the media element had crossorigin set when loading started bool ShouldCheckAllowOrigin(); // Returns true if the currently loaded resource is CORS same-origin with // respect to the document. bool IsCORSSameOrigin(); // Is the media element potentially playing as defined by the HTML 5 specification. // http://www.whatwg.org/specs/web-apps/current-work/#potentially-playing bool IsPotentiallyPlaying() const; // Has playback ended as defined by the HTML 5 specification. // http://www.whatwg.org/specs/web-apps/current-work/#ended bool IsPlaybackEnded() const; // principal of the currently playing resource. Anything accessing the contents // of this element must have a principal that subsumes this principal. // Returns null if nothing is playing. already_AddRefed GetCurrentPrincipal(); // called to notify that the principal of the decoder's media resource has changed. virtual void NotifyDecoderPrincipalChanged() final override; // Update the visual size of the media. Called from the decoder on the // main thread when/if the size changes. void UpdateMediaSize(const nsIntSize& aSize); // Like UpdateMediaSize, but only updates the size if no size has yet // been set. void UpdateInitialMediaSize(const nsIntSize& aSize); // Returns the CanPlayStatus indicating if we can handle the // full MIME type including the optional codecs parameter. static CanPlayStatus GetCanPlay(const nsAString& aType); /** * Called when a child source element is added to this media element. This * may queue a task to run the select resource algorithm if appropriate. */ void NotifyAddedSource(); /** * Called when there's been an error fetching the resource. This decides * whether it's appropriate to fire an error event. */ void NotifyLoadError(); void NotifyMediaTrackEnabled(MediaTrack* aTrack); /** * Called when tracks become available to the source media stream. */ void NotifyMediaStreamTracksAvailable(DOMMediaStream* aStream); virtual bool IsNodeOfType(uint32_t aFlags) const override; /** * Returns the current load ID. Asynchronous events store the ID that was * current when they were enqueued, and if it has changed when they come to * fire, they consider themselves cancelled, and don't fire. */ uint32_t GetCurrentLoadID() { return mCurrentLoadID; } /** * Returns the load group for this media element's owner document. * XXX XBL2 issue. */ already_AddRefed GetDocumentLoadGroup(); /** * Returns true if the media has played or completed a seek. * Used by video frame to determine whether to paint the poster. */ bool GetPlayedOrSeeked() const { return mHasPlayedOrSeeked; } nsresult CopyInnerTo(Element* aDest); /** * Sets the Accept header on the HTTP channel to the required * video or audio MIME types. */ virtual nsresult SetAcceptHeader(nsIHttpChannel* aChannel) = 0; /** * Sets the required request headers on the HTTP channel for * video or audio requests. */ void SetRequestHeaders(nsIHttpChannel* aChannel); /** * Asynchronously awaits a stable state, whereupon aRunnable runs on the main * thread. This adds an event which run aRunnable to the appshell's list of * sections synchronous the next time control returns to the event loop. */ void RunInStableState(nsIRunnable* aRunnable); /** * Fires a timeupdate event. If aPeriodic is true, the event will only * be fired if we've not fired a timeupdate event (for any reason) in the * last 250ms, as required by the spec when the current time is periodically * increasing during playback. */ virtual void FireTimeUpdate(bool aPeriodic) final override; /** * This will return null if mSrcStream is null, or if mSrcStream is not * null but its GetPlaybackStream() returns null --- which can happen during * cycle collection unlinking! */ MediaStream* GetSrcMediaStream() const { if (!mSrcStream) { return nullptr; } if (mSrcStream->GetCameraStream()) { // XXX Remove this check with CameraPreviewMediaStream per bug 1124630. return mSrcStream->GetCameraStream(); } return mSrcStream->GetPlaybackStream(); } // WebIDL MediaError* GetError() const { return mError; } // XPCOM GetSrc() is OK void SetSrc(const nsAString& aSrc, ErrorResult& aRv) { SetHTMLAttr(nsGkAtoms::src, aSrc, aRv); } // XPCOM GetCurrentSrc() is OK void GetCrossOrigin(nsAString& aResult) { // Null for both missing and invalid defaults is ok, since we // always parse to an enum value, so we don't need an invalid // default, and we _want_ the missing default to be null. GetEnumAttr(nsGkAtoms::crossorigin, nullptr, aResult); } void SetCrossOrigin(const nsAString& aCrossOrigin, ErrorResult& aError) { SetOrRemoveNullableStringAttr(nsGkAtoms::crossorigin, aCrossOrigin, aError); } uint16_t NetworkState() const { return mNetworkState; } // Called by the media decoder object, on the main thread, // when the connection between Rtsp server and client gets lost. virtual void ResetConnectionState() final override; // XPCOM GetPreload() is OK void SetPreload(const nsAString& aValue, ErrorResult& aRv) { SetHTMLAttr(nsGkAtoms::preload, aValue, aRv); } already_AddRefed Buffered() const; // XPCOM Load() is OK // XPCOM CanPlayType() is OK uint16_t ReadyState() const { return mReadyState; } bool Seeking() const; double CurrentTime() const; void SetCurrentTime(double aCurrentTime, ErrorResult& aRv); void FastSeek(double aTime, ErrorResult& aRv); double Duration() const; bool HasAudio() const { return mMediaInfo.HasAudio(); } bool HasVideo() const { return mMediaInfo.HasVideo(); } bool IsEncrypted() const { return mIsEncrypted; } bool Paused() const { return mPaused; } double DefaultPlaybackRate() const { return mDefaultPlaybackRate; } void SetDefaultPlaybackRate(double aDefaultPlaybackRate, ErrorResult& aRv); double PlaybackRate() const { return mPlaybackRate; } void SetPlaybackRate(double aPlaybackRate, ErrorResult& aRv); already_AddRefed Played(); already_AddRefed Seekable() const; bool Ended(); bool Autoplay() const { return GetBoolAttr(nsGkAtoms::autoplay); } void SetAutoplay(bool aValue, ErrorResult& aRv) { SetHTMLBoolAttr(nsGkAtoms::autoplay, aValue, aRv); } bool Loop() const { return GetBoolAttr(nsGkAtoms::loop); } void SetLoop(bool aValue, ErrorResult& aRv) { SetHTMLBoolAttr(nsGkAtoms::loop, aValue, aRv); } void Play(ErrorResult& aRv); void Pause(ErrorResult& aRv); bool Controls() const { return GetBoolAttr(nsGkAtoms::controls); } void SetControls(bool aValue, ErrorResult& aRv) { SetHTMLBoolAttr(nsGkAtoms::controls, aValue, aRv); } double Volume() const { return mVolume; } void SetVolume(double aVolume, ErrorResult& aRv); bool Muted() const { return mMuted & MUTED_BY_CONTENT; } // XPCOM SetMuted() is OK bool DefaultMuted() const { return GetBoolAttr(nsGkAtoms::muted); } void SetDefaultMuted(bool aMuted, ErrorResult& aRv) { SetHTMLBoolAttr(nsGkAtoms::muted, aMuted, aRv); } bool MozMediaStatisticsShowing() const { return mStatsShowing; } void SetMozMediaStatisticsShowing(bool aShow) { mStatsShowing = aShow; } bool MozAllowCasting() const { return mAllowCasting; } void SetMozAllowCasting(bool aShow) { mAllowCasting = aShow; } bool MozIsCasting() const { return mIsCasting; } void SetMozIsCasting(bool aShow) { mIsCasting = aShow; } already_AddRefed GetMozMediaSourceObject() const; already_AddRefed GetSrcObject() const; void SetSrcObject(DOMMediaStream& aValue); void SetSrcObject(DOMMediaStream* aValue); // TODO: remove prefixed versions soon (1183495). already_AddRefed GetMozSrcObject() const; void SetMozSrcObject(DOMMediaStream& aValue); void SetMozSrcObject(DOMMediaStream* aValue); bool MozPreservesPitch() const { return mPreservesPitch; } // XPCOM MozPreservesPitch() is OK #ifdef MOZ_EME MediaKeys* GetMediaKeys() const; already_AddRefed SetMediaKeys(MediaKeys* mediaKeys, ErrorResult& aRv); mozilla::dom::EventHandlerNonNull* GetOnencrypted(); void SetOnencrypted(mozilla::dom::EventHandlerNonNull* listener); void DispatchEncrypted(const nsTArray& aInitData, const nsAString& aInitDataType) override; bool IsEventAttributeName(nsIAtom* aName) override; // Returns the principal of the "top level" document; the origin displayed // in the URL bar of the browser window. already_AddRefed GetTopLevelPrincipal(); bool ContainsRestrictedContent(); #endif // MOZ_EME bool MozAutoplayEnabled() const { return mAutoplayEnabled; } already_AddRefed MozCaptureStream(ErrorResult& aRv, MediaStreamGraph* aGraph = nullptr); already_AddRefed MozCaptureStreamUntilEnded(ErrorResult& aRv, MediaStreamGraph* aGraph = nullptr); bool MozAudioCaptured() const { return mAudioCaptured; } void MozGetMetadata(JSContext* aCx, JS::MutableHandle aResult, ErrorResult& aRv); double MozFragmentEnd(); AudioChannel MozAudioChannelType() const { return mAudioChannel; } void SetMozAudioChannelType(AudioChannel aValue, ErrorResult& aRv); AudioTrackList* AudioTracks(); VideoTrackList* VideoTracks(); TextTrackList* GetTextTracks(); already_AddRefed AddTextTrack(TextTrackKind aKind, const nsAString& aLabel, const nsAString& aLanguage); void AddTextTrack(TextTrack* aTextTrack) { GetOrCreateTextTrackManager()->AddTextTrack(aTextTrack); } void RemoveTextTrack(TextTrack* aTextTrack, bool aPendingListOnly = false) { if (mTextTrackManager) { mTextTrackManager->RemoveTextTrack(aTextTrack, aPendingListOnly); } } void AddCue(TextTrackCue& aCue) { if (mTextTrackManager) { mTextTrackManager->AddCue(aCue); } } /** * A public wrapper for FinishDecoderSetup() */ nsresult FinishDecoderSetup(MediaDecoder* aDecoder, MediaResource* aStream) { return FinishDecoderSetup(aDecoder, aStream, nullptr); } // Returns true if the media element is being destroyed. Used in // dormancy checks to prevent dormant processing for an element // that will soon be gone. bool IsBeingDestroyed(); IMPL_EVENT_HANDLER(mozinterruptbegin) IMPL_EVENT_HANDLER(mozinterruptend) // This is for testing only float ComputedVolume() const; bool ComputedMuted() const; protected: virtual ~HTMLMediaElement(); class MediaLoadListener; class MediaStreamTracksAvailableCallback; class MediaStreamTrackListener; class StreamListener; class StreamSizeListener; MediaDecoderOwner::NextFrameStatus NextFrameStatus(); void SetDecoder(MediaDecoder* aDecoder) { MOZ_ASSERT(aDecoder); // Use ShutdownDecoder() to clear. mDecoder = aDecoder; } virtual void GetItemValueText(DOMString& text) override; virtual void SetItemValueText(const nsAString& text) override; class WakeLockBoolWrapper { public: explicit WakeLockBoolWrapper(bool val = false) : mValue(val), mCanPlay(true), mOuter(nullptr) {} ~WakeLockBoolWrapper(); void SetOuter(HTMLMediaElement* outer) { mOuter = outer; } void SetCanPlay(bool aCanPlay); MOZ_IMPLICIT operator bool() const { return mValue; } WakeLockBoolWrapper& operator=(bool val); bool operator !() const { return !mValue; } static void TimerCallback(nsITimer* aTimer, void* aClosure); private: void UpdateWakeLock(); bool mValue; bool mCanPlay; HTMLMediaElement* mOuter; nsCOMPtr mTimer; }; nsresult PlayInternal(bool aCallerIsChrome); /** Use this method to change the mReadyState member, so required * events can be fired. */ void ChangeReadyState(nsMediaReadyState aState); /** * Use this method to change the mNetworkState member, so required * actions will be taken during the transition. */ void ChangeNetworkState(nsMediaNetworkState aState); /** * These two methods are called by the WakeLockBoolWrapper when the wakelock * has to be created or released. */ virtual void WakeLockCreate(); virtual void WakeLockRelease(); RefPtr mWakeLock; /** * Logs a warning message to the web console to report various failures. * aMsg is the localized message identifier, aParams is the parameters to * be substituted into the localized message, and aParamCount is the number * of parameters in aParams. */ void ReportLoadError(const char* aMsg, const char16_t** aParams = nullptr, uint32_t aParamCount = 0); /** * Changes mHasPlayedOrSeeked to aValue. If mHasPlayedOrSeeked changes * we'll force a reflow so that the video frame gets reflowed to reflect * the poster hiding or showing immediately. */ void SetPlayedOrSeeked(bool aValue); /** * Initialize the media element for playback of aStream */ void SetupSrcMediaStreamPlayback(DOMMediaStream* aStream); /** * Stop playback on mSrcStream. */ void EndSrcMediaStreamPlayback(); /** * Ensure we're playing mSrcStream if and only if we're not paused. */ enum { REMOVING_SRC_STREAM = 0x1 }; void UpdateSrcMediaStreamPlaying(uint32_t aFlags = 0); /** * If loading and playing a MediaStream, for each MediaStreamTrack in the * MediaStream, create a corresponding AudioTrack or VideoTrack during the * phase of resource fetching. */ void ConstructMediaTracks(); /** * Called by our DOMMediaStream::TrackListener when a new MediaStreamTrack has * been added to the playback stream of |mSrcStream|. */ void NotifyMediaStreamTrackAdded(const RefPtr& aTrack); /** * Called by our DOMMediaStream::TrackListener when a MediaStreamTrack in * |mSrcStream|'s playback stream has ended. */ void NotifyMediaStreamTrackRemoved(const RefPtr& aTrack); /** * Returns an nsDOMMediaStream containing the played contents of this * element. When aFinishWhenEnded is true, when this element ends playback * we will finish the stream and not play any more into it. * When aFinishWhenEnded is false, ending playback does not finish the stream. * The stream will never finish. */ already_AddRefed CaptureStreamInternal(bool aFinishWhenEnded, MediaStreamGraph* aGraph = nullptr); /** * Initialize a decoder as a clone of an existing decoder in another * element. * mLoadingSrc must already be set. */ nsresult InitializeDecoderAsClone(MediaDecoder* aOriginal); /** * Initialize a decoder to load the given channel. The decoder's stream * listener is returned via aListener. * mLoadingSrc must already be set. */ nsresult InitializeDecoderForChannel(nsIChannel *aChannel, nsIStreamListener **aListener); /** * Finish setting up the decoder after Load() has been called on it. * Called by InitializeDecoderForChannel/InitializeDecoderAsClone. */ nsresult FinishDecoderSetup(MediaDecoder* aDecoder, MediaResource* aStream, nsIStreamListener **aListener); /** * Call this after setting up mLoadingSrc and mDecoder. */ void AddMediaElementToURITable(); /** * Call this before modifying mLoadingSrc. */ void RemoveMediaElementFromURITable(); /** * Call this to find a media element with the same NodePrincipal and mLoadingSrc * set to aURI, and with a decoder on which Load() has been called. */ HTMLMediaElement* LookupMediaElementURITable(nsIURI* aURI); /** * Shutdown and clear mDecoder and maintain associated invariants. */ void ShutdownDecoder(); /** * Execute the initial steps of the load algorithm that ensure existing * loads are aborted, the element is emptied, and a new load ID is * created. */ void AbortExistingLoads(); /** * Called when all potential resources are exhausted. Changes network * state to NETWORK_NO_SOURCE, and sends error event with code * MEDIA_ERR_SRC_NOT_SUPPORTED. */ void NoSupportedMediaSourceError(); /** * Attempts to load resources from the children. This is a * substep of the resource selection algorithm. Do not call this directly, * call QueueLoadFromSourceTask() instead. */ void LoadFromSourceChildren(); /** * Asynchronously awaits a stable state, and then causes * LoadFromSourceChildren() to be called on the main threads' event loop. */ void QueueLoadFromSourceTask(); /** * Runs the media resource selection algorithm. */ void SelectResource(); /** * A wrapper function that allows us to cleanly reset flags after a call * to SelectResource() */ void SelectResourceWrapper(); /** * Asynchronously awaits a stable state, and then causes SelectResource() * to be run on the main thread's event loop. */ void QueueSelectResourceTask(); /** * When loading a new source on an existing media element, make sure to reset * everything that is accessible using the media element API. */ void ResetState(); /** * The resource-fetch algorithm step of the load algorithm. */ nsresult LoadResource(); /** * Selects the next child from which to load a resource. Called * during the resource selection algorithm. Stores the return value in * mSourceLoadCandidate before returning. */ nsIContent* GetNextSource(); /** * Changes mDelayingLoadEvent, and will call BlockOnLoad()/UnblockOnLoad() * on the owning document, so it can delay the load event firing. */ void ChangeDelayLoadStatus(bool aDelay); /** * If we suspended downloading after the first frame, unsuspend now. */ void StopSuspendingAfterFirstFrame(); /** * Called when our channel is redirected to another channel. * Updates our mChannel reference to aNewChannel. */ nsresult OnChannelRedirect(nsIChannel *aChannel, nsIChannel *aNewChannel, uint32_t aFlags); /** * Call this to reevaluate whether we should be holding a self-reference. */ void AddRemoveSelfReference(); /** * Called asynchronously to release a self-reference to this element. */ void DoRemoveSelfReference(); /** * Possible values of the 'preload' attribute. */ enum PreloadAttrValue { PRELOAD_ATTR_EMPTY, // set to "" PRELOAD_ATTR_NONE, // set to "none" PRELOAD_ATTR_METADATA, // set to "metadata" PRELOAD_ATTR_AUTO // set to "auto" }; /** * The preloading action to perform. These dictate how we react to the * preload attribute. See mPreloadAction. */ enum PreloadAction { PRELOAD_UNDEFINED = 0, // not determined - used only for initialization PRELOAD_NONE = 1, // do not preload PRELOAD_METADATA = 2, // preload only the metadata (and first frame) PRELOAD_ENOUGH = 3 // preload enough data to allow uninterrupted // playback }; /** * The guts of Load(). Load() acts as a wrapper around this which sets * mIsDoingExplicitLoad to true so that when script calls 'load()' * preload-none will be automatically upgraded to preload-metadata. */ void DoLoad(); /** * Suspends the load of mLoadingSrc, so that it can be resumed later * by ResumeLoad(). This is called when we have a media with a 'preload' * attribute value of 'none', during the resource selection algorithm. */ void SuspendLoad(); /** * Resumes a previously suspended load (suspended by SuspendLoad(uri)). * Will continue running the resource selection algorithm. * Sets mPreloadAction to aAction. */ void ResumeLoad(PreloadAction aAction); /** * Handle a change to the preload attribute. Should be called whenever the * value (or presence) of the preload attribute changes. The change in * attribute value may cause a change in the mPreloadAction of this * element. If there is a change then this method will initiate any * behaviour that is necessary to implement the action. */ void UpdatePreloadAction(); /** * Fire progress events if needed according to the time and byte constraints * outlined in the specification. aHaveNewProgress is true if progress has * just been detected. Otherwise the method is called as a result of the * progress timer. */ void CheckProgress(bool aHaveNewProgress); static void ProgressTimerCallback(nsITimer* aTimer, void* aClosure); /** * Start timer to update download progress. */ void StartProgressTimer(); /** * Start sending progress and/or stalled events. */ void StartProgress(); /** * Stop progress information timer and events. */ void StopProgress(); /** * Dispatches an error event to a child source element. */ void DispatchAsyncSourceError(nsIContent* aSourceElement); /** * Resets the media element for an error condition as per aErrorCode. * aErrorCode must be one of nsIDOMHTMLMediaError codes. */ void Error(uint16_t aErrorCode); /** * Returns the URL spec of the currentSrc. **/ void GetCurrentSpec(nsCString& aString); /** * Process any media fragment entries in the URI */ void ProcessMediaFragmentURI(); /** * Mute or unmute the audio and change the value that the |muted| map. */ void SetMutedInternal(uint32_t aMuted); /** * Update the volume of the output audio stream to match the element's * current mMuted/mVolume/mAudioChannelFaded state. */ void SetVolumeInternal(); /** * Suspend (if aPauseForInactiveDocument) or resume element playback and * resource download. If aSuspendEvents is true, event delivery is * suspended (and events queued) until the element is resumed. */ void SuspendOrResumeElement(bool aPauseElement, bool aSuspendEvents); // Get the HTMLMediaElement object if the decoder is being used from an // HTML media element, and null otherwise. virtual HTMLMediaElement* GetMediaElement() final override { return this; } // Return true if decoding should be paused virtual bool GetPaused() final override { bool isPaused = false; GetPaused(&isPaused); return isPaused; } #ifdef MOZ_EME void ReportEMETelemetry(); #endif void ReportMSETelemetry(); // Check the permissions for audiochannel. bool CheckAudioChannelPermissions(const nsAString& aType); // This method does the check for muting/nmuting the audio channel. nsresult UpdateChannelMuteState(float aVolume, bool aMuted); // Seeks to aTime seconds. aSeekType can be Exact to seek to exactly the // seek target, or PrevSyncPoint if a quicker but less precise seek is // desired, and we'll seek to the sync point (keyframe and/or start of the // next block of audio samples) preceeding seek target. void Seek(double aTime, SeekTarget::Type aSeekType, ErrorResult& aRv); // A method to check if we are playing through the AudioChannel. bool IsPlayingThroughTheAudioChannel() const; // A method to check whether we are currently playing. bool IsCurrentlyPlaying() const; // Update the audio channel playing state void UpdateAudioChannelPlayingState(); // Adds to the element's list of pending text tracks each text track // in the element's list of text tracks whose text track mode is not disabled // and whose text track readiness state is loading. void PopulatePendingTextTrackList(); // Gets a reference to the MediaElement's TextTrackManager. If the // MediaElement doesn't yet have one then it will create it. TextTrackManager* GetOrCreateTextTrackManager(); // Recomputes ready state and fires events as necessary based on current state. void UpdateReadyStateInternal(); // Notifies the audio channel agent when the element starts or stops playing. void NotifyAudioChannelAgent(bool aPlaying); // Creates the audio channel agent if needed. Returns true if the audio // channel agent is ready to be used. bool MaybeCreateAudioChannelAgent(); class nsAsyncEventRunner; using nsGenericHTMLElement::DispatchEvent; // For nsAsyncEventRunner. nsresult DispatchEvent(const nsAString& aName); // The current decoder. Load() has been called on this decoder. // At most one of mDecoder and mSrcStream can be non-null. RefPtr mDecoder; // State-watching manager. WatchManager mWatchManager; // A reference to the VideoFrameContainer which contains the current frame // of video to display. RefPtr mVideoFrameContainer; // Holds a reference to the DOM wrapper for the MediaStream that has been // set in the src attribute. RefPtr mSrcAttrStream; // Holds a reference to the DOM wrapper for the MediaStream that we're // actually playing. // At most one of mDecoder and mSrcStream can be non-null. RefPtr mSrcStream; // If non-negative, the time we should return for currentTime while playing // mSrcStream. double mSrcStreamPausedCurrentTime; // Holds a reference to the stream connecting this stream to the capture sink. RefPtr mCaptureStreamPort; // Holds references to the DOM wrappers for the MediaStreams that we're // writing to. struct OutputMediaStream { RefPtr mStream; bool mFinishWhenEnded; }; nsTArray mOutputStreams; // Holds a reference to the MediaStreamListener attached to mSrcStream's // playback stream. RefPtr mMediaStreamListener; // Holds a reference to the size-getting MediaStreamListener attached to // mSrcStream. RefPtr mMediaStreamSizeListener; // Holds a reference to the MediaSource, if any, referenced by the src // attribute on the media element. RefPtr mSrcMediaSource; // Holds a reference to the MediaSource supplying data for playback. This // may either match mSrcMediaSource or come from Source element children. // This is set when and only when mLoadingSrc corresponds to an object url // that resolved to a MediaSource. RefPtr mMediaSource; // Holds a reference to the first channel we open to the media resource. // Once the decoder is created, control over the channel passes to the // decoder, and we null out this reference. We must store this in case // we need to cancel the channel before control of it passes to the decoder. nsCOMPtr mChannel; // Error attribute RefPtr mError; // The current media load ID. This is incremented every time we start a // new load. Async events note the ID when they're first sent, and only fire // if the ID is unchanged when they come to fire. uint32_t mCurrentLoadID; // Points to the child source elements, used to iterate through the children // when selecting a resource to load. RefPtr mSourcePointer; // Points to the document whose load we're blocking. This is the document // we're bound to when loading starts. nsCOMPtr mLoadBlockedDoc; // Contains names of events that have been raised while in the bfcache. // These events get re-dispatched when the bfcache is exited. nsTArray mPendingEvents; // Media loading flags. See: // http://www.whatwg.org/specs/web-apps/current-work/#video) nsMediaNetworkState mNetworkState; Watchable mReadyState; enum LoadAlgorithmState { // No load algorithm instance is waiting for a source to be added to the // media in order to continue loading. NOT_WAITING, // We've run the load algorithm, and we tried all source children of the // media element, and failed to load any successfully. We're waiting for // another source element to be added to the media element, and will try // to load any such element when its added. WAITING_FOR_SOURCE }; // Denotes the waiting state of a load algorithm instance. When the load // algorithm is waiting for a source element child to be added, this is set // to WAITING_FOR_SOURCE, otherwise it's NOT_WAITING. LoadAlgorithmState mLoadWaitStatus; // Current audio volume double mVolume; // Helper function to iterate over a hash table // and convert it to a JSObject. static PLDHashOperator BuildObjectFromTags(nsCStringHashKey::KeyType aKey, nsCString aValue, void* aUserArg); nsAutoPtr mTags; // URI of the resource we're attempting to load. This stores the value we // return in the currentSrc attribute. Use GetCurrentSrc() to access the // currentSrc attribute. // This is always the original URL we're trying to load --- before // redirects etc. nsCOMPtr mLoadingSrc; // Stores the current preload action for this element. Initially set to // PRELOAD_UNDEFINED, its value is changed by calling // UpdatePreloadAction(). PreloadAction mPreloadAction; // Time that the last timeupdate event was fired. Read/Write from the // main thread only. TimeStamp mTimeUpdateTime; // Time that the last progress event was fired. Read/Write from the // main thread only. TimeStamp mProgressTime; // Time that data was last read from the media resource. Used for // computing if the download has stalled and to rate limit progress events // when data is arriving slower than PROGRESS_MS. // Read/Write from the main thread only. TimeStamp mDataTime; // Media 'currentTime' value when the last timeupdate event occurred. // Read/Write from the main thread only. double mLastCurrentTime; // Logical start time of the media resource in seconds as obtained // from any media fragments. A negative value indicates that no // fragment time has been set. Read/Write from the main thread only. double mFragmentStart; // Logical end time of the media resource in seconds as obtained // from any media fragments. A negative value indicates that no // fragment time has been set. Read/Write from the main thread only. double mFragmentEnd; // The defaultPlaybackRate attribute gives the desired speed at which the // media resource is to play, as a multiple of its intrinsic speed. double mDefaultPlaybackRate; // The playbackRate attribute gives the speed at which the media resource // plays, as a multiple of its intrinsic speed. If it is not equal to the // defaultPlaybackRate, then the implication is that the user is using a // feature such as fast forward or slow motion playback. double mPlaybackRate; // True if pitch correction is applied when playbackRate is set to a // non-intrinsic value. bool mPreservesPitch; // Reference to the source element last returned by GetNextSource(). // This is the child source element which we're trying to load from. nsCOMPtr mSourceLoadCandidate; // Range of time played. RefPtr mPlayed; // Timer used for updating progress events nsCOMPtr mProgressTimer; #ifdef MOZ_EME // Encrypted Media Extension media keys. RefPtr mMediaKeys; #endif // Stores the time at the start of the current 'played' range. double mCurrentPlayRangeStart; // If true then we have begun downloading the media content. // Set to false when completed, or not yet started. bool mBegun; // True if loadeddata has been fired. bool mLoadedDataFired; // Indicates whether current playback is a result of user action // (ie. calling of the Play method), or automatic playback due to // the 'autoplay' attribute being set. A true value indicates the // latter case. // The 'autoplay' HTML attribute indicates that the video should // start playing when loaded. The 'autoplay' attribute of the object // is a mirror of the HTML attribute. These are different from this // 'mAutoplaying' flag, which indicates whether the current playback // is a result of the autoplay attribute. bool mAutoplaying; // Indicates whether |autoplay| will actually autoplay based on the pref // media.autoplay.enabled bool mAutoplayEnabled; // Playback of the video is paused either due to calling the // 'Pause' method, or playback not yet having started. WakeLockBoolWrapper mPaused; enum MutedReasons { MUTED_BY_CONTENT = 0x01, MUTED_BY_INVALID_PLAYBACK_RATE = 0x02, MUTED_BY_AUDIO_CHANNEL = 0x04, MUTED_BY_AUDIO_TRACK = 0x08 }; uint32_t mMuted; // True if the media statistics are currently being shown by the builtin // video controls bool mStatsShowing; // The following two fields are here for the private storage of the builtin // video controls, and control 'casting' of the video to external devices // (TVs, projectors etc.) // True if casting is currently allowed bool mAllowCasting; // True if currently casting this video bool mIsCasting; // True if the sound is being captured. bool mAudioCaptured; // True if the sound is being captured by the window. bool mAudioCapturedByWindow; // If TRUE then the media element was actively playing before the currently // in progress seeking. If FALSE then the media element is either not seeking // or was not actively playing before the current seek. Used to decide whether // to raise the 'waiting' event as per 4.7.1.8 in HTML 5 specification. bool mPlayingBeforeSeek; // if TRUE then the seek started while content was in active playing state // if FALSE then the seek started while the content was not playing. bool mPlayingThroughTheAudioChannelBeforeSeek; // True iff this element is paused because the document is inactive or has // been suspended by the audio channel service. bool mPausedForInactiveDocumentOrChannel; // True iff event delivery is suspended (mPausedForInactiveDocumentOrChannel must also be true). bool mEventDeliveryPaused; // True if we've reported a "waiting" event since the last // readyState change to HAVE_CURRENT_DATA. bool mWaitingFired; // True if we're running the "load()" method. bool mIsRunningLoadMethod; // True if we're running or waiting to run queued tasks due to an explicit // call to "load()". bool mIsDoingExplicitLoad; // True if we're loading the resource from the child source elements. bool mIsLoadingFromSourceChildren; // True if we're delaying the "load" event. They are delayed until either // an error occurs, or the first frame is loaded. bool mDelayingLoadEvent; // True when we've got a task queued to call SelectResource(), // or while we're running SelectResource(). bool mIsRunningSelectResource; // True when we already have select resource call queued bool mHaveQueuedSelectResource; // True if we suspended the decoder because we were paused, // preloading metadata is enabled, autoplay was not enabled, and we loaded // the first frame. bool mSuspendedAfterFirstFrame; // True if we are allowed to suspend the decoder because we were paused, // preloading metdata was enabled, autoplay was not enabled, and we loaded // the first frame. bool mAllowSuspendAfterFirstFrame; // True if we've played or completed a seek. We use this to determine // when the poster frame should be shown. bool mHasPlayedOrSeeked; // True if we've added a reference to ourselves to keep the element // alive while no-one is referencing it but the element may still fire // events of its own accord. bool mHasSelfReference; // True if we've received a notification that the engine is shutting // down. bool mShuttingDown; // True if we've suspended a load in the resource selection algorithm // due to loading a preload:none media. When true, the resource we'll // load when the user initiates either playback or an explicit load is // stored in mPreloadURI. bool mSuspendedForPreloadNone; // True if we've connected mSrcStream to the media element output. bool mSrcStreamIsPlaying; // True if a same-origin check has been done for the media element and resource. bool mMediaSecurityVerified; // The CORS mode when loading the media element CORSMode mCORSMode; // Info about the played media. MediaInfo mMediaInfo; // True if the media has encryption information. bool mIsEncrypted; #ifdef MOZ_EME // Init Data that needs to be sent in 'encrypted' events in MetadataLoaded(). EncryptionInfo mPendingEncryptedInitData; #endif // MOZ_EME // True if the media's channel's download has been suspended. Watchable mDownloadSuspendedByCache; // Audio Channel. AudioChannel mAudioChannel; // The audio channel volume float mAudioChannelVolume; // Is this media element playing? bool mPlayingThroughTheAudioChannel; // Disable the video playback by track selection. This flag might not be // enough if we ever expand the ability of supporting multi-tracks video // playback. bool mDisableVideo; // True if we blocked either a play() call or autoplay because the // media's owner doc was not visible. Only enforced when the pref // media.block-play-until-visible=true. bool mPlayBlockedBecauseHidden; // An agent used to join audio channel service. nsCOMPtr mAudioChannelAgent; RefPtr mTextTrackManager; RefPtr mAudioTrackList; RefPtr mVideoTrackList; RefPtr mMediaStreamTrackListener; enum ElementInTreeState { // The MediaElement is not in the DOM tree now. ELEMENT_NOT_INTREE, // The MediaElement is in the DOM tree now. ELEMENT_INTREE, // The MediaElement is not in the DOM tree now but had been binded to the // tree before. ELEMENT_NOT_INTREE_HAD_INTREE }; ElementInTreeState mElementInTreeState; public: // Helper class to measure times for MSE telemetry stats class TimeDurationAccumulator { public: TimeDurationAccumulator() : mCount(0) { } void Start() { if (IsStarted()) { return; } mStartTime = TimeStamp::Now(); } void Pause() { if (!IsStarted()) { return; } mSum += (TimeStamp::Now() - mStartTime); mCount++; mStartTime = TimeStamp(); } bool IsStarted() const { return !mStartTime.IsNull(); } double Total() const { return mSum.ToSeconds(); } uint32_t Count() const { return mCount; } private: TimeStamp mStartTime; TimeDuration mSum; uint32_t mCount; }; private: // Total time an MSE video has spent playing TimeDurationAccumulator mPlayTime; // Time spent between video load and video playback. TimeDurationAccumulator mJoinLatency; // Indicates if user has interacted with the element. // Used to block autoplay when disabled. bool mHasUserInteraction; // True if the first frame has been successfully loaded. bool mFirstFrameLoaded; // Media elements also have a default playback start position, which must // initially be set to zero seconds. This time is used to allow the element to // be seeked even before the media is loaded. double mDefaultPlaybackStartPosition; }; } // namespace dom } // namespace mozilla #endif // mozilla_dom_HTMLMediaElement_h