MediaStreamTrack.h [plain text]
#pragma once
#if ENABLE(MEDIA_STREAM)
#include "ActiveDOMObject.h"
#include "DoubleRange.h"
#include "EventTarget.h"
#include "JSDOMPromise.h"
#include "LongRange.h"
#include "MediaStreamTrackPrivate.h"
#include "MediaTrackConstraints.h"
namespace WebCore {
class AudioSourceProvider;
struct MediaTrackConstraints;
class MediaStreamTrack final : public RefCounted<MediaStreamTrack>, public ActiveDOMObject, public EventTargetWithInlineData, private MediaStreamTrackPrivate::Observer {
public:
class Observer {
public:
virtual ~Observer() { }
virtual void trackDidEnd() = 0;
};
static Ref<MediaStreamTrack> create(ScriptExecutionContext&, Ref<MediaStreamTrackPrivate>&&);
virtual ~MediaStreamTrack();
const AtomicString& kind() const;
const String& id() const;
const String& label() const;
bool enabled() const;
void setEnabled(bool);
bool muted() const;
bool readonly() const;
bool remote() const;
enum class State { New, Live, Ended };
State readyState() const;
bool ended() const;
Ref<MediaStreamTrack> clone();
void stopProducingData();
struct TrackSettings {
std::optional<int> width;
std::optional<int> height;
std::optional<double> aspectRatio;
std::optional<double> frameRate;
String facingMode;
std::optional<double> volume;
std::optional<int> sampleRate;
std::optional<int> sampleSize;
std::optional<bool> echoCancellation;
String deviceId;
String groupId;
};
TrackSettings getSettings() const;
struct TrackCapabilities {
std::optional<LongRange> width;
std::optional<LongRange> height;
std::optional<DoubleRange> aspectRatio;
std::optional<DoubleRange> frameRate;
std::optional<Vector<String>> facingMode;
std::optional<DoubleRange> volume;
std::optional<LongRange> sampleRate;
std::optional<LongRange> sampleSize;
std::optional<Vector<bool>> echoCancellation;
String deviceId;
String groupId;
};
TrackCapabilities getCapabilities() const;
const MediaTrackConstraints& getConstraints() const { return m_constraints; }
void applyConstraints(const std::optional<MediaTrackConstraints>&, DOMPromise<void>&&);
RealtimeMediaSource& source() { return m_private->source(); }
MediaStreamTrackPrivate& privateTrack() { return m_private.get(); }
AudioSourceProvider* audioSourceProvider();
void addObserver(Observer&);
void removeObserver(Observer&);
using RefCounted::ref;
using RefCounted::deref;
private:
MediaStreamTrack(ScriptExecutionContext&, Ref<MediaStreamTrackPrivate>&&);
explicit MediaStreamTrack(MediaStreamTrack&);
void configureTrackRendering();
void stop() final;
const char* activeDOMObjectName() const final;
bool canSuspendForDocumentSuspension() const final;
void refEventTarget() final { ref(); }
void derefEventTarget() final { deref(); }
EventTargetInterface eventTargetInterface() const final { return MediaStreamTrackEventTargetInterfaceType; }
ScriptExecutionContext* scriptExecutionContext() const final { return ActiveDOMObject::scriptExecutionContext(); }
void trackEnded(MediaStreamTrackPrivate&) override;
void trackMutedChanged(MediaStreamTrackPrivate&) override;
void trackSettingsChanged(MediaStreamTrackPrivate&) override;
void trackEnabledChanged(MediaStreamTrackPrivate&) override;
WeakPtr<MediaStreamTrack> createWeakPtr() { return m_weakPtrFactory.createWeakPtr(); }
Vector<Observer*> m_observers;
Ref<MediaStreamTrackPrivate> m_private;
MediaTrackConstraints m_constraints;
std::optional<DOMPromise<void>> m_promise;
WeakPtrFactory<MediaStreamTrack> m_weakPtrFactory;
bool m_ended { false };
};
typedef Vector<RefPtr<MediaStreamTrack>> MediaStreamTrackVector;
}
#endif // ENABLE(MEDIA_STREAM)