mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-05 20:20:07 +00:00
a0b7a49a4a
This adds support for stasis/sounds and stasis/sounds/{ID} queries via
the Asterisk RESTful Interface (ARI, formerly Stasis-HTTP).
The following changes have been made to accomplish this:
* A modular indexer was created for local media.
* A new function to get an ast_format associated with a file extension
was added.
* Modifications were made to the built-in HTTP server so that URI
decoding could be deferred to the URI handler when necessary.
* The Stasis-HTTP sounds JSON documentation was modified to handle
cases where multiple languages are installed in different formats.
* Register and Unregister events for formats were added to the system
topic.
(closes issue ASTERISK-21584)
(closes issue ASTERISK-21585)
Review: https://reviewboard.asterisk.org/r/2507/
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@392700 65c4cc65-6c06-0410-ace0-fbb531ad65f3
109 lines
3.1 KiB
C
109 lines
3.1 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 2013, Digium, Inc.
|
|
*
|
|
* Kinsey Moore <kmoore@digium.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 Media file format and description indexing engine.
|
|
*/
|
|
|
|
#ifndef _ASTERISK_MEDIA_INDEX_H
|
|
#define _ASTERISK_MEDIA_INDEX_H
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct ast_format_cap;
|
|
|
|
/*!
|
|
* \brief Object representing a media index
|
|
*/
|
|
struct ast_media_index;
|
|
|
|
/*!
|
|
* \brief Creates a new media index
|
|
*
|
|
* \param base_dir Base directory for indexing
|
|
*
|
|
* \retval NULL on error
|
|
* \retval A new AO2 refcounted media index
|
|
*/
|
|
struct ast_media_index *ast_media_index_create(
|
|
const char *base_dir);
|
|
|
|
/*!
|
|
* \brief Get the description for a media file
|
|
*
|
|
* \param index Media index in which to query information
|
|
* \param filename Name of the file for which to get the description
|
|
* \param variant Media variant for which to get the description
|
|
*
|
|
* \retval NULL if not found
|
|
* \return The description requested (must be copied to be kept)
|
|
*/
|
|
const char *ast_media_get_description(struct ast_media_index *index, const char *filename, const char *variant);
|
|
|
|
/*!
|
|
* \brief Get the ast_format_cap for a media file
|
|
*
|
|
* \param index Media index in which to query information
|
|
* \param filename Name of the file for which to get the description
|
|
* \param variant Media variant for which to get the description
|
|
*
|
|
* \retval NULL if not found
|
|
* \return a copy of the format capabilities (must be destroyed with ast_format_cap_destroy)
|
|
*/
|
|
struct ast_format_cap *ast_media_get_format_cap(struct ast_media_index *index, const char *filename, const char *variant);
|
|
|
|
/*!
|
|
* \brief Get the languages in which a media file is available
|
|
*
|
|
* \param index Media index in which to query information
|
|
* \param filename Name of the file for which to get available languages
|
|
*
|
|
* \retval NULL on error
|
|
* \return an ast_str_container filled with language strings
|
|
*/
|
|
struct ao2_container *ast_media_get_variants(struct ast_media_index *index, const char *filename);
|
|
|
|
/*!
|
|
* \brief Get the a container of all media available on the system
|
|
*
|
|
* \param index Media index in which to query information
|
|
*
|
|
* \retval NULL on error
|
|
* \return an ast_str_container filled with media file name strings
|
|
*/
|
|
struct ao2_container *ast_media_get_media(struct ast_media_index *index);
|
|
|
|
/*!
|
|
* \brief Update a media index
|
|
*
|
|
* \param index Media index in which to query information
|
|
* \param variant Media variant for which to get the description
|
|
*
|
|
* \retval non-zero on error
|
|
* \return zero on success
|
|
*/
|
|
int ast_media_index_update(struct ast_media_index *index,
|
|
const char *variant);
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif /* _ASTERISK_MEDIA_INDEX_H */
|