mirror of
https://github.com/asterisk/asterisk.git
synced 2026-07-22 14:34:09 -07:00
Sven Kube
6247fbc545
Extend audiosocket messages with types 0x11 - 0x18 to create asterisk frames in slin12, slin16, slin24, slin32, slin44, slin48, slin96, and slin192 format, enabling the transmission of audio at a higher sample rates. For audiosocket messages sent by Asterisk, the message kind is determined by the format of the originating asterisk frame. UpgradeNote: New audiosocket message types 0x11 - 0x18 has been added for slin12, slin16, slin24, slin32, slin44, slin48, slin96, and slin192 audio. External applications using audiosocket may need to be updated to support these message types if the audiosocket channel is created with one of these audio formats.
149 lines
4.8 KiB
C
149 lines
4.8 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 2019, CyCore Systems, Inc
|
|
*
|
|
* Seán C McCord <scm@cycoresys.com
|
|
*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
* at the top of the source tree.
|
|
*/
|
|
|
|
/*!
|
|
* \file
|
|
* \brief AudioSocket support functions
|
|
*
|
|
* \author Seán C McCord <scm@cycoresys.com>
|
|
*
|
|
*/
|
|
|
|
#ifndef _ASTERISK_RES_AUDIOSOCKET_H
|
|
#define _ASTERISK_RES_AUDIOSOCKET_H
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <uuid/uuid.h>
|
|
|
|
#include "asterisk/frame.h"
|
|
#include "asterisk/uuid.h"
|
|
|
|
|
|
enum ast_audiosocket_msg_kind {
|
|
/*! \brief Message indicates the channel should be hung up, direction: Sent only. */
|
|
AST_AUDIOSOCKET_KIND_HANGUP = 0x00,
|
|
|
|
/*! \brief Message contains the connection's UUID, direction: Received only. */
|
|
AST_AUDIOSOCKET_KIND_UUID = 0x01,
|
|
|
|
/*! \brief Message contains a DTMF digit, direction: Received only. */
|
|
AST_AUDIOSOCKET_KIND_DTMF = 0x03,
|
|
|
|
/*! \brief Messages contains audio data, format: slin, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO = 0x10,
|
|
|
|
/*! \brief Messages contains audio data, format: slin12, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO_SLIN12 = 0x11,
|
|
|
|
/*! \brief Messages contains audio data, format: slin16, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO_SLIN16 = 0x12,
|
|
|
|
/*! \brief Messages contains audio data, format: slin24, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO_SLIN24 = 0x13,
|
|
|
|
/*! \brief Messages contains audio data, format: slin32, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO_SLIN32 = 0x14,
|
|
|
|
/*! \brief Messages contains audio data, format: slin44, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO_SLIN44 = 0x15,
|
|
|
|
/*! \brief Messages contains audio data, format: slin48, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO_SLIN48 = 0x16,
|
|
|
|
/*! \brief Messages contains audio data, format: slin96, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO_SLIN96 = 0x17,
|
|
|
|
/*! \brief Messages contains audio data, format: slin192, direction: Sent and received. */
|
|
AST_AUDIOSOCKET_KIND_AUDIO_SLIN192 = 0x18,
|
|
|
|
/*! \brief An Asterisk-side error occurred, direction: Received only. */
|
|
AST_AUDIOSOCKET_KIND_ERROR = 0xFF,
|
|
};
|
|
|
|
|
|
/*!
|
|
* \brief Send the initial message to an AudioSocket server
|
|
*
|
|
* \param server The server address, including port.
|
|
* \param chan An optional channel which will be put into autoservice during
|
|
* the connection period. If there is no channel to be autoserviced, pass NULL
|
|
* instead.
|
|
*
|
|
* \retval socket file descriptor for AudioSocket on success
|
|
* \retval -1 on error
|
|
*/
|
|
const int ast_audiosocket_connect(const char *server, struct ast_channel *chan);
|
|
|
|
/*!
|
|
* \brief Send the initial message to an AudioSocket server
|
|
*
|
|
* \param svc The file descriptor of the network socket to the AudioSocket server.
|
|
* \param id The UUID to send to the AudioSocket server to uniquely identify this connection.
|
|
*
|
|
* \retval 0 on success
|
|
* \retval -1 on error
|
|
*/
|
|
const int ast_audiosocket_init(const int svc, const char *id);
|
|
|
|
/*!
|
|
* \brief Send an Asterisk audio frame to an AudioSocket server
|
|
*
|
|
* \param svc The file descriptor of the network socket to the AudioSocket server.
|
|
* \param f The Asterisk audio frame to send.
|
|
*
|
|
* \retval 0 on success
|
|
* \retval -1 on error
|
|
*/
|
|
const int ast_audiosocket_send_frame(const int svc, const struct ast_frame *f);
|
|
|
|
/*!
|
|
* \brief Receive an Asterisk frame from an AudioSocket server
|
|
*
|
|
* This returned object is a pointer to an Asterisk frame which must be
|
|
* manually freed by the caller.
|
|
*
|
|
* \param svc The file descriptor of the network socket to the AudioSocket server.
|
|
*
|
|
* \retval A \ref ast_frame on success
|
|
* \retval NULL on error
|
|
*/
|
|
struct ast_frame *ast_audiosocket_receive_frame(const int svc);
|
|
|
|
/*!
|
|
* \brief Receive an Asterisk frame from an AudioSocket server
|
|
*
|
|
* This returned object is a pointer to an Asterisk frame which must be
|
|
* manually freed by the caller.
|
|
*
|
|
* \param svc The file descriptor of the network socket to the AudioSocket
|
|
* server.
|
|
* \param hangup Will be true if the AudioSocket server requested the channel
|
|
* be hung up, otherwise false. Used as an out-parameter only, pass NULL if
|
|
* not needed. The function return value will always be NULL when true.
|
|
*
|
|
* \retval A \ref ast_frame on success
|
|
* \retval NULL on error or when the hungup parameter is true.
|
|
*/
|
|
struct ast_frame *ast_audiosocket_receive_frame_with_hangup(const int svc,
|
|
int *const hangup);
|
|
|
|
#endif /* _ASTERISK_RES_AUDIOSOCKET_H */
|