From 5f8de423f190bbb79a62f804151bc24824fa32d8 Mon Sep 17 00:00:00 2001 From: "Matt A. Tobin" Date: Fri, 2 Feb 2018 04:16:08 -0500 Subject: Add m-esr52 at 52.6.0 --- dom/media/MediaTrackList.h | 116 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100644 dom/media/MediaTrackList.h (limited to 'dom/media/MediaTrackList.h') diff --git a/dom/media/MediaTrackList.h b/dom/media/MediaTrackList.h new file mode 100644 index 000000000..a78f6c1fe --- /dev/null +++ b/dom/media/MediaTrackList.h @@ -0,0 +1,116 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* vim:set ts=2 sw=2 et tw=78: */ +/* 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_MediaTrackList_h +#define mozilla_dom_MediaTrackList_h + +#include "mozilla/DOMEventTargetHelper.h" + +namespace mozilla { +class DOMMediaStream; + +namespace dom { + +class HTMLMediaElement; +class MediaTrack; +class AudioTrackList; +class VideoTrackList; +class AudioTrack; +class VideoTrack; +class VideoStreamTrack; + +/** + * Base class of AudioTrackList and VideoTrackList. The AudioTrackList and + * VideoTrackList objects represent a dynamic list of zero or more audio and + * video tracks respectively. + * + * When a media element is to forget its media-resource-specific tracks, its + * audio track list and video track list will be emptied. + */ +class MediaTrackList : public DOMEventTargetHelper +{ +public: + MediaTrackList(nsPIDOMWindowInner* aOwnerWindow, HTMLMediaElement* aMediaElement); + + NS_DECL_ISUPPORTS_INHERITED + NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(MediaTrackList, DOMEventTargetHelper) + + using DOMEventTargetHelper::DispatchTrustedEvent; + + // The return value is non-null, assert an error if aIndex is out of bound + // for array mTracks. + MediaTrack* operator[](uint32_t aIndex); + + void AddTrack(MediaTrack* aTrack); + + // In remove track case, the VideoTrackList::mSelectedIndex should be updated + // due to mTracks changed. No need to take care this in add track case. + virtual void RemoveTrack(const RefPtr& aTrack); + + void RemoveTracks(); + + static already_AddRefed + CreateAudioTrack(const nsAString& aId, + const nsAString& aKind, + const nsAString& aLabel, + const nsAString& aLanguage, + bool aEnabled); + + // For the case of src of HTMLMediaElement is non-MediaStream, leave the + // aVideoTrack as default(nullptr). + static already_AddRefed + CreateVideoTrack(const nsAString& aId, + const nsAString& aKind, + const nsAString& aLabel, + const nsAString& aLanguage, + VideoStreamTrack* aVideoTrack = nullptr); + + virtual void EmptyTracks(); + + void CreateAndDispatchChangeEvent(); + + // WebIDL + MediaTrack* IndexedGetter(uint32_t aIndex, bool& aFound); + + MediaTrack* GetTrackById(const nsAString& aId); + + bool IsEmpty() const + { + return mTracks.IsEmpty(); + } + + uint32_t Length() const + { + return mTracks.Length(); + } + + IMPL_EVENT_HANDLER(change) + IMPL_EVENT_HANDLER(addtrack) + IMPL_EVENT_HANDLER(removetrack) + + friend class AudioTrack; + friend class VideoTrack; + +protected: + virtual ~MediaTrackList(); + + void CreateAndDispatchTrackEventRunner(MediaTrack* aTrack, + const nsAString& aEventName); + + virtual AudioTrackList* AsAudioTrackList() { return nullptr; } + + virtual VideoTrackList* AsVideoTrackList() { return nullptr; } + + HTMLMediaElement* GetMediaElement() { return mMediaElement; } + + nsTArray> mTracks; + RefPtr mMediaElement; +}; + +} // namespace dom +} // namespace mozilla + +#endif // mozilla_dom_MediaTrackList_h -- cgit v1.2.3