Elements for accessing data from media input devices, such as cameras and microphones, and visualizing that data for users.
See the full explainer for detailed usage.
See: Documentation, Demo.
The following emerging platform APIs are used by this collection of elements:
Some additional browser support is enabled by WebRTC polyfill and MediaStream ImageCapture API polyfill. The following table documents browser support for the elements in this collection with these polyfills in use
- β Stable native implementation
- π§ Partial fidelity with polyfill
- π« Not supported at all
| Element | Chrome | Safari 11 | Firefox | Edge | IE 11 |
|---|---|---|---|---|---|
app-media-video |
β | β | β | β | β |
app-media-audio |
β | β | β | β | π« |
app-media-waveform |
β | β | β | β | π« |
app-media-devices |
β | β | β | β | π« |
app-media-stream |
β | β | β | β | π« |
app-media-recorder |
β | π« | β | π« | π« |
app-media-image-capture |
β | π§ | π§ | π§ | π« |
Element:
npm install --save @polymer/app-media
Polyfills:
npm install --save webrtc-adapter
npm install --save image-capture
<html>
<head>
<script type="module">
import '@polymer/app-media/app-media-devices.js';
</script>
</head>
<body>
<app-media-devices
kind="audioinput"
devices="{{microphones}}">
</app-media-devices>
</body>
</html><html>
<head>
<script type="module">
import '@polymer/polymer/lib/elements/dom-bind.js';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
</script>
</head>
<body>
<dom-bind>
<template>
<app-media-devices
kind="audioinput"
devices="{{microphone}}">
</app-media-devices>
<app-media-stream
audio-device="[[microphone]]"
stream="{{microphoneStream}}">
</app-media-stream>
</template>
</dom-bind>
</body>
</html><html>
<head>
<script type="module">
import '@polymer/polymer/lib/elements/dom-bind.js';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-video.js';
</script>
</head>
<body>
<dom-bind>
<template>
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
stream="{{cameraStream}}">
</app-media-stream>
<app-media-video
source="[[cameraStream]]"
autoplay>
</app-media-video>
</template>
</dom-bind>
</body>
</html><html>
<head>
<script type="module">
import '@polymer/polymer/lib/elements/dom-bind.js';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-recorder.js';
</script>
</head>
<body>
<dom-bind>
<template>
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-devices
kind="audioinput"
devices="{{microphone}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
audio-device="[[microphone]]"
stream="{{cameraAndMicrophoneStream}}">
</app-media-stream>
<app-media-recorder
id="recorder"
stream="[[cameraAndMicrophoneStream]]"
data="{{recordedVideo}}"
duration="3000">
</app-media-recorder>
</template>
</dom-bind>
<script>
function createRecording() {
recorder.start();
}
</script>
</body>
</html><html>
<head>
<script type="module">
import '@polymer/polymer/lib/elements/dom-bind.js';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-image-capture.js';
</script>
</head>
<body>
<dom-bind>
<template>
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
stream="{{videoStream}}">
</app-media-stream>
<app-media-image-capture
id="imageCapture"
stream="[[videoStream]]"
focus-mode="single-shot"
red-eye-reduction
last-photo="{{photo}}">
</app-media-image-capture>
</template>
</dom-bind>
<script>
function takePhoto() {
imageCapture.takePhoto();
}
</script>
</body>
</html><html>
<head>
<script type="module">
import '@polymer/polymer/lib/elements/dom-bind.js';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-audio.js';
</script>
</head>
<body>
<dom-bind>
<template>
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
stream="{{videoStream}}">
</app-media-stream>
<app-media-audio
stream="[[microphoneStream]]"
analyser="{{microphoneAnalyzer}}">
</app-media-audio>
</template>
</dom-bind>
</body>
</html><html>
<head>
<script type="module">
import '@polymer/polymer/lib/elements/dom-bind.js';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-audio.js';
import '@polymer/app-media/app-media-waveform.js';
</script>
</head>
<body>
<dom-bind>
<template>
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
stream="{{videoStream}}">
</app-media-stream>
<app-media-audio
stream="[[microphoneStream]]"
analyser="{{microphoneAnalyzer}}">
</app-media-audio>
<app-media-waveform analyser="[[microphoneAnalyzer]]">
</app-media-waveform>
</template>
</dom-bind>
</body>
</html>import {PolymerElement, html} from '@polymer/polymer';
import '@polymer/app-media/app-media-devices.js';
class SampleElement extends PolymerElement {
static get template() {
return html`
<app-media-devices
kind="audioinput"
devices="{{microphones}}">
</app-media-devices>
`;
}
}
customElements.define('sample-element', SampleElement);import {PolymerElement, html} from '@polymer/polymer';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
class SampleElement extends PolymerElement {
static get template() {
return html`
<app-media-devices
kind="audioinput"
devices="{{microphone}}">
</app-media-devices>
<app-media-stream
audio-device="[[microphone]]"
stream="{{microphoneStream}}">
</app-media-stream>
`;
}
}
customElements.define('sample-element', SampleElement);import {PolymerElement, html} from '@polymer/polymer';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-video.js';
class SampleElement extends PolymerElement {
static get template() {
return html`
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
stream="{{cameraStream}}">
</app-media-stream>
<app-media-video
source="[[cameraStream]]"
autoplay>
</app-media-video>
`;
}
}
customElements.define('sample-element', SampleElement);import {PolymerElement, html} from '@polymer/polymer';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-recorder.js';
class SampleElement extends PolymerElement {
static get template() {
return html`
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-devices
kind="audioinput"
devices="{{microphone}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
audio-device="[[microphone]]"
stream="{{cameraAndMicrophoneStream}}">
</app-media-stream>
<app-media-recorder
id="recorder"
stream="[[cameraAndMicrophoneStream]]"
data="{{recordedVideo}}"
duration="3000">
</app-media-recorder>
`;
}
createRecording() {
this.$.recorder.start();
}
}
customElements.define('sample-element', SampleElement);import {PolymerElement, html} from '@polymer/polymer';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-image-capture.js';
class SampleElement extends PolymerElement {
static get template() {
return html`
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
stream="{{videoStream}}">
</app-media-stream>
<app-media-image-capture
id="imageCapture"
stream="[[videoStream]]"
focus-mode="single-shot"
red-eye-reduction
last-photo="{{photo}}">
</app-media-image-capture>
`;
}
takePhoto() {
this.$.imageCapture.takePhoto();
}
}
customElements.define('sample-element', SampleElement);import {PolymerElement, html} from '@polymer/polymer';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-audio.js';
class SampleElement extends PolymerElement {
static get template() {
return html`
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
stream="{{videoStream}}">
</app-media-stream>
<app-media-audio
stream="[[microphoneStream]]"
analyser="{{microphoneAnalyzer}}">
</app-media-audio>
`;
}
}
customElements.define('sample-element', SampleElement);import {PolymerElement, html} from '@polymer/polymer';
import '@polymer/app-media/app-media-devices.js';
import '@polymer/app-media/app-media-stream.js';
import '@polymer/app-media/app-media-audio.js';
import '@polymer/app-media/app-media-waveform.js';
class SampleElement extends PolymerElement {
static get template() {
return html`
<app-media-devices
kind="videoinput"
devices="{{camera}}">
</app-media-devices>
<app-media-stream
video-device="[[camera]]"
stream="{{videoStream}}">
</app-media-stream>
<app-media-audio
stream="[[microphoneStream]]"
analyser="{{microphoneAnalyzer}}">
</app-media-audio>
<app-media-waveform analyser="[[microphoneAnalyzer]]">
</app-media-waveform>
`;
}
}
customElements.define('sample-element', SampleElement);If you want to send a PR to this element, here are the instructions for running the tests and demo locally:
git clone https://github.com/PolymerElements/app-media
cd app-media
npm install
npm install -g polymer-clipolymer serve --npm
open http://127.0.0.1:<port>/demo/polymer test --npm
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent