record.h File Reference

Audio/Video recorder. More...

#include <inttypes.h>
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
#include "mutex.h"
#include "refcount.h"

Include dependency graph for record.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	janus_recorder
	Structure that represents a recorder. More...

Typedefs
typedef enum janus_recorder_medium	janus_recorder_medium
	Media types we can record. More...
typedef struct janus_recorder	janus_recorder
	Structure that represents a recorder. More...

Enumerations
enum	janus_recorder_medium { JANUS_RECORDER_AUDIO, JANUS_RECORDER_VIDEO, JANUS_RECORDER_DATA }
	Media types we can record. More...

Functions
void	janus_recorder_init (gboolean tempnames, const char *extension)
	Initialize the recorder code. More...
void	janus_recorder_deinit (void)
	De-initialize the recorder code. More...
janus_recorder *	janus_recorder_create (const char *dir, const char *codec, const char *filename)
	Create a new recorder. More...
janus_recorder *	janus_recorder_create_full (const char *dir, const char *codec, const char *fmtp, const char *filename)
	Create a new recorder with additional info. More...
int	janus_recorder_save_frame (janus_recorder *recorder, char *buffer, uint length)
	Save an RTP frame in the recorder. More...
int	janus_recorder_close (janus_recorder *recorder)
	Close the recorder. More...
void	janus_recorder_destroy (janus_recorder *recorder)
	Destroy the recorder instance. More...

Detailed Description

Audio/Video recorder.

Audio/Video recorder (headers)

Author

Lorenzo Miniero loren.nosp@m.zo@m.nosp@m.eetec.nosp@m.ho.c.nosp@m.om

Copyright

GNU General Public License v3

Implementation of a simple recorder utility that plugins can make use of to record audio/video frames to a Janus file. This file just saves RTP frames in a structured way, so that they can be post-processed later on to get a valid container file (e.g., a .opus file for Opus audio or a .webm file for VP8 video) and keep things simpler on the plugin and core side. Check the Recordings documentation for more details.

Note

If you want to record both audio and video, you'll have to use two different recorders. Any muxing in the same container will have to be done in the post-processing phase.

Core

Typedef Documentation

typedef struct janus_recorder janus_recorder

Structure that represents a recorder.

typedef enum janus_recorder_medium janus_recorder_medium

Media types we can record.

Enumeration Type Documentation

enum janus_recorder_medium

Media types we can record.

Enumerator
JANUS_RECORDER_AUDIO
JANUS_RECORDER_VIDEO
JANUS_RECORDER_DATA

Function Documentation

int janus_recorder_close

(

janus_recorder *

recorder

)

Close the recorder.

Parameters

[in]

recorder

The janus_recorder instance to close

Returns

0 in case of success, a negative integer otherwise

janus_recorder* janus_recorder_create	(	const char *	dir,
		const char *	codec,
		const char *	filename
	)

Create a new recorder.

Note

If no target directory is provided, the current directory will be used. If no filename is passed, a random filename will be used.

Parameters

[in]	dir	Path of the directory to save the recording into (will try to create it if it doesn't exist)
[in]	codec	Codec the packets to record are encoded in ("vp8", "opus", "h264", "g711", "vp9")
[in]	filename	Filename to use for the recording

Returns

A valid janus_recorder instance in case of success, NULL otherwise

janus_recorder* janus_recorder_create_full	(	const char *	dir,
		const char *	codec,
		const char *	fmtp,
		const char *	filename
	)

Create a new recorder with additional info.

Note

This is to allow adding more arguments to janus_recorder_create, but still keep janus_recorder_create in place for backwards compatibility.

Parameters

[in]	dir	Path of the directory to save the recording into (will try to create it if it doesn't exist)
[in]	codec	Codec the packets to record are encoded in ("vp8", "opus", "h264", "g711", "vp9")
[in]	fmtp	Codec-specific details (e.g., the H.264 or VP9 profile)
[in]	filename	Filename to use for the recording

Returns

A valid janus_recorder instance in case of success, NULL otherwise

void janus_recorder_deinit

(

void

)

De-initialize the recorder code.

void janus_recorder_destroy

(

janus_recorder *

recorder

)

Destroy the recorder instance.

Parameters

[in]

recorder

The janus_recorder instance to destroy

void janus_recorder_init	(	gboolean	tempnames,
		const char *	extension
	)

Initialize the recorder code.

Parameters

[in]	tempnames	Whether the filenames should have a temporary extension, while saving, or not
[in]	extension	Extension to add in case tempnames is true

int janus_recorder_save_frame	(	janus_recorder *	recorder,
		char *	buffer,
		uint	length
	)

Save an RTP frame in the recorder.

Parameters

[in]	recorder	The janus_recorder instance to save the frame to
[in]	buffer	The frame data to save
[in]	length	The frame data length

Returns

0 in case of success, a negative integer otherwise