blob: 7697bdedba0aa77df26dcc128eb3faed3286dc49 [file] [log] [blame]
/*
* Copyright (C) 2011 Google Inc. All rights reserved.
* Copyright (C) 2011 Ericsson AB. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#include "third_party/blink/renderer/modules/mediastream/media_stream_track.h"
#include <memory>
#include "third_party/blink/public/platform/web_media_stream_track.h"
#include "third_party/blink/renderer/bindings/core/v8/script_promise_resolver.h"
#include "third_party/blink/renderer/core/dom/document.h"
#include "third_party/blink/renderer/core/dom/dom_exception.h"
#include "third_party/blink/renderer/core/dom/events/event.h"
#include "third_party/blink/renderer/core/execution_context/execution_context.h"
#include "third_party/blink/renderer/core/frame/deprecation.h"
#include "third_party/blink/renderer/core/origin_trials/origin_trials.h"
#include "third_party/blink/renderer/modules/imagecapture/image_capture.h"
#include "third_party/blink/renderer/modules/mediastream/apply_constraints_request.h"
#include "third_party/blink/renderer/modules/mediastream/media_constraints_impl.h"
#include "third_party/blink/renderer/modules/mediastream/media_stream.h"
#include "third_party/blink/renderer/modules/mediastream/media_track_capabilities.h"
#include "third_party/blink/renderer/modules/mediastream/media_track_constraints.h"
#include "third_party/blink/renderer/modules/mediastream/media_track_settings.h"
#include "third_party/blink/renderer/modules/mediastream/overconstrained_error.h"
#include "third_party/blink/renderer/modules/mediastream/user_media_controller.h"
#include "third_party/blink/renderer/platform/mediastream/media_stream_center.h"
#include "third_party/blink/renderer/platform/mediastream/media_stream_component.h"
#include "third_party/blink/renderer/platform/wtf/assertions.h"
#include "third_party/blink/renderer/platform/wtf/vector.h"
namespace blink {
namespace {
static const char kContentHintStringNone[] = "";
static const char kContentHintStringAudioSpeech[] = "speech";
static const char kContentHintStringAudioMusic[] = "music";
static const char kContentHintStringVideoMotion[] = "motion";
static const char kContentHintStringVideoDetail[] = "detail";
static const char kContentHintStringVideoText[] = "text";
// The set of constrainable properties for image capture is available at
// https://w3c.github.io/mediacapture-image/#constrainable-properties
// TODO(guidou): Integrate image-capture constraints processing with the
// spec-compliant main implementation and remove these support functions.
// http://crbug.com/708723
bool ConstraintSetHasImageCapture(
const MediaTrackConstraintSet& constraint_set) {
return constraint_set.hasWhiteBalanceMode() ||
constraint_set.hasExposureMode() || constraint_set.hasFocusMode() ||
constraint_set.hasPointsOfInterest() ||
constraint_set.hasExposureCompensation() ||
constraint_set.hasColorTemperature() || constraint_set.hasIso() ||
constraint_set.hasBrightness() || constraint_set.hasContrast() ||
constraint_set.hasSaturation() || constraint_set.hasSharpness() ||
constraint_set.hasZoom() || constraint_set.hasTorch();
}
bool ConstraintSetHasNonImageCapture(
const MediaTrackConstraintSet& constraint_set) {
return constraint_set.hasAspectRatio() || constraint_set.hasChannelCount() ||
constraint_set.hasDepthFar() || constraint_set.hasDepthNear() ||
constraint_set.hasDeviceId() || constraint_set.hasEchoCancellation() ||
constraint_set.hasFacingMode() || constraint_set.hasFocalLengthX() ||
constraint_set.hasFocalLengthY() || constraint_set.hasFrameRate() ||
constraint_set.hasGroupId() || constraint_set.hasHeight() ||
constraint_set.hasLatency() || constraint_set.hasSampleRate() ||
constraint_set.hasSampleSize() || constraint_set.hasVideoKind() ||
constraint_set.hasVolume() || constraint_set.hasWidth();
}
bool ConstraintSetHasImageAndNonImageCapture(
const MediaTrackConstraintSet& constraint_set) {
return ConstraintSetHasImageCapture(constraint_set) &&
ConstraintSetHasNonImageCapture(constraint_set);
}
bool ConstraintSetIsNonEmpty(const MediaTrackConstraintSet& constraint_set) {
return ConstraintSetHasImageCapture(constraint_set) ||
ConstraintSetHasNonImageCapture(constraint_set);
}
template <typename ConstraintSetCondition>
bool ConstraintsSatisfyCondition(ConstraintSetCondition condition,
const MediaTrackConstraints& constraints) {
if (condition(constraints))
return true;
if (!constraints.hasAdvanced())
return false;
for (const auto& advanced_set : constraints.advanced()) {
if (condition(advanced_set))
return true;
}
return false;
}
bool ConstraintsHaveImageAndNonImageCapture(
const MediaTrackConstraints& constraints) {
return ConstraintsSatisfyCondition(ConstraintSetHasImageAndNonImageCapture,
constraints);
}
bool ConstraintsAreEmpty(const MediaTrackConstraints& constraints) {
return !ConstraintsSatisfyCondition(ConstraintSetIsNonEmpty, constraints);
}
bool ConstraintsHaveImageCapture(const MediaTrackConstraints& constraints) {
return ConstraintsSatisfyCondition(ConstraintSetHasImageCapture, constraints);
}
} // namespace
MediaStreamTrack* MediaStreamTrack::Create(ExecutionContext* context,
MediaStreamComponent* component) {
return new MediaStreamTrack(context, component);
}
MediaStreamTrack::MediaStreamTrack(ExecutionContext* context,
MediaStreamComponent* component)
: MediaStreamTrack(context,
component,
component->Source()->GetReadyState(),
false /* stopped */) {}
MediaStreamTrack::MediaStreamTrack(ExecutionContext* context,
MediaStreamComponent* component,
MediaStreamSource::ReadyState ready_state,
bool stopped)
: ContextLifecycleObserver(context),
ready_state_(ready_state),
stopped_(stopped),
component_(component) {
component_->Source()->AddObserver(this);
// If the source is already non-live at this point, the observer won't have
// been called. Update the muted state manually.
component_->SetMuted(ready_state_ == MediaStreamSource::kReadyStateMuted);
if (component_->Source() &&
component_->Source()->GetType() == MediaStreamSource::kTypeVideo) {
// ImageCapture::create() only throws if |this| track is not of video type.
NonThrowableExceptionState exception_state;
image_capture_ = ImageCapture::Create(context, this, exception_state);
}
}
MediaStreamTrack::~MediaStreamTrack() = default;
String MediaStreamTrack::kind() const {
DEFINE_STATIC_LOCAL(String, audio_kind, ("audio"));
DEFINE_STATIC_LOCAL(String, video_kind, ("video"));
switch (component_->Source()->GetType()) {
case MediaStreamSource::kTypeAudio:
return audio_kind;
case MediaStreamSource::kTypeVideo:
return video_kind;
}
NOTREACHED();
return audio_kind;
}
String MediaStreamTrack::id() const {
return component_->Id();
}
String MediaStreamTrack::label() const {
return component_->Source()->GetName();
}
bool MediaStreamTrack::enabled() const {
return component_->Enabled();
}
void MediaStreamTrack::setEnabled(bool enabled) {
if (enabled == component_->Enabled())
return;
component_->SetEnabled(enabled);
if (!Ended())
MediaStreamCenter::Instance().DidSetMediaStreamTrackEnabled(
component_.Get());
}
bool MediaStreamTrack::muted() const {
return component_->Muted();
}
String MediaStreamTrack::ContentHint() const {
WebMediaStreamTrack::ContentHintType hint = component_->ContentHint();
switch (hint) {
case WebMediaStreamTrack::ContentHintType::kNone:
return kContentHintStringNone;
case WebMediaStreamTrack::ContentHintType::kAudioSpeech:
return kContentHintStringAudioSpeech;
case WebMediaStreamTrack::ContentHintType::kAudioMusic:
return kContentHintStringAudioMusic;
case WebMediaStreamTrack::ContentHintType::kVideoMotion:
return kContentHintStringVideoMotion;
case WebMediaStreamTrack::ContentHintType::kVideoDetail:
return kContentHintStringVideoDetail;
case WebMediaStreamTrack::ContentHintType::kVideoText:
return kContentHintStringVideoText;
}
NOTREACHED();
return String();
}
void MediaStreamTrack::SetContentHint(const String& hint) {
WebMediaStreamTrack::ContentHintType translated_hint =
WebMediaStreamTrack::ContentHintType::kNone;
switch (component_->Source()->GetType()) {
case MediaStreamSource::kTypeAudio:
if (hint == kContentHintStringNone) {
translated_hint = WebMediaStreamTrack::ContentHintType::kNone;
} else if (hint == kContentHintStringAudioSpeech) {
translated_hint = WebMediaStreamTrack::ContentHintType::kAudioSpeech;
} else if (hint == kContentHintStringAudioMusic) {
translated_hint = WebMediaStreamTrack::ContentHintType::kAudioMusic;
} else {
// TODO(pbos): Log warning?
// Invalid values for audio are to be ignored (similar to invalid enum
// values).
return;
}
break;
case MediaStreamSource::kTypeVideo:
if (hint == kContentHintStringNone) {
translated_hint = WebMediaStreamTrack::ContentHintType::kNone;
} else if (hint == kContentHintStringVideoMotion) {
translated_hint = WebMediaStreamTrack::ContentHintType::kVideoMotion;
} else if (hint == kContentHintStringVideoDetail) {
translated_hint = WebMediaStreamTrack::ContentHintType::kVideoDetail;
} else if (hint == kContentHintStringVideoText) {
translated_hint = WebMediaStreamTrack::ContentHintType::kVideoText;
} else {
// TODO(pbos): Log warning?
// Invalid values for video are to be ignored (similar to invalid enum
// values).
return;
}
}
component_->SetContentHint(translated_hint);
}
String MediaStreamTrack::readyState() const {
if (Ended())
return "ended";
// Although muted is tracked as a ReadyState, only "live" and "ended" are
// visible externally.
switch (ready_state_) {
case MediaStreamSource::kReadyStateLive:
case MediaStreamSource::kReadyStateMuted:
return "live";
case MediaStreamSource::kReadyStateEnded:
return "ended";
}
NOTREACHED();
return String();
}
void MediaStreamTrack::stopTrack(ExecutionContext* execution_context) {
if (Ended())
return;
ready_state_ = MediaStreamSource::kReadyStateEnded;
Document* document = ToDocument(execution_context);
UserMediaController* user_media =
UserMediaController::From(document->GetFrame());
if (user_media)
user_media->StopTrack(Component());
PropagateTrackEnded();
}
MediaStreamTrack* MediaStreamTrack::clone(ScriptState* script_state) {
MediaStreamComponent* cloned_component = Component()->Clone();
MediaStreamTrack* cloned_track =
new MediaStreamTrack(ExecutionContext::From(script_state),
cloned_component, ready_state_, stopped_);
MediaStreamCenter::Instance().DidCloneMediaStreamTrack(Component(),
cloned_component);
return cloned_track;
}
void MediaStreamTrack::SetConstraints(const WebMediaConstraints& constraints) {
component_->SetConstraints(constraints);
}
void MediaStreamTrack::getCapabilities(MediaTrackCapabilities& capabilities) {
if (image_capture_)
capabilities = image_capture_->GetMediaTrackCapabilities();
auto platform_capabilities = component_->Source()->GetCapabilities();
capabilities.setDeviceId(platform_capabilities.device_id);
if (!platform_capabilities.group_id.IsNull())
capabilities.setGroupId(platform_capabilities.group_id);
if (component_->Source()->GetType() == MediaStreamSource::kTypeAudio) {
Vector<bool> echo_cancellation, auto_gain_control, noise_suppression;
for (bool value : platform_capabilities.echo_cancellation)
echo_cancellation.push_back(value);
capabilities.setEchoCancellation(echo_cancellation);
for (bool value : platform_capabilities.auto_gain_control)
auto_gain_control.push_back(value);
capabilities.setAutoGainControl(auto_gain_control);
for (bool value : platform_capabilities.noise_suppression)
noise_suppression.push_back(value);
capabilities.setNoiseSuppression(noise_suppression);
Vector<String> echo_cancellation_type;
for (String value : platform_capabilities.echo_cancellation_type)
echo_cancellation_type.push_back(value);
capabilities.setEchoCancellationType(echo_cancellation_type);
}
if (component_->Source()->GetType() == MediaStreamSource::kTypeVideo) {
if (platform_capabilities.width.size() == 2) {
LongRange width;
width.setMin(platform_capabilities.width[0]);
width.setMax(platform_capabilities.width[1]);
capabilities.setWidth(width);
}
if (platform_capabilities.height.size() == 2) {
LongRange height;
height.setMin(platform_capabilities.height[0]);
height.setMax(platform_capabilities.height[1]);
capabilities.setHeight(height);
}
if (platform_capabilities.aspect_ratio.size() == 2) {
DoubleRange aspect_ratio;
aspect_ratio.setMin(platform_capabilities.aspect_ratio[0]);
aspect_ratio.setMax(platform_capabilities.aspect_ratio[1]);
capabilities.setAspectRatio(aspect_ratio);
}
if (platform_capabilities.frame_rate.size() == 2) {
DoubleRange frame_rate;
frame_rate.setMin(platform_capabilities.frame_rate[0]);
frame_rate.setMax(platform_capabilities.frame_rate[1]);
capabilities.setFrameRate(frame_rate);
}
Vector<String> facing_mode;
switch (platform_capabilities.facing_mode) {
case WebMediaStreamTrack::FacingMode::kUser:
facing_mode.push_back("user");
break;
case WebMediaStreamTrack::FacingMode::kEnvironment:
facing_mode.push_back("environment");
break;
case WebMediaStreamTrack::FacingMode::kLeft:
facing_mode.push_back("left");
break;
case WebMediaStreamTrack::FacingMode::kRight:
facing_mode.push_back("right");
break;
default:
break;
}
capabilities.setFacingMode(facing_mode);
}
}
void MediaStreamTrack::getConstraints(MediaTrackConstraints& constraints) {
MediaConstraintsImpl::ConvertConstraints(component_->Constraints(),
constraints);
if (!image_capture_)
return;
HeapVector<MediaTrackConstraintSet> vector;
if (constraints.hasAdvanced())
vector = constraints.advanced();
// TODO(mcasas): consider consolidating this code in MediaContraintsImpl.
auto image_capture_constraints = image_capture_->GetMediaTrackConstraints();
// TODO(mcasas): add |torch|, https://crbug.com/700607.
if (image_capture_constraints.hasWhiteBalanceMode() ||
image_capture_constraints.hasExposureMode() ||
image_capture_constraints.hasFocusMode() ||
image_capture_constraints.hasExposureCompensation() ||
image_capture_constraints.hasColorTemperature() ||
image_capture_constraints.hasIso() ||
image_capture_constraints.hasBrightness() ||
image_capture_constraints.hasContrast() ||
image_capture_constraints.hasSaturation() ||
image_capture_constraints.hasSharpness() ||
image_capture_constraints.hasZoom()) {
// Add image capture constraints, if any, as another entry to advanced().
vector.emplace_back(image_capture_constraints);
constraints.setAdvanced(vector);
}
}
void MediaStreamTrack::getSettings(MediaTrackSettings& settings) {
WebMediaStreamTrack::Settings platform_settings;
component_->GetSettings(platform_settings);
if (platform_settings.HasFrameRate())
settings.setFrameRate(platform_settings.frame_rate);
if (platform_settings.HasWidth())
settings.setWidth(platform_settings.width);
if (platform_settings.HasHeight())
settings.setHeight(platform_settings.height);
if (platform_settings.HasAspectRatio())
settings.setAspectRatio(platform_settings.aspect_ratio);
if (RuntimeEnabledFeatures::MediaCaptureDepthVideoKindEnabled() &&
component_->Source()->GetType() == MediaStreamSource::kTypeVideo) {
if (platform_settings.HasVideoKind())
settings.setVideoKind(platform_settings.video_kind);
}
if (RuntimeEnabledFeatures::MediaCaptureDepthEnabled() &&
component_->Source()->GetType() == MediaStreamSource::kTypeVideo) {
if (platform_settings.HasDepthNear())
settings.setDepthNear(platform_settings.depth_near);
if (platform_settings.HasDepthFar())
settings.setDepthFar(platform_settings.depth_far);
if (platform_settings.HasFocalLengthX())
settings.setFocalLengthX(platform_settings.focal_length_x);
if (platform_settings.HasFocalLengthY())
settings.setFocalLengthY(platform_settings.focal_length_y);
}
settings.setDeviceId(platform_settings.device_id);
if (!platform_settings.group_id.IsNull())
settings.setGroupId(platform_settings.group_id);
if (platform_settings.HasFacingMode()) {
switch (platform_settings.facing_mode) {
case WebMediaStreamTrack::FacingMode::kUser:
settings.setFacingMode("user");
break;
case WebMediaStreamTrack::FacingMode::kEnvironment:
settings.setFacingMode("environment");
break;
case WebMediaStreamTrack::FacingMode::kLeft:
settings.setFacingMode("left");
break;
case WebMediaStreamTrack::FacingMode::kRight:
settings.setFacingMode("right");
break;
default:
// None, or unknown facing mode. Ignore.
break;
}
}
if (platform_settings.echo_cancellation)
settings.setEchoCancellation(*platform_settings.echo_cancellation);
if (platform_settings.auto_gain_control)
settings.setAutoGainControl(*platform_settings.auto_gain_control);
if (platform_settings.noise_supression)
settings.setNoiseSuppression(*platform_settings.noise_supression);
if (OriginTrials::ExperimentalHardwareEchoCancellationEnabled(
GetExecutionContext()) &&
!platform_settings.echo_cancellation_type.IsNull()) {
settings.setEchoCancellationType(platform_settings.echo_cancellation_type);
}
if (platform_settings.HasSampleRate())
settings.setSampleRate(platform_settings.sample_rate);
if (platform_settings.HasSampleSize())
settings.setSampleSize(platform_settings.sample_size);
if (platform_settings.HasChannelCount())
settings.setChannelCount(platform_settings.channel_count);
if (platform_settings.HasLatency())
settings.setLatency(platform_settings.latency);
if (platform_settings.HasVolume())
settings.setVolume(platform_settings.volume);
if (image_capture_)
image_capture_->GetMediaTrackSettings(settings);
if (platform_settings.display_surface) {
WTF::String value;
switch (platform_settings.display_surface.value()) {
case WebMediaStreamTrack::DisplayCaptureSurfaceType::kMonitor:
value = "monitor";
break;
case WebMediaStreamTrack::DisplayCaptureSurfaceType::kWindow:
value = "window";
break;
case WebMediaStreamTrack::DisplayCaptureSurfaceType::kApplication:
value = "application";
break;
case WebMediaStreamTrack::DisplayCaptureSurfaceType::kBrowser:
value = "browser";
break;
}
settings.setDisplaySurface(value);
}
if (platform_settings.logical_surface)
settings.setLogicalSurface(platform_settings.logical_surface.value());
if (platform_settings.cursor) {
WTF::String value;
switch (platform_settings.cursor.value()) {
case WebMediaStreamTrack::CursorCaptureType::kNever:
value = "never";
break;
case WebMediaStreamTrack::CursorCaptureType::kAlways:
value = "always";
break;
case WebMediaStreamTrack::CursorCaptureType::kMotion:
value = "motion";
break;
}
settings.setCursor(value);
}
}
ScriptPromise MediaStreamTrack::applyConstraints(
ScriptState* script_state,
const MediaTrackConstraints& constraints) {
ScriptPromiseResolver* resolver = ScriptPromiseResolver::Create(script_state);
ScriptPromise promise = resolver->Promise();
MediaErrorState error_state;
ExecutionContext* execution_context = ExecutionContext::From(script_state);
WebMediaConstraints web_constraints =
MediaConstraintsImpl::Create(execution_context, constraints, error_state);
if (error_state.HadException()) {
resolver->Reject(
OverconstrainedError::Create(String(), "Cannot parse constraints"));
return promise;
}
if (image_capture_) {
// TODO(guidou): Integrate image-capture constraints processing with the
// spec-compliant main implementation. http://crbug.com/708723
if (ConstraintsHaveImageAndNonImageCapture(constraints)) {
resolver->Reject(OverconstrainedError::Create(
String(),
"Mixing ImageCapture and non-ImageCapture "
"constraints is not currently supported"));
return promise;
}
if (ConstraintsAreEmpty(constraints)) {
// Do not resolve the promise. Instead, just clear the ImageCapture
// constraints and then pass the empty constraints to the general
// implementation.
image_capture_->ClearMediaTrackConstraints();
} else if (ConstraintsHaveImageCapture(constraints)) {
applyConstraintsImageCapture(resolver, constraints);
return promise;
}
}
// Resolve empty constraints here instead of relying on UserMediaController
// because the empty constraints have already been applied to image capture
// and the promise must resolve. Empty constraints do not change any setting,
// so resolving here is OK.
if (ConstraintsAreEmpty(constraints)) {
SetConstraints(web_constraints);
resolver->Resolve();
return promise;
}
Document* document = ToDocument(execution_context);
UserMediaController* user_media =
UserMediaController::From(document->GetFrame());
if (!user_media) {
resolver->Reject(OverconstrainedError::Create(
String(), "Cannot apply constraints due to unexpected error"));
return promise;
}
user_media->ApplyConstraints(
ApplyConstraintsRequest::Create(Component(), web_constraints, resolver));
return promise;
}
void MediaStreamTrack::applyConstraintsImageCapture(
ScriptPromiseResolver* resolver,
const MediaTrackConstraints& constraints) {
// |constraints| empty means "remove/clear all current constraints".
if (!constraints.hasAdvanced() || constraints.advanced().IsEmpty()) {
image_capture_->ClearMediaTrackConstraints();
resolver->Resolve();
} else {
image_capture_->SetMediaTrackConstraints(resolver, constraints.advanced());
}
}
bool MediaStreamTrack::Ended() const {
return stopped_ || (ready_state_ == MediaStreamSource::kReadyStateEnded);
}
void MediaStreamTrack::SourceChangedState() {
if (Ended())
return;
ready_state_ = component_->Source()->GetReadyState();
switch (ready_state_) {
case MediaStreamSource::kReadyStateLive:
component_->SetMuted(false);
DispatchEvent(*Event::Create(EventTypeNames::unmute));
break;
case MediaStreamSource::kReadyStateMuted:
component_->SetMuted(true);
DispatchEvent(*Event::Create(EventTypeNames::mute));
break;
case MediaStreamSource::kReadyStateEnded:
DispatchEvent(*Event::Create(EventTypeNames::ended));
PropagateTrackEnded();
break;
}
}
void MediaStreamTrack::PropagateTrackEnded() {
CHECK(!is_iterating_registered_media_streams_);
is_iterating_registered_media_streams_ = true;
for (HeapHashSet<Member<MediaStream>>::iterator iter =
registered_media_streams_.begin();
iter != registered_media_streams_.end(); ++iter)
(*iter)->TrackEnded();
is_iterating_registered_media_streams_ = false;
}
void MediaStreamTrack::ContextDestroyed(ExecutionContext*) {
stopped_ = true;
}
bool MediaStreamTrack::HasPendingActivity() const {
// If 'ended' listeners exist and the object hasn't yet reached
// that state, keep the object alive.
//
// An otherwise unreachable MediaStreamTrack object in an non-ended
// state will otherwise indirectly be transitioned to the 'ended' state
// while finalizing m_component. Which dispatches an 'ended' event,
// referring to this object as the target. If this object is then GCed
// at the same time, v8 objects will retain (wrapper) references to
// this dead MediaStreamTrack object. Bad.
//
// Hence insisting on keeping this object alive until the 'ended'
// state has been reached & handled.
return !Ended() && HasEventListeners(EventTypeNames::ended);
}
std::unique_ptr<AudioSourceProvider> MediaStreamTrack::CreateWebAudioSource() {
return MediaStreamCenter::Instance().CreateWebAudioSourceFromMediaStreamTrack(
Component());
}
void MediaStreamTrack::RegisterMediaStream(MediaStream* media_stream) {
CHECK(!is_iterating_registered_media_streams_);
CHECK(!registered_media_streams_.Contains(media_stream));
registered_media_streams_.insert(media_stream);
}
void MediaStreamTrack::UnregisterMediaStream(MediaStream* media_stream) {
CHECK(!is_iterating_registered_media_streams_);
HeapHashSet<Member<MediaStream>>::iterator iter =
registered_media_streams_.find(media_stream);
CHECK(iter != registered_media_streams_.end());
registered_media_streams_.erase(iter);
}
const AtomicString& MediaStreamTrack::InterfaceName() const {
return EventTargetNames::MediaStreamTrack;
}
ExecutionContext* MediaStreamTrack::GetExecutionContext() const {
return ContextLifecycleObserver::GetExecutionContext();
}
void MediaStreamTrack::Trace(blink::Visitor* visitor) {
visitor->Trace(registered_media_streams_);
visitor->Trace(component_);
visitor->Trace(image_capture_);
EventTargetWithInlineData::Trace(visitor);
ContextLifecycleObserver::Trace(visitor);
}
} // namespace blink