Audio/Video stream. More...

#include "config.h"
#include "connection.h"

Typedefs
typedef struct otc_stream	otc_stream

Enumerations
enum	otc_stream_video_type { OTC_STREAM_VIDEO_TYPE_CAMERA = 1 , OTC_STREAM_VIDEO_TYPE_SCREEN , OTC_STREAM_VIDEO_TYPE_CUSTOM = 3 }

Functions
const char *	otc_stream_get_id (const otc_stream *stream)
const char *	otc_stream_get_name (const otc_stream *stream)
	otc_boolotc_stream_has_video_track (const otc_stream *stream)
	otc_boolotc_stream_has_video (const otc_stream *stream)
	otc_boolotc_stream_has_audio_track (const otc_stream *stream)
	otc_boolotc_stream_has_audio (const otc_stream *stream)
	otc_boolotc_stream_has_captions (const otc_stream *stream)
otc_stream *	otc_stream_copy (const otc_stream *stream)
	otc_statusotc_stream_delete (otc_stream *stream)
	intotc_stream_get_video_width (const otc_stream *stream)
	intotc_stream_get_video_height (const otc_stream *stream)
	int64_totc_stream_get_creation_time (const otc_stream *stream)
enum otc_stream_video_type	otc_stream_get_video_type (const otc_stream *stream)
const otc_connection *	otc_stream_get_connection (const otc_stream *stream)

Detailed Description

Audio/Video stream.

This file includes the type definition for an audio-video stream along with several function declarations useful when handling it.

Typedef Documentation

◆ otc_stream

typedef struct otc_stream otc_stream

Type definition for a struct representing an audio-video stream in an OpenTok session.

Enumeration Type Documentation

◆ otc_stream_video_type

enum otc_stream_video_type

Stream video type enumeration.

This enumeration represents the different stream video types supported.

Enumerator
OTC_STREAM_VIDEO_TYPE_CAMERA	Camera video stream.
OTC_STREAM_VIDEO_TYPE_SCREEN	Screen video stream. This is used for screen-sharing.
OTC_STREAM_VIDEO_TYPE_CUSTOM	Custom video stream.

Function Documentation

◆ int64_totc_stream_get_creation_time()

int64_totc_stream_get_creation_time ( const otc_stream * stream )

extern

Gets the creation time of the stream.

Parameters

stream The stream being queried.

Returns: The timestamp for the creation time of the stream.

◆ intotc_stream_get_video_height()

intotc_stream_get_video_height ( const otc_stream * stream )

extern

Returns the height of the publisher's capturer target resolution, in pixels, as last signaled to the session. This value is broadcast to all session participants and is readable on both the publishing and subscribing clients.

Note: This represents the publisher's capturer target resolution, not the resolution actually encoded or received by a subscriber. The publisher may encode at a lower resolution due to bandwidth or CPU constraints.

For streams published using the scalable video feature, this is set to the height of the maximum resolution available for the stream. For more information on scalable video, see the documentation for the OpenTok Media Router.

Parameters

stream The stream being queried.

Returns: The height, in pixels, of the publisher's capturer target resolution.

◆ intotc_stream_get_video_width()

intotc_stream_get_video_width ( const otc_stream * stream )

extern

Returns the width of the publisher's capturer target resolution, in pixels, as last signaled to the session. This value is broadcast to all session participants and is readable on both the publishing and subscribing clients.

Note: This represents the publisher's capturer target resolution, not the resolution actually encoded or received by a subscriber. The publisher may encode at a lower resolution due to bandwidth or CPU constraints. For streams published using the scalable video feature, this is set to the width of the maximum resolution available for the stream. For more information on scalable video, see the documentation for the OpenTok Media Router.

Parameters

stream The stream being queried.

Returns: The width, in pixels, of the publisher's capturer target resolution.

◆ otc_boolotc_stream_has_audio()

otc_boolotc_stream_has_audio ( const otc_stream * stream )

extern

Checks whether this stream is currently publishing audio or not.

Parameters

stream The stream being queried.

Returns: Return value indicating whether this stream is publishing audio or not.

◆ otc_boolotc_stream_has_audio_track()

otc_boolotc_stream_has_audio_track ( const otc_stream * stream )

extern

Checks whether this stream contains an audio track or not.

Parameters

stream The stream being queried.

Returns: Return value indicating whether this stream contains an audio track or not.

◆ otc_boolotc_stream_has_captions()

otc_boolotc_stream_has_captions ( const otc_stream * stream )

extern

Checks whether this stream is currently publishing captions or not.

Parameters

stream The stream being queried.

Returns: Return value indicating whether this stream is publishing captions or not.

◆ otc_boolotc_stream_has_video()

otc_boolotc_stream_has_video ( const otc_stream * stream )

extern

Checks whether this stream is currently publishing video or not.

Parameters

stream The stream being queried.

Returns: Return value indicating whether this stream is publishing video or not.

◆ otc_boolotc_stream_has_video_track()

otc_boolotc_stream_has_video_track ( const otc_stream * stream )

extern

Checks whether this stream contains a video track or not.

Parameters

stream The stream being queried.

Returns: Return value indicating whether this stream contains a video track or not.

◆ otc_statusotc_stream_delete()

otc_statusotc_stream_delete ( otc_stream * stream )

extern

Releases resources associated with the stream.

Parameters

stream The stream being queried.

Returns: Return value indicating either error or success.

◆ otc_stream_copy()

otc_stream * otc_stream_copy ( const otc_stream * stream )

extern

Makes a copy of a stream.

Parameters

stream The stream to be copied.

Returns: A copy of the stream. This can be null if there is an error.

◆ otc_stream_get_connection()

const otc_connection * otc_stream_get_connection ( const otc_stream * stream )

extern

Get the connection associated with the client publishing the stream.

Parameters

stream The stream being queried.

Returns: The connection associated with the client publishing the stream.

◆ otc_stream_get_id()

const char * otc_stream_get_id ( const otc_stream * stream )

extern

Gets the unique identifier for this stream.

Parameters

stream The stream.

Returns: The unique identifier for this stream.

◆ otc_stream_get_name()

const char * otc_stream_get_name ( const otc_stream * stream )

extern

Gets the name of the stream. The publisher of the stream can set this name to identify the stream.

Parameters

stream The stream being queried.

Returns: The stream name.

◆ otc_stream_get_video_type()

enum otc_stream_video_type otc_stream_get_video_type ( const otc_stream * stream )

extern

Returns the video type of the stream.

Parameters

stream The stream being queried.

Returns: The video type of the stream.

See also: otc_stream_video_type

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

◆ otc_stream

Enumeration Type Documentation

◆ otc_stream_video_type

Function Documentation

◆ int64_totc_stream_get_creation_time()

◆ intotc_stream_get_video_height()

◆ intotc_stream_get_video_width()

◆ otc_boolotc_stream_has_audio()

◆ otc_boolotc_stream_has_audio_track()

◆ otc_boolotc_stream_has_captions()

◆ otc_boolotc_stream_has_video()

◆ otc_boolotc_stream_has_video_track()

◆ otc_statusotc_stream_delete()

◆ otc_stream_copy()

◆ otc_stream_get_connection()

◆ otc_stream_get_id()

◆ otc_stream_get_name()

◆ otc_stream_get_video_type()