npm.io
2.0.3 • Published 3 years ago

@eduardosmarcal/webcam-easy

Licence
MIT
Version
2.0.3
Deps
0
Size
36 kB
Vulns
0
Weekly
0

Webcam Easy TS/JS

This is a TypeScript/JavaScript library for accessing webcam stream and taking photos.

You can easily add it as a module to your own app.

  • Streaming webcam on desktop computer or mobile
  • Switch back or front cameras on mobile
  • Take pictures and be able to download.

Live Demo

https://bensonruan.com/how-to-access-webcam-and-take-photo-with-javascript/

webcam-easy-demo

Installation

Use Git Clone
git clone https://github.com/eduardosmarcal/webcam-easy.git
OR Use NPM
npm install @eduardosmarcal/webcam-easy

Usage

1. Include script tag in html
<script type="text/javascript" src="https://unpkg.com/@eduardosmarcal/webcam-easy/dist/webcam-easy.min.js"></script>
or import into typescript/javascript
import Webcam from '@eduardosmarcal/webcam-easy';
2. Place elements in HTML
<video id="webcam" autoplay playsinline width="640" height="480"></video>
<canvas id="canvas" style="display: none;"></canvas>
<audio id="snapSound" src="audio/snap.wav" preload="auto"></audio>
3. Call constructor in javascript
const webcamElement = document.getElementById('webcam');
const canvasElement = document.getElementById('canvas');
const snapSoundElement = document.getElementById('snapSound');
const webcam = new Webcam(webcamElement, 'user', canvasElement, snapSoundElement);
4. Start Webcam
webcam.start()
   .then(result =>{
      console.log("webcam started");
   })
   .catch(err => {
       console.log(err);
   });
5. Take Photo
let picture = webcam.snap();
6. Stop Webcam
webcam.stop();

Functions

  • start(startStream) : start streaming webcam

    • get permission from user
    • get all video input devices info
    • select camera based on facingMode
    • start stream

    startStream is optional parameter, default value is true

  • stop() : stop streaming webcam

  • stream() : start streaming webcam to video element

  • snap() : take photo from webcam

  • flip() : change Facing mode and selected camera

Properties

  • facingMode : 'user' or 'environment'
  • webcamList : all available camera device
  • webcamCount : number of available camera device

Keywords