@addpipe/react-pipe-media-recorder
provides a fully typed React hook for both TypeScript and JavaScript integrations that introduces the Pipe Platform into your React projects. This package allows video, audio, and screen + camera recording. It's ideal for applications that need to capture user-generated content such as video feedback, messages, resumes, or testimonials. The recorder is easy to set up and ensures cross-platform compatibility, working on both desktop and mobile devices.
With @addpipe/react-pipe-media-recorder
, you can:
- Record high-quality audio and video content directly from users.
- Capture screen and camera for detailed visual feedback or presentations.
- Embed multiple recorders on a page for various user interactions.
Note: You will need a free trial or paid account with Addpipe to use this package.
- Video, Audio, and Screen Recording: Add high-quality media recording functionality to any React app, supporting both desktop and mobile devices.
- Up to 4K Video: Supports recording up to 4K resolution.
- No Upload Time: Stream recordings while they are created, minimizing the wait time for users.
- Mobile Compatibility: Supports HTML Media Capture for mobile video/audio recording.
- Screen + Camera Recording: Capture both the screen and camera simultaneously for enhanced recording capabilities.
- Multilingual Support: Available in multiple languages: English, French, German, and Spanish, with custom language support.
- Keyboard Accessibility: Fully controllable via keyboard for improved accessibility.
- Connection Resilience: Auto-reconnect ensures data recovery if the connection drops during recording.
Install the package using npm:
npm install @addpipe/react-pipe-media-recorder
👉 Working Demo: You can find a working demo here. The demo is available in both JavaScript and TypeScript React. Find more about it here.
In this example, we insert a single Pipe recorder into the page and control it using the recorder's API (record()
and stopVideo()
).
import { useState } from "react";
import usePipeSDK from "@addpipe/react-pipe-media-recorder"; // Importing the Pipe recorder npm package
// Inserting a single Pipe recorder into the page
const SingleRecorder = () => {
// Storing the generated recorder inside of a state - optional
const [recorder, setRecorder] = useState(null);
// Using the Pipe recorder custom hook
const { isLoaded } = usePipeSDK((PipeSDK) => {
// Check to make sure the code below is only executed on the initial load
if (isLoaded) return;
// Prepare the parameters needed to generate a new recorder
const pipeParams = { size: { width: 640, height: 390 }, qualityurl: "avq/360p.xml", accountHash: "YOUR_ACCOUNT_HASH", eid: "YOUR_ENV_CODE", mrt: 600, avrec: 1 };
// Inserting a new recorder into the page
PipeSDK.insert("custom-id", pipeParams, (pipeRecorder) => {
setRecorder(pipeRecorder); // Store the recorder instance for later use
});
});
// Function to start a new recording using the recorder's API
const startRecording = () => {
if (!recorder) return;
recorder.record(); // Call to start recording
};
// Function to stop a recording using the recorder's API
const stopRecording = () => {
if (!recorder) return;
recorder.stopVideo(); // Call to stop recording
};
return (
<div>
{!isLoaded && <div>Loading the Pipe recorder</div>}
<div id="custom-id"></div> {/* Placeholder for where the new recorder should be inserted */}
{isLoaded && recorder && (
<>
{/* Buttons to control the recorder - Only display them after all prerequisites have loaded */}
<button onClick={startRecording}>Record</button>
<button onClick={stopRecording}>Stop</button>
</>
)}
</div>
);
};
export default SingleRecorder;
This example demonstrates how to insert multiple Pipe recorders into the page and also load Pipe from our S1 client delivery servers, rather than our CDN.
import { useState } from "react";
import usePipeSDK from "@addpipe/react-pipe-media-recorder"; // Importing the Pipe recorder npm package
// Inserting multiple Pipe recorders into the page
const MultipleRecorders = () => {
// Storing the global PipeSDK into a state
const [pipeSdk, setPipeSdk] = useState(null);
// Custom IDs for the recorders
const CUSTOM_IDS = ["custom-id-1", "custom-id-2", "custom-id-3"];
// Using the Pipe recorder custom hook
const { isLoaded } = usePipeSDK((PipeSDK) => {
// Check to make sure the code below is only executed on the initial load
if (isLoaded) return;
// Prepare the parameters needed to generate new recorders
const pipeParams = { size: { width: 640, height: 390 }, qualityurl: "avq/360p.xml", accountHash: "YOUR_ACCOUNT_HASH", eid: "YOUR_ENV_CODE", mrt: 600, avrec: 1 };
// Inserting new recorders into the page
CUSTOM_IDS.forEach((id) => PipeSDK.insert(id, pipeParams, () => {}));
// Store PipeSDK into a state for controlling the recorders later
setPipeSdk(PipeSDK);
}, true); // Adding "true" will make it so that Pipe is loaded from our S1 client delivery servers
// Function to start a new recording using PipeSDK
const startRecording = (recorderId) => {
if (!pipeSdk) return;
pipeSdk.getRecorderById(recorderId).record(); // Call to start recording for a specific recorder
};
// Function to stop a recording using PipeSDK
const stopRecording = (recorderId) => {
if (!pipeSdk) return;
pipeSdk.getRecorderById(recorderId).stopVideo(); // Call to stop recording for a specific recorder
};
return (
<>
{CUSTOM_IDS.map((id, index) => (
<div key={index}>
<div id={id}></div> {/* Placeholder for where the new recorder should be inserted */}
{/* Buttons to control the recorder - Only display them after all prerequisites have loaded */}
{isLoaded && (
<>
<button onClick={() => startRecording(id)}>Record</button>
<button onClick={() => stopRecording(id)}>Stop</button>
</>
)}
</div>
))}
</>
);
};
export default MultipleRecorders;
To control the recorders, you can use the API control methods, such as:
-
record()
: Starts a new recording. -
stopVideo()
: Stops the recording.
A full list of the recorder's API control methods can be found in the official Pipe API Documentation.
The pipeParams
object is used to configure the Pipe recorder. Here’s an example of its structure:
const pipeParams = {
size: { width: 640, height: 390 },
qualityurl: "avq/360p.xml",
accountHash: "YOUR_ACCOUNT_HASH",
eid: "YOUR_ENV_CODE",
mrt: 600,
avrec: 1,
// Additional options available in the official documentation
};
For more detailed embed code options, refer to the Addpipe Embed Code Options.
- Official Developer Documentation: Addpipe Docs
- Pricing Information: Addpipe Pricing
- Video Recorder
- Video Recording
- Audio Recorder
- Audio Recording
- Screen Recorder
- Screen Recording
- Camera Recorder
- React Video Recorder
- React Audio Recorder
- Screen and Camera Capture
- React Hooks for Media