#include "legato.h"
#include "le_audio_interface.h"

Macros
#define	STREAMMEDIA_MAX_IP_LENGTH 15

#define	STREAMMEDIA_MAX_BYE_REASON_LENGTH 255

#define	STREAMMEDIA_MAX_SDES_FIELD_LENGTH 255

#define	STREAMMEDIA_DEFAULT_RTP_PORT 4000

Typedefs
typedef void(*	streamMedia_DisconnectHandler_t) (void *)

typedef struct streamMedia_RtcpHandler *	streamMedia_RtcpHandlerRef_t

typedef void(*	streamMedia_RtcpHandlerFunc_t) (le_audio_StreamRef_t streamRef, streamMedia_RtcpEvent_t event, void *contextPtr)

Enumerations
enum	streamMedia_RtcpEvent_t { STREAMMEDIA_RTCP_SDES = 0, STREAMMEDIA_RTCP_BYE = 1, STREAMMEDIA_RTCP_SR = 2, STREAMMEDIA_RTCP_RR = 3, STREAMMEDIA_RTCP_APP = 4 }

Functions
void	streamMedia_ConnectService (void)

le_result_t	streamMedia_TryConnectService (void)

void	streamMedia_SetServerDisconnectHandler (streamMedia_DisconnectHandler_t disconnectHandler, void *contextPtr)

void	streamMedia_DisconnectService (void)

le_audio_StreamRef_t	streamMedia_OpenAudioRtpRx (int32_t localPort)

le_audio_StreamRef_t	streamMedia_OpenAudioRtpTx (int32_t localPort, const char *LE_NONNULL remoteIpAddress, int32_t remotePort)

le_result_t	streamMedia_Start (le_audio_StreamRef_t streamRef)

le_result_t	streamMedia_Stop (le_audio_StreamRef_t streamRef)

le_result_t	streamMedia_SendRtcpSdes (le_audio_StreamRef_t streamRef, const char LE_NONNULL cname, const char LE_NONNULL name, const char LE_NONNULL email, const char LE_NONNULL phone, const char LE_NONNULL loc, const char LE_NONNULL tool, const char *LE_NONNULL note)

le_result_t	streamMedia_SendRtcpBye (le_audio_StreamRef_t streamRef, const char *LE_NONNULL reason)

void	streamMedia_Close (le_audio_StreamRef_t streamRef)

streamMedia_RtcpHandlerRef_t	streamMedia_AddRtcpHandler (le_audio_StreamRef_t streamRef, streamMedia_RtcpHandlerFunc_t handlerPtr, void *contextPtr)

void	streamMedia_RemoveRtcpHandler (streamMedia_RtcpHandlerRef_t handlerRef)

Detailed Description

Legato Stream Media include file.

Copyright (C) Sierra Wireless Inc.

Macro Definition Documentation

#define STREAMMEDIA_DEFAULT_RTP_PORT 4000

The default RTP port.

#define STREAMMEDIA_MAX_BYE_REASON_LENGTH 255

The maximum length of the optional RTCP BYE packet reason string length.

#define STREAMMEDIA_MAX_IP_LENGTH 15

The maximum length of the textual representation of an IP address.

#define STREAMMEDIA_MAX_SDES_FIELD_LENGTH 255

The maximum length of a RTCP SDES packet field string length.

Typedef Documentation

typedef void(* streamMedia_DisconnectHandler_t) (void *)

Type for handler called when a server disconnects.

typedef void(* streamMedia_RtcpHandlerFunc_t) (le_audio_StreamRef_t streamRef,streamMedia_RtcpEvent_t event,void *contextPtr)

Handler for RTCP packet reception.

typedef struct streamMedia_RtcpHandler* streamMedia_RtcpHandlerRef_t

Reference type used by Add/Remove functions for EVENT 'streamMedia_Rtcp'

Enumeration Type Documentation

enum streamMedia_RtcpEvent_t

RTCP packet reception events, related to the RTCP packet type. See RFC-3550 for more details.

Enumerator
STREAMMEDIA_RTCP_SDES	RTCP Session Description packet has been received.
STREAMMEDIA_RTCP_BYE	RTCP BYE packet has been received.
STREAMMEDIA_RTCP_SR	RTCP Sender Report packet has been received.
STREAMMEDIA_RTCP_RR	RTCP Receiver Report packet has been received.
STREAMMEDIA_RTCP_APP	RTCP Application-specific packet has been received.

Function Documentation

streamMedia_RtcpHandlerRef_t streamMedia_AddRtcpHandler	(	le_audio_StreamRef_t	streamRef,
		streamMedia_RtcpHandlerFunc_t	handlerPtr,
		void *	contextPtr
	)

Add handler function for EVENT 'streamMedia_Rtcp'

This event provides information on RTCP packet type.

Parameters

[in]	streamRef	Audio stream reference.
[in]	handlerPtr
[in]	contextPtr

void streamMedia_Close ( le_audio_StreamRef_t streamRef )

Close an RTP stream.

Parameters

[in] streamRef Audio stream reference.

void streamMedia_ConnectService ( void )

Connect the current client thread to the service providing this API. Block until the service is available.

For each thread that wants to use this API, either ConnectService or TryConnectService must be called before any other functions in this API. Normally, ConnectService is automatically called for the main thread, but not for any other thread. For details, see Client-specific Functions.

This function is created automatically.

void streamMedia_DisconnectService ( void )

Disconnect the current client thread from the service providing this API.

Normally, this function doesn't need to be called. After this function is called, there's no longer a connection to the service, and the functions in this API can't be used. For details, see Client-specific Functions.

This function is created automatically.

le_audio_StreamRef_t streamMedia_OpenAudioRtpRx ( int32_t localPort )

Open the received audio stream of the RTP interface.

Returns: Reference to the input audio stream, NULL if the function fails.

Parameters

[in] localPort The local UDP socket port for the RTP session.

le_audio_StreamRef_t streamMedia_OpenAudioRtpTx	(	int32_t	localPort,
		const char *LE_NONNULL	remoteIpAddress,
		int32_t	remotePort
	)

Open the transmitted audio stream of the RTP interface.

Returns: Reference to the output audio stream, NULL if the function fails.

Parameters

[in]	localPort	The local UDP socket port for the RTP session.
[in]	remoteIpAddress	The IP address of the remote peer.
[in]	remotePort	The port of the remote peer.

void streamMedia_RemoveRtcpHandler ( streamMedia_RtcpHandlerRef_t handlerRef )

Remove handler function for EVENT 'streamMedia_Rtcp'

Parameters

[in] handlerRef

le_result_t streamMedia_SendRtcpBye	(	le_audio_StreamRef_t	streamRef,
		const char *LE_NONNULL	reason
	)

Send a RTCP BYE packet using pjmedia_rtcp_build_rtcp_bye().

Returns: LE_FAULT Function failed.; LE_OK Function succeeded.

Parameters

[in]	streamRef	Audio stream reference.
[in]	reason	The optional BYE reason.

le_result_t streamMedia_SendRtcpSdes	(	le_audio_StreamRef_t	streamRef,
		const char *LE_NONNULL	cname,
		const char *LE_NONNULL	name,
		const char *LE_NONNULL	email,
		const char *LE_NONNULL	phone,
		const char *LE_NONNULL	loc,
		const char *LE_NONNULL	tool,
		const char *LE_NONNULL	note
	)

Send a RTCP Session Description packet (SDES) using pjmedia_rtcp_build_rtcp_sdes().

Returns: LE_FAULT Function failed.; LE_OK Function succeeded.

Parameters

[in]	streamRef	Audio stream reference.
[in]	cname	The optional source canonical name.
[in]	name	The optional source name.
[in]	email	The optional source email.
[in]	phone	The optional source phone.
[in]	loc	The optional source location.
[in]	tool	The optional source tool.
[in]	note	The optional source note.

void streamMedia_SetServerDisconnectHandler	(	streamMedia_DisconnectHandler_t	disconnectHandler,
		void *	contextPtr
	)

Set handler called when server disconnection is detected.

When a server connection is lost, call this handler then exit with LE_FATAL. If a program wants to continue without exiting, it should call longjmp() from inside the handler.

le_result_t streamMedia_Start ( le_audio_StreamRef_t streamRef )

Start the RTP stream. This must be called after connecting the RTP interface to start RTP reception or transmission.

Returns: LE_FAULT Function failed.; LE_OK Function succeeded.

Parameters

[in] streamRef Audio stream reference.

le_result_t streamMedia_Stop ( le_audio_StreamRef_t streamRef )

Stop the RTP stream.

Returns: LE_FAULT Function failed.; LE_OK Function succeeded.

Parameters

[in] streamRef Audio stream reference.

le_result_t streamMedia_TryConnectService ( void )

Try to connect the current client thread to the service providing this API. Return with an error if the service is not available.

For each thread that wants to use this API, either ConnectService or TryConnectService must be called before any other functions in this API. Normally, ConnectService is automatically called for the main thread, but not for any other thread. For details, see Client-specific Functions.

This function is created automatically.

Returns

LE_OK if the client connected successfully to the service.
LE_UNAVAILABLE if the server is not currently offering the service to which the client is bound.
LE_NOT_PERMITTED if the client interface is not bound to any service (doesn't have a binding).
LE_COMM_ERROR if the Service Directory cannot be reached.

/ Build Apps

streamMedia_interface.h File Reference

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

Typedef Documentation

Enumeration Type Documentation

Function Documentation