Metadata Management

Send/update metadata. More...

Functions
void	bigvoice_SetMetadata (struct bigvoice_CInstance *instance, const char *key, const char *value)
void	bigvoice_SetMetadataMulti (struct bigvoice_CInstance *instance, const char **keyvalue)
const char **	bigvoice_GetMetadataInfos (struct bigvoice_CInstance *instance)
void	bigvoice_FreeMetadataInfos (struct bigvoice_CInstance *instance, const char **infos)

Detailed Description

Metadata is used on-need, and might be used by extensions modules (Watermarking, Streaming, ...)

Function Documentation

bigvoice_FreeMetadataInfos()

void bigvoice_FreeMetadataInfos	(	struct bigvoice_CInstance *	instance,
		const char **	infos
	)

Frees the information returned by bigvoice_GetMetadataInfos.

Parameters

instance	the instance
infos	the infos

bigvoice_GetMetadataInfos()

const char ** bigvoice_GetMetadataInfos

(

struct bigvoice_CInstance *

instance

)

Get information on known metadata keys.

Parameters

instance

the instance

Returns

a list of key,descriptions, null terminated, of known metadata keys used in process and extensions. May be null. Should be freed with bigvoice_FreeMetadataInfos

bigvoice_SetMetadata()

void bigvoice_SetMetadata	(	struct bigvoice_CInstance *	instance,
		const char *	key,
		const char *	value
	)

Adds the specific metadata to the process.

It can come from any thread, and will be used as soon as possible.

Setting a null value erase the metadata, which is different from setting an empty string. Initial metadata might be set as soon as instance is created (and before update thread).

See also

bigvoice_SetMetadataMulti

Parameters

instance	the instance
key	the metadata key. If key contains a dot (like wm.KEY), it will be sent only to the matching plugin (ie wm here) without the prefix (ie KEY here). Use empty prefix for routing to main only.
value	the metadata value or nullptr to erase it.

bigvoice_SetMetadataMulti()

void bigvoice_SetMetadataMulti	(	struct bigvoice_CInstance *	instance,
		const char **	keyvalue
	)

Adds multiple metadata to the process.

This works like bigvoice_SetMetadata but with multiple metadata at once.

See also

bigvoice_SetMetadata

Parameters

instance	the instance
keyvalue	a list of key/value pair, ending with null key.