Funciones básicas. Más...

#include "config.h"
Estructuras de datos
struct otc_on_mute_forced_info
Definiciones de tipos
typedef int otc_bool
typedef int otc_status
typedef void(* otc_logger_callback) (const char *mensaje)
Enumeraciones
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_DISCONNECT = 1520, 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 }
Funciones
otc_status otc_init (void *reserved)
otc_status otc_destroy ()
nulo otc_log_set_logger_callback (otc_logger_callback (función de devolución de llamada)
nulo otc_log_enable (enum otc_log_level nivel_de_registro)
enum otc_log_level otc_get_log_level ()

Descripción detallada

Funciones básicas.

Este archivo incluye funciones que se utilizan para inicializar y desactivar el motor de la biblioteca, así como otras funciones para habilitar el registro en la consola.

Documentación sobre `typedef`

otc_bool
typedef int otc_bool

Definición de tipo para valores booleanos.

Tipo útil para variables que representan valores booleanos (verdadero y falso).

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

Definición de tipo para un puntero a la función que se utiliza como callback de registro personalizado para que el SDK registre los mensajes.

Parámetros : | | | | --- | --- | | mensaje | Un puntero al mensaje que se está registrando. |

Véase también : otc_log_set_logger_callback

otc_status
typedef int otc_status

Definición de tipo para los estados.

Este es el tipo más habitual de valor de retorno de las funciones de esta biblioteca. Este tipo incluye valores de las enumeraciones de códigos de error.

Véase también : otc_constant : otc_error_code : otc_session_error_code : otc_código_de_error_del_editor : otc_código_de_error_de_suscriptor

Documentación sobre tipos de enumeración

otc_constant

Esta enumeración incluye las constantes más utilizadas.

Encuestador
OTC_SUCCESS Constante que representa el éxito.
OTC_FALSE Constante que representa el valor «falso».
OTC_TRUE Constante que representa el valor «verdadero».

otc_error_code

Esta enumeración incluye códigos de error.

Encuestador
OTC_INVALID_PARAM Código de error de argumento de función no válido. Un argumento utilizado en una llamada a una función no es válido.
OTC_FATAL Código de error grave. Error genérico.
OTC_INVALID_VIDEO_FORMAT Formato de vídeo no válido. Se produce cuando el capturador está configurado con un formato de vídeo no válido.
OTC_CONNECTION_DROPPED Código de error de pérdida de conexión. Se ha interrumpido la conexión con el servidor de mensajería de OpenTok. Comprueba la conexión a la red.
OTC_UNABLE_TO_FORCE_DISCONNECT Código de error de desconexión forzada. No se ha podido realizar la llamada correctamente otc_session_force_disconnect, quizá debido a que faltan permisos.
OTC_UNABLE_TO_FORCE_MUTE Código de error de silenciamiento forzado. No se ha podido realizar la llamada correctamente otc_session_force_mute_all o otc_session_force_mute_stream, quizá debido a que faltan permisos.
OTC_CONNECTION_TIMED_OUT Código de error de tiempo de espera de conexión. Se ha agotado el tiempo de espera al realizar una acción de conexión.
OTC_UNKNOWN_PUBLISHER_INSTANCE Código de error de instancia de Publisher desconocido. Se ha utilizado una instancia de Publisher desconocida como argumento de una función.
OTC_UNKNOWN_SUBSCRIBER_INSTANCE Código de error de instancia de suscriptor desconocido. Se ha utilizado una instancia de suscriptor desconocida como argumento de una función.
OTC_VIDEO_CAPTURE_FAILED Código de error de captura de vídeo. Se ha producido un error con el dispositivo de captura de vídeo.
OTC_CAMERA_FAILED Código de error al capturar vídeo de la cámara. Se ha producido un error al capturar vídeo de la cámara.
OTC_VIDEO_RENDER_FAILED Código de error de renderización de vídeo. Se ha producido un error al renderizar el vídeo.
OT_UNABLE_TO_ACCESS_MEDIA_ENGINE Código de error de acceso al motor multimedia. Se ha producido un error al intentar obtener la lista de códecs de vídeo compatibles.

otc_log_level

Enumeración de niveles de registro.

Esta enumeración recoge los distintos niveles de registro admitidos.

Encuestador
OTC_LOG_LEVEL_DISABLED Valor de enumeración «Sin mensajes».
OTC_LOG_LEVEL_ERROR Mensajes de nivel de error.
OTC_LOG_LEVEL_WARN Mensajes de nivel de alerta.
OTC_LOG_LEVEL_INFO Mensajes de nivel «Info».
OTC_LOG_LEVEL_DEBUG Mensajes de nivel de depuración.
OTC_LOG_LEVEL_FATAL OBSOLETO.
OTC_LOG_LEVEL_MSG OBSOLETO.
OTC_LOG_LEVEL_TRACE OBSOLETO.
OTC_LOG_LEVEL_ALL OBSOLETO.

otc_video_reason

Enumeración de los motivos por los que se puede iniciar, detener, reanudar, etc., un vídeo.

Encuestador
OTC_VIDEO_REASON_PUBLISH_VIDEO El cliente que emitía la transmisión ha dejado de transmitir el vídeo.
OTC_VIDEO_REASON_SUBSCRIBE_TO_VIDEO El cliente local ha dejado de estar suscrito al servicio de vídeo.
OTC_VIDEO_REASON_QUALITY El problema con el vídeo se debió a un cambio en la calidad de la transmisión de vídeo.
OTC_VIDEO_REASON_CODEC_NOT_SUPPORTED El problema con el vídeo se produjo porque el vídeo de la transmisión del suscriptor se desactivó, ya que la transmisión utiliza un códec de vídeo que no es compatible con el dispositivo.

Documentación de funciones

otc_destroy()
otc_status otc_destroy ( )

Destruye el motor de la biblioteca. Debes llamar a esta función cuando hayas terminado de ejecutar el código que utiliza la biblioteca.

Valores de retorno : Valor de retorno que indica si se ha producido un error o si la operación se ha realizado correctamente.

otc_get_log_level()
enum otc_log_level otc_get_log_level ( )

Obtiene el nivel de registro de la consola actual.

Valores devueltos : El nivel de registro establecido.

otc_init()
otc_status otc_init ( void * reservado )

Inicializa la biblioteca. Debes llamar a esta función antes de ejecutar cualquier otro código que utilice la biblioteca.

Parámetros : | | | | --- | --- | | reservado | Un puntero `void` a un área de memoria que contiene recursos reservados utilizados para la implementación interna. Debe establecerse en NULL. |

Valores de retorno : Valor de retorno que indica si se ha producido un error o si la operación se ha realizado correctamente.

otc_log_enable()
void otc_log_enable ( enum otc_log_level nivel_de_registro )

Habilita el registro de mensajes del SDK para un nivel de registro determinado.

Parámetros : | | | | --- | --- | | log_level | El nivel de registro deseado. |

Véase también : otc_log_set_logger_callback : otc_get_log_level

otc_log_set_logger_callback()
void otc_log_set_logger_callback ( otc_logger_callback llamada de retorno )

Establece el puntero de función en una función de devolución de llamada de registro personalizada para que el SDK registre los mensajes. Si no se establece una función de devolución de llamada de registro, el SDK registrará los mensajes en la consola.

Parámetros : | | | | --- | --- | | callback | Un puntero a la función de devolución de llamada. |

Véase también : otc_log_enable