decooda-media-recorder

decooda-media-recorder (1.1.0)

Description

The decooda-media-recorder is a js library for recording video (h.264) and audio (opus) to be used across Decooda's frontend applications. The base component has four main stages: initial, recording, playback, and submission.

Installation and run commands for local testing

Node version v14.8.0 and npm version 6.14.11 are used for development.

First run

npm install

to in install all packages. Finally run

npm start

to open a webpage of the decooda-media-recorder dashboard

Installation in app (React)

In root directory of app:

First run

npm install decooda-media-recorder

Usage (React)

Import the library

import MediaRecorder from 'decooda-media-recorder'

The component accepts the following props:

recordingControls || true or false || whether to display controls during video recording
getRecordedBlob || func || function passed by host to library to retrieve the recorded blob
audioOnly || true or false || whether to display audio recording only  vs both audio and video
insertTitle  || true or false || whether to prompt user for title of media 
showLinkBtn || true or false || whether to show insert link button
showUploadBtn || true or false || whether to show upload media button

const getRecordedBlob = (blob) => {
  //the func will send the recorded blob obj that the host can save or upload:
  //console.log(blob)
  /*
  output:
  {
    title: "test"
    time: date,
    //the raw recorded blob
    blobRaw: recordedBlob,
    //the blob url
    blobURL: url
    //the blob as a data url
    blobFile: file
  }
  */
  //do something with blob
}

<MediaRecorder 
  recordingControls={true} 
  getRecordedBlob={getRecordedBlob} 
  audioOnly={false} 
  insertTitle={false} 
  showLinkBtn={false}
  showUploadBtn={false}
  />