bindings/mediacapture_streams library
Media Capture and Streams
Classes
- CameraDevicePermissionDescriptor
- ConstrainBooleanParameters
- ConstrainDOMStringParameters
- ConstrainDoubleRange
- ConstrainULongRange
- DevicePermissionDescriptor
- DoubleRange
- InputDeviceInfo
-
The interface of the Media Streams API gives access to the
capabilities of the input device that it represents.
objects are returned by
MediaDevices.enumerateDevices()
if the returned device is an audio or video input device. - MediaDeviceInfo
-
The interface contains information that describes a single media
input or output device.
The list of devices obtained by calling
navigator.mediaDevices.enumerateDevices()
is an array of objects, one per media device. - MediaDevices
- The interface provides access to connected media input devices like cameras and microphones, as well as screen sharing. In essence, it lets you obtain access to any hardware source of media data.
- MediaStream
-
The interface represents a stream of media content. A stream
consists of several tracks, such as video or audio tracks. Each
track is specified as an instance of MediaStreamTrack.
You can obtain a object either by using the constructor or by
calling functions such as
MediaDevices.getUserMedia()
,MediaDevices.getDisplayMedia()
, orHTMLCanvasElement.captureStream()
. Some user agents subclass this interface to provide more precise information or functionality, like in CanvasCaptureMediaStreamTrack. - MediaStreamConstraints
- MediaStreamTrack
- The interface represents a single media track within a stream; typically, these are audio or video tracks, but other track types may exist as well.
- MediaStreamTrackEvent
- The interface represents events which indicate that a MediaStream has had tracks added to or removed from the stream through calls to Media Stream API methods. These events are sent to the stream when these changes occur.
- MediaStreamTrackEventInit
- MediaTrackCapabilities
- MediaTrackConstraints
-
The dictionary is used to describe a set of capabilities and the
value or values each can take on. A constraints dictionary is
passed into
applyConstraints()
to allow a script to establish a set of exact (required) values or ranges and/or preferred values or ranges of values for the track, and the most recently-requested set of custom constraints can be retrieved by callinggetConstraints()
. - MediaTrackConstraintSet
- MediaTrackSettings
-
The dictionary is used to return the current values configured
for each of a MediaStreamTrack's settings. These values will
adhere as closely as possible to any constraints previously
described using a MediaTrackConstraints object and set using
applyConstraints()
, and will adhere to the default constraints for any properties whose constraints haven't been changed, or whose customized constraints couldn't be matched. To learn more about how constraints and settings work, see Capabilities, constraints, and settings. - MediaTrackSupportedConstraints
-
The dictionary establishes the list of constrainable properties
recognized by the user agent or browser in its implementation of
the MediaStreamTrack object. An object conforming to is
returned by
MediaDevices.getSupportedConstraints()
. Because of the way interface definitions in WebIDL work, if a constraint is requested but not supported, no error will occur. Instead, the specified constraints will be applied, with any unrecognized constraints stripped from the request.That can lead to confusing and hard to debug errors, so be sure to usegetSupportedConstraints()
to retrieve this information before attempting to establish constraints if you need to know the difference between silently ignoring a constraint and a constraint being accepted. An actual constraint set is described using an object based on the MediaTrackConstraints dictionary. To learn more about how constraints work, see Capabilities, constraints, and settings. - OverconstrainedError
- Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.Experimental: This is an experimental technologyCheck the Browser compatibility table carefully before using this in production. The interface of the Media Capture and Streams API indicates that the set of desired capabilities for the current MediaStreamTrack cannot currently be met. When this event is thrown on a MediaStreamTrack, it is muted until either the current constraints can be established or until satisfiable constraints are applied.
- ULongRange
Extensions
- PropsCameraDevicePermissionDescriptor on CameraDevicePermissionDescriptor
- PropsConstrainBooleanParameters on ConstrainBooleanParameters
- PropsConstrainDOMStringParameters on ConstrainDOMStringParameters
- PropsConstrainDoubleRange on ConstrainDoubleRange
- PropsConstrainULongRange on ConstrainULongRange
- PropsDevicePermissionDescriptor on DevicePermissionDescriptor
- PropsDoubleRange on DoubleRange
- PropsInputDeviceInfo on InputDeviceInfo
- PropsMediaDeviceInfo on MediaDeviceInfo
- PropsMediaDevices on MediaDevices
- PropsMediaStream on MediaStream
- PropsMediaStreamConstraints on MediaStreamConstraints
- PropsMediaStreamTrack on MediaStreamTrack
- PropsMediaStreamTrackEvent on MediaStreamTrackEvent
- PropsMediaStreamTrackEventInit on MediaStreamTrackEventInit
- PropsMediaTrackCapabilities on MediaTrackCapabilities
- PropsMediaTrackConstraints on MediaTrackConstraints
- PropsMediaTrackConstraintSet on MediaTrackConstraintSet
- PropsMediaTrackSettings on MediaTrackSettings
- PropsMediaTrackSupportedConstraints on MediaTrackSupportedConstraints
- PropsOverconstrainedError on OverconstrainedError
- PropsULongRange on ULongRange