mrcp_server_connection.h

Go to the documentation of this file.

/*
 * Copyright 2008-2015 Arsen Chaloyan
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef MRCP_SERVER_CONNECTION_H
#define MRCP_SERVER_CONNECTION_H

/**
 * @file mrcp_server_connection.h
 * @brief MRCPv2 Server Connection
 */ 

#include "apt_task.h"
#include "mrcp_connection_types.h"

APT_BEGIN_EXTERN_C

/**
 * Create connection agent.
 * @param id the identifier of the engine
 * @param listen_ip the IP address to listen on
 * @param listen_port the port to listen on
 * @param max_connection_count the number of max MRCPv2 connections
 * @param force_new_connection the policy used in o/a for connection establishment
 * @param pool the pool to allocate memory from
 */
MRCP_DECLARE(mrcp_connection_agent_t*) mrcp_server_connection_agent_create(
                                        const char *id,
                                        const char *listen_ip, 
                                        apr_port_t listen_port, 
                                        apr_size_t max_connection_count,
                                        apt_bool_t force_new_connection,
                                        apr_pool_t *pool);

/**
 * Destroy connection agent.
 * @param agent the agent to destroy
 */
MRCP_DECLARE(apt_bool_t) mrcp_server_connection_agent_destroy(mrcp_connection_agent_t *agent);

/**
 * Start connection agent and wait for incoming requests.
 * @param agent the agent to start
 */
MRCP_DECLARE(apt_bool_t) mrcp_server_connection_agent_start(mrcp_connection_agent_t *agent);

/**
 * Terminate connection agent.
 * @param agent the agent to terminate
 */
MRCP_DECLARE(apt_bool_t) mrcp_server_connection_agent_terminate(mrcp_connection_agent_t *agent);

/**
 * Set connection event handler.
 * @param agent the agent to set event hadler for
 * @param obj the external object to associate with the agent
 * @param vtable the event handler virtual methods
 */
MRCP_DECLARE(void) mrcp_server_connection_agent_handler_set(
                                mrcp_connection_agent_t *agent, 
                                void *obj, 
                                const mrcp_connection_event_vtable_t *vtable);

/**
 * Set MRCP resource factory.
 * @param agent the agent to set resource factory for
 * @param resource_factory the MRCP resource factory to set
 */
MRCP_DECLARE(void) mrcp_server_connection_resource_factory_set(
                                mrcp_connection_agent_t *agent,
                                const mrcp_resource_factory_t *resource_factory);

/**
 * Set rx buffer size.
 * @param agent the agent to set buffer size for
 * @param size the size of rx buffer to set
 */
MRCP_DECLARE(void) mrcp_server_connection_rx_size_set(
                                mrcp_connection_agent_t *agent,
                                apr_size_t size);

/**
 * Set tx buffer size.
 * @param agent the agent to set buffer size for
 * @param size the size of the rx buffer to set
 */
MRCP_DECLARE(void) mrcp_server_connection_tx_size_set(
                                mrcp_connection_agent_t *agent,
                                apr_size_t size);

/**
 * Set max shared use count for an MRCPv2 connection.
 * @param agent the agent to set the parameter for
 * @param max_shared_use_count the number of max shared use count of an MRCPv2 connection
 */
MRCP_DECLARE(void) mrcp_server_connection_max_shared_use_set(
                                mrcp_connection_agent_t *agent,
                                apr_size_t max_shared_use_count);

/**
 * Set inactivity timeout for an MRCPv2 connection.
 * @param agent the agent to set the parameter for
 * @param timeout the inactivity timeout to set in seconds
 */
MRCP_DECLARE(void) mrcp_server_connection_timeout_set(
                                mrcp_connection_agent_t *agent,
                                apr_size_t timeout);

/**
 * Set termination timeout for an MRCPv2 connection.
 * @param agent the agent to set the parameter for
 * @param timeout the termination timeout to set in seconds
 */
MRCP_DECLARE(void) mrcp_server_connection_term_timeout_set(
                                mrcp_connection_agent_t *agent,
                                apr_size_t timeout);

/**
 * Get task.
 * @param agent the agent to get task from
 */
MRCP_DECLARE(apt_task_t*) mrcp_server_connection_agent_task_get(const mrcp_connection_agent_t *agent);

/**
 * Get external object.
 * @param agent the agent to get object from
 */
MRCP_DECLARE(void*) mrcp_server_connection_agent_object_get(const mrcp_connection_agent_t *agent);

/**
 * Get string identifier.
 * @param agent the agent to get identifier of
 */
MRCP_DECLARE(const char*) mrcp_server_connection_agent_id_get(const mrcp_connection_agent_t *agent);


/**
 * Create control channel.
 * @param agent the agent to create channel for
 * @param obj the external object to associate with the control channel
 * @param pool the pool to allocate memory from
 */
MRCP_DECLARE(mrcp_control_channel_t*) mrcp_server_control_channel_create(
                                        mrcp_connection_agent_t *agent, 
                                        void *obj, 
                                        apr_pool_t *pool);

/**
 * Add MRCPv2 control channel.
 * @param channel the control channel to add
 * @param descriptor the control descriptor
 */
MRCP_DECLARE(apt_bool_t) mrcp_server_control_channel_add(
                                        mrcp_control_channel_t *channel, 
                                        mrcp_control_descriptor_t *descriptor);

/**
 * Modify MRCPv2 control channel.
 * @param channel the control channel to modify
 * @param descriptor the control descriptor
 */
MRCP_DECLARE(apt_bool_t) mrcp_server_control_channel_modify(
                                        mrcp_control_channel_t *channel, 
                                        mrcp_control_descriptor_t *descriptor);

/**
 * Remove MRCPv2 control channel.
 * @param channel the control channel to remove
 */
MRCP_DECLARE(apt_bool_t) mrcp_server_control_channel_remove(mrcp_control_channel_t *channel);

/**
 * Destroy MRCPv2 control channel.
 * @param channel the control channel to destroy
 */
MRCP_DECLARE(apt_bool_t) mrcp_server_control_channel_destroy(mrcp_control_channel_t *channel);

/**
 * Send MRCPv2 message.
 * @param channel the control channel to send message through
 * @param message the message to send
 */
MRCP_DECLARE(apt_bool_t) mrcp_server_control_message_send(mrcp_control_channel_t *channel, mrcp_message_t *message);


APT_END_EXTERN_C

#endif /* MRCP_SERVER_CONNECTION_H */