base.h File Reference

Base functions. More...

#include "config.h"

Go to the source code of this file.

Data Structures
struct	otc_on_mute_forced_info

Typedefs
typedef int	otc_bool
typedef int	otc_status
typedef void(*	otc_logger_callback) (const char *message)

Enumerations
enum	otc_video_reason { OTC_VIDEO_REASON_PUBLISH_VIDEO, OTC_VIDEO_REASON_SUBSCRIBE_TO_VIDEO, OTC_VIDEO_REASON_QUALITY = 3, OTC_VIDEO_REASON_CODEC_NOT_SUPPORTED = 4 }
enum	otc_constant { OTC_SUCCESS = 0, OTC_FALSE = 0, OTC_TRUE = !OTC_FALSE }
enum	otc_error_code {   OTC_INVALID_PARAM = 1, OTC_FATAL = 2, OTC_INVALID_VIDEO_FORMAT = 3, OTC_CONNECTION_DROPPED = 1022,   OTC_UNABLE_TO_FORCE_MUTE = 1540, OTC_CONNECTION_TIMED_OUT = 1542, OTC_UNKNOWN_PUBLISHER_INSTANCE = 2003, OTC_UNKNOWN_SUBSCRIBER_INSTANCE = 2004,   OTC_VIDEO_CAPTURE_FAILED = 3000, OTC_CAMERA_FAILED = 3010, OTC_VIDEO_RENDER_FAILED = 4000, OT_UNABLE_TO_ACCESS_MEDIA_ENGINE = 5000 }
enum	otc_log_level {   OTC_LOG_LEVEL_DISABLED = 0, OTC_LOG_LEVEL_ERROR = 1, OTC_LOG_LEVEL_WARN = 2, OTC_LOG_LEVEL_INFO = 3,   OTC_LOG_LEVEL_DEBUG = 4, OTC_LOG_LEVEL_FATAL = OTC_LOG_LEVEL_ERROR, OTC_LOG_LEVEL_MSG = OTC_LOG_LEVEL_DEBUG, OTC_LOG_LEVEL_TRACE = OTC_LOG_LEVEL_DEBUG,   OTC_LOG_LEVEL_ALL = OTC_LOG_LEVEL_DEBUG }

Functions
otc_status	otc_init (void *reserved)
otc_status	otc_destroy ()
void	otc_log_set_logger_callback (otc_logger_callback callback)
void	otc_log_enable (enum otc_log_level log_level)
enum otc_log_level	otc_get_log_level ()

Detailed Description

Base functions.

This file includes functions uses to initialize and destroy the library engine, as well as other functions to enable console logging.

Typedef Documentation

otc_bool

typedef int otc_bool

Type definition for Boolean values.

Useful type for variables to represent Boolean values (true and false).

otc_logger_callback

typedef void(* otc_logger_callback) (const char *message)

Type definition for a function pointer to the function used as the custom logging callback to get messages logged by the SDK.

Parameters

message

A pointer to the message being logged.

See also

otc_log_set_logger_callback

otc_status

typedef int otc_status

Type definition for statuses.

This is the most common type for return value for functions in this library. This type includes values from the error code enumerations.

See also

otc_constant

otc_error_code

otc_session_error_code

otc_publisher_error_code

otc_subscriber_error_code

Enumeration Type Documentation

otc_constant

enum otc_constant

This enumeration includes commonly used constants.

Enumerator
OTC_SUCCESS	Constant that represents success.
OTC_FALSE	Constant that represents false.
OTC_TRUE	Constant that represents true.

otc_error_code

enum otc_error_code

This enumeration includes error codes.

Enumerator
OTC_INVALID_PARAM	Invalid funtion argument error code. An argment used in a function call is not valid.
OTC_FATAL	Fatal error code. Generic error.
OTC_INVALID_VIDEO_FORMAT	Invalid video format Raised when the capturer is configured with an invalid video format
OTC_CONNECTION_DROPPED	Connection dropped error code. The connection to the OpenTok messaging server was dropped. Check the network connection.
OTC_UNABLE_TO_FORCE_MUTE	Force mute error code. Unable to successfully call otc_session_force_mute_all or otc_session_force_mute_stream, perhaps because of missing permissions.
OTC_CONNECTION_TIMED_OUT	Connection time out error code. Time out while performing a connect action.
OTC_UNKNOWN_PUBLISHER_INSTANCE	Unknown publisher instance error code. An unknown Publisher instance was used as a function argument.
OTC_UNKNOWN_SUBSCRIBER_INSTANCE	Unknown subscriber instance error code. An unknown subscriber instance was used as a function argument.
OTC_VIDEO_CAPTURE_FAILED	Video capture error code. There was an error with the video capturer.
OTC_CAMERA_FAILED	Acquiring video camera error code. There was an error while acquiring video from the camera.
OTC_VIDEO_RENDER_FAILED	Video rendering error code. There was an error while rendering video.
OT_UNABLE_TO_ACCESS_MEDIA_ENGINE	Media engine access error code. There was an error when trying to get the list of supported video codecs.

otc_log_level

enum otc_log_level

Log level enumeration.

This enumeration represents the different log levels supported.

Enumerator
OTC_LOG_LEVEL_DISABLED	No messages enum value.
OTC_LOG_LEVEL_ERROR	Error level messages.
OTC_LOG_LEVEL_WARN	Warning level messages.
OTC_LOG_LEVEL_INFO	Info level messages.
OTC_LOG_LEVEL_DEBUG	Debug level messages.
OTC_LOG_LEVEL_FATAL	DEPRECATED.
OTC_LOG_LEVEL_MSG	DEPRECATED.
OTC_LOG_LEVEL_TRACE	DEPRECATED.
OTC_LOG_LEVEL_ALL	DEPRECATED.

otc_video_reason

enum otc_video_reason

Enum for reasons for a video to be started, stopped, resumed, etc.

Enumerator
OTC_VIDEO_REASON_PUBLISH_VIDEO	The client publishing the stream stopped streaming video.
OTC_VIDEO_REASON_SUBSCRIBE_TO_VIDEO	The local client stopped subscribing to video.
OTC_VIDEO_REASON_QUALITY	The video event was caused by a change to the video stream quality.
OTC_VIDEO_REASON_CODEC_NOT_SUPPORTED	The video event was caused when video in the subscriber stream was disabled because the stream uses a video codec that is not supported on the device.

Function Documentation

otc_destroy()

otc_status otc_destroy

(

)

Destroys the library engine. You should call this function when you are done executing code that uses the library.

Returns

Return value indicating either error or success.

otc_get_log_level()

enum otc_log_level otc_get_log_level

(

)

Gets the current console logging level.

Returns

The log level set.

otc_init()

otc_status otc_init

(

void *

reserved

)

Initializes the library. You must call this function before the execution of any other code using the library.

Parameters

reserved

A void pointer to a memory area holding reserved resources used for the internal implementation. This must be set to NULL.

Returns

Return value indicating either error or success.

otc_log_enable()

void otc_log_enable

(

enum otc_log_level

log_level

)

Enables logging of SDK messages for a given log level.

Parameters

log_level

The desired log level.

See also

otc_log_set_logger_callback

otc_get_log_level

otc_log_set_logger_callback()

void otc_log_set_logger_callback

(

otc_logger_callback

callback

)

Sets the function pointer to a custom logging callback function to get messages logged by the SDK. If you do not set a logging callback function, the SDK will log messages to the console.

Parameters

callback

A pointer to the callback function.

See also

otc_log_enable