2013-03-27 01:32:51 +00:00
|
|
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-*/
|
|
|
|
/* 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 MEDIASTREAMTRACK_H_
|
|
|
|
#define MEDIASTREAMTRACK_H_
|
|
|
|
|
2014-04-01 06:13:50 +00:00
|
|
|
#include "mozilla/DOMEventTargetHelper.h"
|
2013-03-27 01:32:51 +00:00
|
|
|
#include "nsID.h"
|
|
|
|
#include "StreamBuffer.h"
|
2015-09-20 22:45:57 +00:00
|
|
|
#include "MediaTrackConstraints.h"
|
2013-03-27 01:32:51 +00:00
|
|
|
|
|
|
|
namespace mozilla {
|
2013-09-05 20:25:17 +00:00
|
|
|
|
|
|
|
class DOMMediaStream;
|
|
|
|
|
2013-03-27 01:32:51 +00:00
|
|
|
namespace dom {
|
|
|
|
|
|
|
|
class AudioStreamTrack;
|
|
|
|
class VideoStreamTrack;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Class representing a track in a DOMMediaStream.
|
|
|
|
*/
|
2014-04-01 06:13:50 +00:00
|
|
|
class MediaStreamTrack : public DOMEventTargetHelper {
|
2013-03-27 01:32:51 +00:00
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* aTrackID is the MediaStreamGraph track ID for the track in the
|
|
|
|
* MediaStream owned by aStream.
|
|
|
|
*/
|
|
|
|
MediaStreamTrack(DOMMediaStream* aStream, TrackID aTrackID);
|
|
|
|
|
2013-05-01 11:24:16 +00:00
|
|
|
NS_DECL_ISUPPORTS_INHERITED
|
2014-04-01 06:13:50 +00:00
|
|
|
NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(MediaStreamTrack,
|
|
|
|
DOMEventTargetHelper)
|
2013-03-27 01:32:51 +00:00
|
|
|
|
2015-09-30 01:31:54 +00:00
|
|
|
DOMMediaStream* GetParentObject() const { return mOwningStream; }
|
2015-03-21 16:28:04 +00:00
|
|
|
virtual JSObject* WrapObject(JSContext* aCx, JS::Handle<JSObject*> aGivenProto) override = 0;
|
2013-03-27 01:32:51 +00:00
|
|
|
|
2015-09-30 01:31:54 +00:00
|
|
|
/**
|
|
|
|
* Returns the DOMMediaStream owning this track.
|
|
|
|
*/
|
|
|
|
DOMMediaStream* GetStream() const { return mOwningStream; }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the TrackID this stream has in its owning DOMMediaStream's Owned
|
|
|
|
* stream.
|
|
|
|
*/
|
2013-03-27 01:32:51 +00:00
|
|
|
TrackID GetTrackID() const { return mTrackID; }
|
|
|
|
virtual AudioStreamTrack* AsAudioStreamTrack() { return nullptr; }
|
|
|
|
virtual VideoStreamTrack* AsVideoStreamTrack() { return nullptr; }
|
|
|
|
|
|
|
|
// WebIDL
|
|
|
|
virtual void GetKind(nsAString& aKind) = 0;
|
2014-12-10 19:17:09 +00:00
|
|
|
void GetId(nsAString& aID) const;
|
2013-03-27 01:32:51 +00:00
|
|
|
void GetLabel(nsAString& aLabel) { aLabel.Truncate(); }
|
2013-05-30 04:44:43 +00:00
|
|
|
bool Enabled() { return mEnabled; }
|
|
|
|
void SetEnabled(bool aEnabled);
|
2014-08-27 05:03:49 +00:00
|
|
|
void Stop();
|
2015-09-20 22:45:57 +00:00
|
|
|
already_AddRefed<Promise>
|
|
|
|
ApplyConstraints(const dom::MediaTrackConstraints& aConstraints, ErrorResult &aRv);
|
2013-03-27 01:32:51 +00:00
|
|
|
|
2015-09-30 01:32:06 +00:00
|
|
|
bool Ended() const { return mEnded; }
|
2013-03-27 01:32:51 +00:00
|
|
|
// Notifications from the MediaStreamGraph
|
|
|
|
void NotifyEnded() { mEnded = true; }
|
|
|
|
|
2014-12-10 19:17:09 +00:00
|
|
|
// Webrtc allows the remote side to name tracks whatever it wants, and we
|
|
|
|
// need to surface this to content.
|
|
|
|
void AssignId(const nsAString& aID) { mID = aID; }
|
|
|
|
|
2013-03-27 01:32:51 +00:00
|
|
|
protected:
|
2014-07-08 21:23:16 +00:00
|
|
|
virtual ~MediaStreamTrack();
|
|
|
|
|
2015-09-30 01:31:54 +00:00
|
|
|
nsRefPtr<DOMMediaStream> mOwningStream;
|
2013-03-27 01:32:51 +00:00
|
|
|
TrackID mTrackID;
|
2014-12-10 19:17:09 +00:00
|
|
|
nsString mID;
|
2013-03-27 01:32:51 +00:00
|
|
|
bool mEnded;
|
2013-05-30 04:44:43 +00:00
|
|
|
bool mEnabled;
|
2013-03-27 01:32:51 +00:00
|
|
|
};
|
|
|
|
|
2015-07-13 15:25:42 +00:00
|
|
|
} // namespace dom
|
|
|
|
} // namespace mozilla
|
2013-03-27 01:32:51 +00:00
|
|
|
|
|
|
|
#endif /* MEDIASTREAMTRACK_H_ */
|