/* -*- 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 MediaTrackList; /** * This is for the media resource to notify its audio track and video track, * when a media-resource-specific track has ended, or whether it has enabled or * not. All notification methods are called from the main thread. */ class MediaTrackListListener { public: friend class mozilla::DOMMediaStream; explicit MediaTrackListListener(MediaTrackList* aMediaTrackList) : mMediaTrackList(aMediaTrackList) {}; ~MediaTrackListListener() { mMediaTrackList = nullptr; }; // Notify mMediaTrackList that a track has created by the media resource, // and this corresponding MediaTrack object should be added into // mMediaTrackList, and fires a addtrack event. void NotifyMediaTrackCreated(MediaTrack* aTrack); // Notify mMediaTrackList that a track has ended by the media resource, // and this corresponding MediaTrack object should be removed from // mMediaTrackList, and fires a removetrack event. void NotifyMediaTrackEnded(const nsAString& aId); protected: // A weak reference to a MediaTrackList object, its lifetime managed by its // owner. MediaTrackList* mMediaTrackList; }; /** * 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(nsPIDOMWindow* 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); void RemoveTrack(const nsRefPtr& aTrack); void RemoveTracks(); static already_AddRefed CreateAudioTrack(const nsAString& aId, const nsAString& aKind, const nsAString& aLabel, const nsAString& aLanguage, bool aEnabled); static already_AddRefed CreateVideoTrack(const nsAString& aId, const nsAString& aKind, const nsAString& aLabel, const nsAString& aLanguage); virtual void EmptyTracks(); void CreateAndDispatchChangeEvent(); // WebIDL MediaTrack* IndexedGetter(uint32_t aIndex, bool& aFound); MediaTrack* GetTrackById(const nsAString& aId); uint32_t Length() const { return mTracks.Length(); } IMPL_EVENT_HANDLER(change) IMPL_EVENT_HANDLER(addtrack) IMPL_EVENT_HANDLER(removetrack) friend class MediaTrackListListener; 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; nsRefPtr mMediaElement; }; } // namespace dom } // namespace mozilla #endif // mozilla_dom_MediaTrackList_h