/* * (C) Copyright 2017-2018 OpenVidu (http://openvidu.io/) * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ import { Session } from './Session'; import { SessionProperties } from './SessionProperties'; import { Recording } from './Recording'; import { RecordingLayout } from './RecordingLayout'; import { RecordingProperties } from './RecordingProperties'; declare const Buffer; const https = require('https'); export class OpenVidu { private static readonly API_RECORDINGS: string = '/api/recordings'; private static readonly API_RECORDINGS_START: string = '/start'; private static readonly API_RECORDINGS_STOP: string = '/stop'; private hostname: string; private port: number; private basicAuth: string; /** * @param urlOpenViduServer Public accessible IP where your instance of OpenVidu Server is up an running * @param secret Secret used on OpenVidu Server initialization */ constructor(private urlOpenViduServer: string, secret: string) { this.setHostnameAndPort(); this.basicAuth = this.getBasicAuth(secret); } public createSession(properties?: SessionProperties): Session { return new Session(this.hostname, this.port, this.basicAuth, properties); } public startRecording(sessionId: string): Promise; public startRecording(sessionId: string, name: string): Promise; public startRecording(sessionId: string, properties: RecordingProperties): Promise; /** * Starts the recording of a [[Session]] * * @param sessionId The `sessionId` of the [[Session]] you want to start recording * @param name The name you want to give to the video file. You can access this same value in your clients on recording events (`recordingStarted`, `recordingStopped`) * * @returns A Promise that is resolved to the [[Recording]] if it successfully started and rejected with an Error object if not. This Error object has as `message` property with the following values: * - `404`: no session exists for the passed `sessionId` * - `400`: the session has no connected participants * - `409`: the session is not configured for using [[MediaMode.ROUTED]] or it is already being recorded */ public startRecording(sessionId: string, param2?: string | RecordingProperties): Promise { return new Promise((resolve, reject) => { let requestBody; if (!!param2) { if (!(typeof param2 === 'string')) { const properties = param2; requestBody = JSON.stringify({ session: sessionId, name: !!properties.name ? properties.name : '', recordingLayout: !!properties.recordingLayout ? properties.recordingLayout : '', customLayout: !!properties.customLayout ? properties.customLayout : '' }); } else { requestBody = JSON.stringify({ session: sessionId, name: param2, recordingLayout: '', customLayout: '' }); } } else { requestBody = JSON.stringify({ session: sessionId, name: '', recordingLayout: '', customLayout: '' }); } const options = { hostname: this.hostname, port: this.port, path: OpenVidu.API_RECORDINGS + OpenVidu.API_RECORDINGS_START, method: 'POST', headers: { 'Authorization': this.basicAuth, 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(requestBody) } }; const req = https.request(options, (res) => { let body = ''; res.on('data', (d) => { // Continuously update stream with data body += d; }); res.on('end', () => { if (res.statusCode === 200) { // SUCCESS response from openvidu-server (Recording in JSON format). Resolve new Recording resolve(new Recording(JSON.parse(body))); } else { // ERROR response from openvidu-server. Resolve HTTP status reject(new Error(res.statusCode)); } }); }); req.on('error', (e) => { reject(new Error(e)); }); req.write(requestBody); req.end(); }); } /** * Stops the recording of a [[Session]] * * @param recordingId The `id` property of the [[Recording]] you want to stop * * @returns A Promise that is resolved to the [[Recording]] if it successfully stopped and rejected with an Error object if not. This Error object has as `message` property with the following values: * - `404`: no recording exists for the passed `recordingId` * - `406`: recording has `starting` status. Wait until `started` status before stopping the recording */ public stopRecording(recordingId: string): Promise { return new Promise((resolve, reject) => { const options = { hostname: this.hostname, port: this.port, path: OpenVidu.API_RECORDINGS + OpenVidu.API_RECORDINGS_STOP + '/' + recordingId, method: 'POST', headers: { 'Authorization': this.basicAuth, 'Content-Type': 'application/x-www-form-urlencoded' } }; const req = https.request(options, (res) => { let body = ''; res.on('data', (d) => { // Continuously update stream with data body += d; }); res.on('end', () => { if (res.statusCode === 200) { // SUCCESS response from openvidu-server (Recording in JSON format). Resolve new Recording resolve(new Recording(JSON.parse(body))); } else { // ERROR response from openvidu-server. Resolve HTTP status reject(new Error(res.statusCode)); } }); }); req.on('error', (e) => { reject(new Error(e)); }); // req.write(); req.end(); }); } /** * Gets an existing [[Recording]] * * @param recordingId The `id` property of the [[Recording]] you want to retrieve * * @returns A Promise that is resolved to the [[Recording]] if it successfully stopped and rejected with an Error object if not. This Error object has as `message` property with the following values: * - `404`: no recording exists for the passed `recordingId` */ public getRecording(recordingId: string): Promise { return new Promise((resolve, reject) => { const options = { hostname: this.hostname, port: this.port, path: OpenVidu.API_RECORDINGS + '/' + recordingId, method: 'GET', headers: { 'Authorization': this.basicAuth, 'Content-Type': 'application/x-www-form-urlencoded' } }; const req = https.request(options, (res) => { let body = ''; res.on('data', (d) => { // Continuously update stream with data body += d; }); res.on('end', () => { if (res.statusCode === 200) { // SUCCESS response from openvidu-server (Recording in JSON format). Resolve new Recording resolve(new Recording(JSON.parse(body))); } else { // ERROR response from openvidu-server. Resolve HTTP status reject(new Error(res.statusCode)); } }); }); req.on('error', (e) => { reject(new Error(e)); }); // req.write(); req.end(); }); } /** * Lists all existing recordings * * @returns A Promise that is resolved to an array with all existing recordings */ public listRecordings(): Promise { return new Promise((resolve, reject) => { const options = { hostname: this.hostname, port: this.port, path: OpenVidu.API_RECORDINGS, method: 'GET', headers: { 'Authorization': this.basicAuth, 'Content-Type': 'application/x-www-form-urlencoded' } }; const req = https.request(options, (res) => { let body = ''; res.on('data', (d) => { // Continuously update stream with data body += d; }); res.on('end', () => { if (res.statusCode === 200) { // SUCCESS response from openvidu-server (JSON arrays of recordings in JSON format). Resolve list of new recordings const recordingArray: Recording[] = []; const responseItems = JSON.parse(body).items; for (const item of responseItems) { recordingArray.push(new Recording(item)); } resolve(recordingArray); } else { // ERROR response from openvidu-server. Resolve HTTP status reject(new Error(res.statusCode)); } }); }); req.on('error', (e) => { reject(new Error(e)); }); // req.write(); req.end(); }); } /** * Deletes a [[Recording]]. The recording must have status `stopped` or `available` * * @param recordingId * * @returns A Promise that is resolved if the Recording was successfully deleted and rejected with an Error object if not. This Error object has as `message` property with the following values: * - `404`: no recording exists for the passed `recordingId` * - `409`: the recording has `started` status. Stop it before deletion */ public deleteRecording(recordingId: string): Promise { return new Promise((resolve, reject) => { const options = { hostname: this.hostname, port: this.port, path: OpenVidu.API_RECORDINGS + '/' + recordingId, method: 'DELETE', headers: { 'Authorization': this.basicAuth, 'Content-Type': 'application/x-www-form-urlencoded' } }; const req = https.request(options, (res) => { let body = ''; res.on('data', (d) => { // Continuously update stream with data body += d; }); res.on('end', () => { if (res.statusCode === 204) { // SUCCESS response from openvidu-server. Resolve undefined resolve(undefined); } else { // ERROR response from openvidu-server. Resolve HTTP status reject(new Error(res.statusCode)); } }); }); req.on('error', (e) => { reject(new Error(e)); }); // req.write(); req.end(); }); } private getBasicAuth(secret: string): string { return 'Basic ' + (new Buffer('OPENVIDUAPP:' + secret).toString('base64')); } private setHostnameAndPort(): void { const urlSplitted = this.urlOpenViduServer.split(':'); if (urlSplitted.length === 3) { // URL has format: http:// + hostname + :port this.hostname = this.urlOpenViduServer.split(':')[1].replace(/\//g, ''); this.port = parseInt(this.urlOpenViduServer.split(':')[2].replace(/\//g, '')); } else if (urlSplitted.length === 2) { // URL has format: hostname + :port this.hostname = this.urlOpenViduServer.split(':')[0].replace(/\//g, ''); this.port = parseInt(this.urlOpenViduServer.split(':')[1].replace(/\//g, '')); } else { console.error("URL format incorrect: it must contain hostname and port (current value: '" + this.urlOpenViduServer + "')"); } } }