Skip to main content

mediadevices

Enumerate media devices and request camera/microphone access via the MediaDevices API.

Import: @rtorcato/browser-common/mediadevices

📖 MDN: MediaDevices · 📊 caniuse: stream

getUserMedia needs a secure context (HTTPS/localhost) and prompts for permission.

Example

import {
  isMediaDevicesAvailable,
  getMediaDevices,
  getUserMedia,
  stopMediaStream,
} from '@rtorcato/browser-common/mediadevices'

if (isMediaDevicesAvailable()) {
  const devices = await getMediaDevices()
  const cams = devices.filter((d) => d.kind === 'videoinput')

  const stream = await getUserMedia({ video: true, audio: true })
  // ... use stream
  stopMediaStream(stream)
}

Exports

isMediaDevicesAvailable() — feature check
getMediaDevices() — lists available input/output devices
getUserMedia(constraints) — requests camera/microphone access, returns a MediaStream
stopMediaStream(stream) — stops all tracks in a MediaStream
getMediaPermissionStatus(name) — checks 'camera' or 'microphone' permission status

See the API reference for full signatures.

Example
Exports