147 lines
4.6 KiB
JavaScript
147 lines
4.6 KiB
JavaScript
// _____________________
|
|
// RecordRTC.promises.js
|
|
|
|
/**
|
|
* RecordRTCPromisesHandler adds promises support in {@link RecordRTC}. Try a {@link https://github.com/muaz-khan/RecordRTC/blob/master/simple-demos/RecordRTCPromisesHandler.html|demo here}
|
|
* @summary Promises for {@link RecordRTC}
|
|
* @license {@link https://github.com/muaz-khan/RecordRTC#license|MIT}
|
|
* @author {@link http://www.MuazKhan.com|Muaz Khan}
|
|
* @typedef RecordRTCPromisesHandler
|
|
* @class
|
|
* @example
|
|
* var recorder = new RecordRTCPromisesHandler(mediaStream, options);
|
|
* recorder.startRecording()
|
|
* .then(successCB)
|
|
* .catch(errorCB);
|
|
* @see {@link https://github.com/muaz-khan/RecordRTC|RecordRTC Source Code}
|
|
* @param {MediaStream} mediaStream - Single media-stream object, array of media-streams, html-canvas-element, etc.
|
|
* @param {object} config - {type:"video", recorderType: MediaStreamRecorder, disableLogs: true, numberOfAudioChannels: 1, bufferSize: 0, sampleRate: 0, video: HTMLVideoElement, etc.}
|
|
* @throws Will throw an error if "new" keyword is not used to initiate "RecordRTCPromisesHandler". Also throws error if first argument "MediaStream" is missing.
|
|
* @requires {@link RecordRTC}
|
|
*/
|
|
|
|
function RecordRTCPromisesHandler(mediaStream, options) {
|
|
if (!this) {
|
|
throw 'Use "new RecordRTCPromisesHandler()"';
|
|
}
|
|
|
|
if (typeof mediaStream === 'undefined') {
|
|
throw 'First argument "MediaStream" is required.';
|
|
}
|
|
|
|
var self = this;
|
|
|
|
/**
|
|
* @property {Blob} blob - Access/reach the native {@link RecordRTC} object.
|
|
* @memberof RecordRTCPromisesHandler
|
|
* @example
|
|
* var internal = recorder.recordRTC.getInternalRecorder();
|
|
* alert(internal instanceof MediaStreamRecorder);
|
|
*/
|
|
self.recordRTC = new RecordRTC(mediaStream, options);
|
|
|
|
/**
|
|
* This method records MediaStream.
|
|
* @method
|
|
* @memberof RecordRTCPromisesHandler
|
|
* @example
|
|
* recorder.startRecording()
|
|
* .then(successCB)
|
|
* .catch(errorCB);
|
|
*/
|
|
this.startRecording = function() {
|
|
return new Promise(function(resolve, reject) {
|
|
try {
|
|
self.recordRTC.startRecording();
|
|
resolve();
|
|
} catch (e) {
|
|
reject(e);
|
|
}
|
|
});
|
|
};
|
|
|
|
/**
|
|
* This method stops the recording.
|
|
* @method
|
|
* @memberof RecordRTCPromisesHandler
|
|
* @example
|
|
* recorder.stopRecording().then(function() {
|
|
* var blob = recorder.getBlob();
|
|
* }).catch(errorCB);
|
|
*/
|
|
this.stopRecording = function() {
|
|
return new Promise(function(resolve, reject) {
|
|
try {
|
|
self.recordRTC.stopRecording(function(url) {
|
|
self.blob = self.recordRTC.getBlob();
|
|
|
|
if (!self.blob || !self.blob.size) {
|
|
reject('Empty blob.', self.blob);
|
|
return;
|
|
}
|
|
|
|
resolve(url);
|
|
});
|
|
} catch (e) {
|
|
reject(e);
|
|
}
|
|
});
|
|
};
|
|
|
|
/**
|
|
* This method returns data-url for the recorded blob.
|
|
* @method
|
|
* @memberof RecordRTCPromisesHandler
|
|
* @example
|
|
* recorder.stopRecording().then(function() {
|
|
* recorder.getDataURL().then(function(dataURL) {
|
|
* window.open(dataURL);
|
|
* }).catch(errorCB);;
|
|
* }).catch(errorCB);
|
|
*/
|
|
this.getDataURL = function(callback) {
|
|
return new Promise(function(resolve, reject) {
|
|
try {
|
|
self.recordRTC.getDataURL(function(dataURL) {
|
|
resolve(dataURL);
|
|
});
|
|
} catch (e) {
|
|
reject(e);
|
|
}
|
|
});
|
|
};
|
|
|
|
/**
|
|
* This method returns the recorded blob.
|
|
* @method
|
|
* @memberof RecordRTCPromisesHandler
|
|
* @example
|
|
* recorder.stopRecording().then(function() {
|
|
* recorder.getBlob().then(function(blob) {})
|
|
* }).catch(errorCB);
|
|
*/
|
|
this.getBlob = function() {
|
|
return new Promise(function(resolve, reject) {
|
|
try {
|
|
resolve(self.recordRTC.getBlob());
|
|
} catch (e) {
|
|
reject(e);
|
|
}
|
|
});
|
|
};
|
|
|
|
/**
|
|
* @property {Blob} blob - Recorded data as "Blob" object.
|
|
* @memberof RecordRTCPromisesHandler
|
|
* @example
|
|
* recorder.stopRecording().then(function() {
|
|
* var blob = recorder.getBlob();
|
|
* }).catch(errorCB);
|
|
*/
|
|
this.blob = null;
|
|
}
|
|
|
|
if (typeof RecordRTC !== 'undefined') {
|
|
RecordRTC.RecordRTCPromisesHandler = RecordRTCPromisesHandler;
|
|
}
|