summaryrefslogtreecommitdiffstats
path: root/dom/media/MediaTrackList.h
diff options
context:
space:
mode:
Diffstat (limited to 'dom/media/MediaTrackList.h')
-rw-r--r--dom/media/MediaTrackList.h116
1 files changed, 116 insertions, 0 deletions
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<MediaTrack>& aTrack);
+
+ void RemoveTracks();
+
+ static already_AddRefed<AudioTrack>
+ 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<VideoTrack>
+ 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<RefPtr<MediaTrack>> mTracks;
+ RefPtr<HTMLMediaElement> mMediaElement;
+};
+
+} // namespace dom
+} // namespace mozilla
+
+#endif // mozilla_dom_MediaTrackList_h