# media-device

> device management of browser

Latest version **1.4.3** (published 2026-10-09) · ISC license · 0 weekly downloads

## Install

```sh
npm install media-device
pnpm add media-device
yarn add media-device
bun add media-device
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.4.3 |
| Published | 2026-10-09 |
| First published | 2022-11-07 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 42 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | doubao |
| Maintainers | youcheng.yc |
| Keywords | devicemanager, mic, camera, screenshare, audiotrack, videotrack |

## Links

- npm: https://www.npmjs.com/package/media-device
- Repository: git@gitlab.alibaba-inc.com:AliyunVideoClient/device-manager
- npm.io page: https://npm.io/package/media-device

## Dependencies (2)

- [lodash](https://npm.io/package/lodash.md) ^4.17.20
- [@types/node](https://npm.io/package/@types/node.md) ^14.14.12

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 1.4.3 (latest) — 2026-10-09
- 1.2.1-beta.0 (beta) — 2023-09-06
- 1.4.2 — 2025-11-26
- 1.4.1 — 2025-10-21
- 1.4.0 — 2025-07-03
- 1.3.0 — 2024-03-20
- 1.3.0-beta.0 — 2024-03-20
- 1.2.0 — 2023-09-06
- 1.1.13 — 2023-06-19
- 1.1.12 — 2023-05-10
- 1.1.12-beta.1 — 2023-05-10
- 1.1.12-beta.0 — 2023-05-10
- 1.1.11 — 2023-04-21
- 1.1.10 — 2023-04-20
- 1.1.10-beta.1 — 2023-04-20
- … 10 more at https://npm.io/package/media-device/versions

## README

## Browser Device Manager

This is a device management tool for browsers, which supports the acquisition of microphone, camera and screen shared images. Including some external equipment

The PC supports the browser under windows, MacOS, Linux and electron

The mobile terminal supports Android and IOS browser

forked from [devicemanager](https://github.com/fjqgx/devicemanager)


[device manager demo](https://fjqgx.github.io/devicemanager/demo/) 

### Install
  html
  ``` html
    <script src="./browserdevicemanager.js" ></script>
  ```

  npm
  ``` javascript
    npm i browserdevicemanager
  ```

### Usage

#### get camera list
  ``` javascript
    var devicemanager = new BrowserDeviceManager();

    devicemanager.getCameraList().then((list) => {
      for (let i = 0; i < list.length; ++i) {
        console.log("camera label:", list[i].label, "  deviceId:", list[i].deviceId);
      }
    }).catch((err) => {
      console.log(err);
    })
  ```

#### get mic list
  ``` javascript
    var devicemanager = new BrowserDeviceManager();

    devicemanager.getMicList().then((list) => {
      for (let i = 0; i < list.length; ++i) {
        console.log("camera label:", list[i].label, "  deviceId:", list[i].deviceId);
      }
    }).catch((err) => {
      console.log(err);
    })
  ```

#### get camera
   
  pc
  ``` javascript
  var devicemanager = new BrowserDeviceManager();
  devicemanager.getVideoTrack({deviceId: ""}).then((videotrack) => {
    let mediastream = new MediaStream();
    mediastream.addTrack(videotrack);
    video.srcObject = mediastream;  // video is html video element
  }).catch((err) => {
    console.log("get video track error:", err);
  })
  ```

  mobile
  ``` javascript
  var devicemanager = new BrowserDeviceManager();
  // user is front, environment is back camera
  devicemanager.getVideoTrack({facingMode: "user" }).then((videotrack) => {
    let mediastream = new MediaStream();
    mediastream.addTrack(videotrack);
    video.srcObject = mediastream;  // video is html video element
  }).catch((err) => {
    console.log("get video track error:", err);
  })
  ```

#### get mic
  ``` javascript
  var devicemanager = new BrowserDeviceManager();

  devicemanager.geAudioTrack({deviceId: ""}).then((videotrack) => {
    let mediastream = new MediaStream();
    mediastream.addTrack(videotrack);
    audio.srcObject = mediastream;  // audio is html audio element
  }).catch((err) => {
    console.log("get audio track error:", err);
  })
  ```

#### get screen
  ``` javascript
  var devicemanager = new BrowserDeviceManager();

  devicemanager.getScreenTrack().then((mediastream) => {
    video.srcObject = mediastream;  // video is html video element
  }).catch((err) => {
    console.log("get screen track error:", err);
  })
  ```

---
_Source: https://npm.io/package/media-device · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
