This plugin provides an implementation of the W3C Media Capture API which allows authorized web applications to access streams from the device's audio and video capturing interfaces, i.e. to use the data available from the camera and the microphone. The streams exposed by the API can be bound directly to the HTML or
phonegap plugin add phonegap-plugin-media-stream
phonegap plugin add https://github.com/phonegap/phonegap-plugin-media-stream.git
The mediaDevices object has the following methods:
The getUserMedia
method call prompts the user for permission to capture audio or video input. The method returns a promise that when resolved returns a MediaStream
object. You can constrain what type of media streams are return by passing in an option MediaStreamConstraints
object.
navigator.mediaDevices.getUserMedia({
'audio': true,
'video': {
facingMode: 'user'
}
}).then(function(mediaStream) {
// do something with the media stream
});
The getSupportedConstraints
method returns an object which describes which constraints the device supports. You can check the constraints before making a call to getUserMedia
to make sure that the functionality you want is supported.
var constraints = navigator.mediaDevices.getSupportedConstraints();
console.log(constraints);
The iOS implementation that this plugin provides does not allow you to attach the returned MediaStream
object to an audio
or video
tag. Rather you will use the MediaStream
object to get a MediaStreamTrack
to pass to the Image (see phonegap-plugin-image-capture) or Audio capture API.