npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@webcam/core

v1.0.1

Published

Ultimate tool for working with media stream

Downloads

309

Readme

📸 Webcam Core

Ultimate tool for working with media stream

References

Installation

Install with npm or yarn

npm i @webcam/core
# or
yarn add @webcam/core

🦉 Philosophy

📸 Webcam Core is a package that includes ready-made solutions for common cases of setting up and using a media stream from your webcam using Web API. Our goal is to create simple and flexible tools that allow users to create, test and maintain their products.

Features

  • TypeScript support out of the box - full typed package
  • Webcam Snapshots - creating an image from a video stream
  • Media Stream Handling - request, errors, update, stop, etc
  • Advanced Video Settings - selecting camera type and resolution
  • Legacy API Support - outdated implementations for each browser

Usage

import {
  applyMediaStreamConstraints,
  getMediaStream,
  getMediaStreamConstraints,
  stopMediaStream
} from '@webcam/core';

let runningStream: MediaStream | undefined;

const requestStream = async (params: GetMediaStreamConstraintsParams) => {
  try {
    runningStream = await getMediaStream(params, 5000);
  } catch (error) {
    console.error(error);
  }
};

const updateConstraints = async (params: GetMediaStreamConstraintsParams) => {
  try {
    const constraints = await getMediaStreamConstraints(params);

    applyMediaStreamConstraints(runningStream, constraints)
  } catch {
    requestMediaStream(params);
  }
};

const stopStream = () => stopMediaStream(runningStream);

requestStream({ mainCamera: true }, { width: 1920, height: 1080 });

API

getUserMedia

Adds extra error handling and support for legacy getUserMedia implementation.

NOTE: The function can only be used in a secure context. For example, when a page is loaded using HTTPS or a page loaded from localhost. Otherwise the function will throw an error.

getMediaStream

Accepts custom parameters and uses getUserMedia to get an instance of the MediaStream.

  • params?: {GetMediaStreamConstraintsParams} - Parameters passed to getMediaStreamConstraints function
  • timeLimitMs?: {number} - Time limit for MediaStream request execution

getMediaStreamConstraints

Generates and returns media stream constraints by passed options.

  • constraints?: {MediaStreamConstraints} - External primary constraints (override output)
  • options?: {MediaTrackConstraintsOptions} - Options for constraints generating
    • muted?: {boolean} - Excludes audio constraints from the MediaStream request
    • ... {VideoTrackConstraintsOptions} - Options passed to getVideoTrackConstraints function

getVideoTrackConstraints

Generates and returns video track constraints by passed options.

  • frontCamera? {boolean} - Should use a front camera (MediaTrackConstraints['facingFront'] === 'user')
  • mainCamera? {boolean | GetMainCameraParams} - Should find and use the main camera by default/passed label patterns
  • cameraResolutionType? {CameraResolutionType} - Video track resolution size (width x height)
    • HD - 1280 x 720
    • FHD - 1920 x 1080
    • QHD - 2560 x 1440
    • UHD - 3840 x 2160
  • cameraResolutionMode? {keyof ConstrainULongRange} - Video track resolution mode
    • min - Value is the smallest permissible. If the value cannot remain equal to or greater than this value, matching will fail.
    • max - Value is the largest permissible. If the value cannot remain equal to or less than this value, matching will fail.
    • exact - Value is specific and required. If the value cannot be considered acceptable, the match will fail.
    • ideal - If possible, a value will be used, but if it's not possible, the user agent will use the closest possible match.

getMainCamera

Returns main camera info in accordance with the default or passed parameters.

NOTE: Requires browser support for Navigator.MediaDevices.enumerateDevices to work.

  • params? {GetMainCameraParams} - Pattern for searching the main camera device info by its label
    • {RegExp} - General default pattern
    • {Object} - Patterns for front and main cameras
      • back? {RegExp} - Value (?=.*\bback\b)(?=.*\b0\b) is using as default
      • front? {RegExp} - Value \bfront\b is using as default
  • isFrontCamera? {boolean} - Should the front camera be searched (back camera as default)

applyMediaStreamConstraints

Applies a set of audio and video constraints to the corresponding media stream tracks.

NOTE: New constraints apply only within the previously used source.

  • stream {MediaStream} - Media stream instance
  • constraints {MediaStreamConstraints} - Constraints to be applied

stopMediaStream

Stops and removes audio and video tracks from the stream.

  • stream? {MediaStream | MediaStreamTrack} - Media stream or its track instance

hasGetUserMedia

Checks for the presence of getUserMedia in mediaDevices.

canGetUserMedia

Checks the possibility of using any implementation of getUserMedia.

getWebcamSnapshot

Returns a base64 encoded string of the current video stream frame in the specified format and quality.

  • source {HTMLVideoElement} - Video element instance with provided media stream
  • options? {GetWebcamSnapshotOptions} - Options for getting webcam snapshot
    • format? - {image/webp | image/png | image/jpeg} - A string indicating the image format (default === image/jpeg)
    • quality? - {number} - A number between 0 and 1 indicating the image quality (only for image/jpeg or image/webp)
    • ... {GetVideoFrameCanvasOptions} - Options passed to getVideoFrameCanvas function

getVideoFrameCanvas

Returns a canvas with a drawn image of the current video stream frame in accordance with the passed options.

  • source {HTMLVideoElement} - Video element instance with provided media stream
  • options? {GetVideoFrameCanvasOptions} - Options for getting video frame canvas
    • width? {number} - Width of the canvas on which the image will be drawn
    • height? {number} - Height of the canvas on which the image will be drawn
    • mirrored? {boolean} - Should the drawing image be mirrored horizontally
    • imageSmoothingEnabled? {boolean} - Should smooth scaled image or not (default === true)

✨ Contributors