mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-30 21:55:31 +00:00
f40aaeaffc
MozReview-Commit-ID: 80AFMafXoeB --HG-- extra : rebase_source : 8b51b6c9fe4b83b4639c7ae081854307c4308391 extra : source : 7ca33be035c12485e0d6529c529b0cda914fd405
161 lines
6.0 KiB
C++
161 lines
6.0 KiB
C++
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* vim:set ts=2 sw=2 sts=2 et cindent: */
|
|
/* 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 MediaDecoderOwner_h_
|
|
#define MediaDecoderOwner_h_
|
|
#include "AbstractMediaDecoder.h"
|
|
#include "nsAutoPtr.h"
|
|
|
|
namespace mozilla {
|
|
|
|
class AbstractThread;
|
|
class VideoFrameContainer;
|
|
class MediaResult;
|
|
|
|
namespace dom {
|
|
class HTMLMediaElement;
|
|
} // namespace dom
|
|
|
|
class MediaDecoderOwner
|
|
{
|
|
public:
|
|
// Called by the media decoder to indicate that the download is progressing.
|
|
virtual void DownloadProgressed() = 0;
|
|
|
|
// Dispatch an asynchronous event to the decoder owner
|
|
virtual nsresult DispatchAsyncEvent(const nsAString& aName) = 0;
|
|
|
|
// Triggers a recomputation of readyState.
|
|
virtual void UpdateReadyState() = 0;
|
|
|
|
/**
|
|
* 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) = 0;
|
|
|
|
// Get the HTMLMediaElement object if the decoder is being used from an
|
|
// HTML media element, and null otherwise.
|
|
virtual dom::HTMLMediaElement* GetMediaElement()
|
|
{
|
|
return nullptr;
|
|
}
|
|
|
|
// Return an abstract thread on which to run main thread runnables.
|
|
virtual AbstractThread* AbstractMainThread() const = 0;
|
|
|
|
// Return true if decoding should be paused
|
|
virtual bool GetPaused() = 0;
|
|
|
|
// Called by the video decoder object, on the main thread,
|
|
// when it has read the metadata containing video dimensions,
|
|
// etc.
|
|
// Must take ownership of MetadataTags aTags argument.
|
|
virtual void MetadataLoaded(const MediaInfo* aInfo,
|
|
nsAutoPtr<const MetadataTags> aTags) = 0;
|
|
|
|
// Called by the decoder object, on the main thread,
|
|
// when it has read the first frame of the video or audio.
|
|
virtual void FirstFrameLoaded() = 0;
|
|
|
|
// Called by the decoder object, on the main thread,
|
|
// when the resource has a network error during loading.
|
|
// The decoder owner should call Shutdown() on the decoder and drop the
|
|
// reference to the decoder to prevent further calls into the decoder.
|
|
virtual void NetworkError() = 0;
|
|
|
|
// Called by the decoder object, on the main thread, when the
|
|
// resource has a decode error during metadata loading or decoding.
|
|
// The decoder owner should call Shutdown() on the decoder and drop the
|
|
// reference to the decoder to prevent further calls into the decoder.
|
|
virtual void DecodeError(const MediaResult& aError) = 0;
|
|
|
|
// Return true if media element error attribute is not null.
|
|
virtual bool HasError() const = 0;
|
|
|
|
// Called by the video decoder object, on the main thread, when the
|
|
// resource load has been cancelled.
|
|
virtual void LoadAborted() = 0;
|
|
|
|
// Called by the video decoder object, on the main thread,
|
|
// when the video playback has ended.
|
|
virtual void PlaybackEnded() = 0;
|
|
|
|
// Called by the video decoder object, on the main thread,
|
|
// when the resource has started seeking.
|
|
virtual void SeekStarted() = 0;
|
|
|
|
// Called by the video decoder object, on the main thread,
|
|
// when the resource has completed seeking.
|
|
virtual void SeekCompleted() = 0;
|
|
|
|
// 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() = 0;
|
|
|
|
// 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) = 0;
|
|
|
|
// Called by the media decoder to indicate whether the media cache has
|
|
// suspended the channel.
|
|
virtual void NotifySuspendedByCache(bool aIsSuspended) = 0;
|
|
|
|
// called to notify that the principal of the decoder's media resource has changed.
|
|
virtual void NotifyDecoderPrincipalChanged() = 0;
|
|
|
|
// The status of the next frame which might be available from the decoder
|
|
enum NextFrameStatus {
|
|
// The next frame of audio/video is available
|
|
NEXT_FRAME_AVAILABLE,
|
|
// The next frame of audio/video is unavailable because the decoder
|
|
// is paused while it buffers up data
|
|
NEXT_FRAME_UNAVAILABLE_BUFFERING,
|
|
// The next frame of audio/video is unavailable for the decoder is seeking.
|
|
NEXT_FRAME_UNAVAILABLE_SEEKING,
|
|
// The next frame of audio/video is unavailable for some other reasons
|
|
NEXT_FRAME_UNAVAILABLE,
|
|
// Sentinel value
|
|
NEXT_FRAME_UNINITIALIZED
|
|
};
|
|
|
|
// Check if the decoder owner is active.
|
|
virtual bool IsActive() const = 0;
|
|
|
|
// Check if the decoder owner is hidden.
|
|
virtual bool IsHidden() const = 0;
|
|
|
|
// Called by the media decoder and the video frame to get the
|
|
// ImageContainer containing the video data.
|
|
virtual VideoFrameContainer* GetVideoFrameContainer() = 0;
|
|
|
|
// Called by media decoder when the audible state changed
|
|
virtual void SetAudibleState(bool aAudible) = 0;
|
|
|
|
// Notified by the decoder that XPCOM shutdown has begun.
|
|
// The decoder owner should call Shutdown() on the decoder and drop the
|
|
// reference to the decoder to prevent further calls into the decoder.
|
|
virtual void NotifyXPCOMShutdown() = 0;
|
|
|
|
// Dispatches a "encrypted" event to the HTMLMediaElement, with the
|
|
// provided init data. Actual dispatch may be delayed until HAVE_METADATA.
|
|
// Main thread only.
|
|
virtual void DispatchEncrypted(const nsTArray<uint8_t>& aInitData,
|
|
const nsAString& aInitDataType) = 0;
|
|
};
|
|
|
|
} // namespace mozilla
|
|
|
|
#endif
|
|
|