Merge "test_res_rtp: Enable FIR and REMB nominal tests."
[asterisk/asterisk.git] / res / ari / resource_bridges.h
index 404760c..0d0286c 100644 (file)
@@ -39,7 +39,7 @@
 
 #include "asterisk/ari.h"
 
-/*! \brief Argument struct for ast_ari_bridges_list() */
+/*! Argument struct for ast_ari_bridges_list() */
 struct ast_ari_bridges_list_args {
 };
 /*!
@@ -50,13 +50,13 @@ struct ast_ari_bridges_list_args {
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_list(struct ast_variable *headers, struct ast_ari_bridges_list_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_create() */
+/*! Argument struct for ast_ari_bridges_create() */
 struct ast_ari_bridges_create_args {
-       /*! \brief Comma separated list of bridge type attributes (mixing, holding, dtmf_events, proxy_media). */
+       /*! Comma separated list of bridge type attributes (mixing, holding, dtmf_events, proxy_media, video_sfu). */
        const char *type;
-       /*! \brief Unique ID to give to the bridge being created. */
+       /*! Unique ID to give to the bridge being created. */
        const char *bridge_id;
-       /*! \brief Name to give to the bridge being created. */
+       /*! Name to give to the bridge being created. */
        const char *name;
 };
 /*!
@@ -80,13 +80,13 @@ int ast_ari_bridges_create_parse_body(
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_create(struct ast_variable *headers, struct ast_ari_bridges_create_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_create_or_update_with_id() */
-struct ast_ari_bridges_create_or_update_with_id_args {
-       /*! \brief Comma separated list of bridge type attributes (mixing, holding, dtmf_events, proxy_media) to set. */
+/*! Argument struct for ast_ari_bridges_create_with_id() */
+struct ast_ari_bridges_create_with_id_args {
+       /*! Comma separated list of bridge type attributes (mixing, holding, dtmf_events, proxy_media, video_sfu) to set. */
        const char *type;
-       /*! \brief Unique ID to give to the bridge being created. */
+       /*! Unique ID to give to the bridge being created. */
        const char *bridge_id;
-       /*! \brief Set the name of the bridge. */
+       /*! Set the name of the bridge. */
        const char *name;
 };
 /*!
@@ -96,9 +96,9 @@ struct ast_ari_bridges_create_or_update_with_id_args {
  * \retval zero on success
  * \retval non-zero on failure
  */
-int ast_ari_bridges_create_or_update_with_id_parse_body(
+int ast_ari_bridges_create_with_id_parse_body(
        struct ast_json *body,
-       struct ast_ari_bridges_create_or_update_with_id_args *args);
+       struct ast_ari_bridges_create_with_id_args *args);
 
 /*!
  * \brief Create a new bridge or updates an existing one.
@@ -109,10 +109,10 @@ int ast_ari_bridges_create_or_update_with_id_parse_body(
  * \param args Swagger parameters
  * \param[out] response HTTP response
  */
-void ast_ari_bridges_create_or_update_with_id(struct ast_variable *headers, struct ast_ari_bridges_create_or_update_with_id_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_get() */
+void ast_ari_bridges_create_with_id(struct ast_variable *headers, struct ast_ari_bridges_create_with_id_args *args, struct ast_ari_response *response);
+/*! Argument struct for ast_ari_bridges_get() */
 struct ast_ari_bridges_get_args {
-       /*! \brief Bridge's id */
+       /*! Bridge's id */
        const char *bridge_id;
 };
 /*!
@@ -123,9 +123,9 @@ struct ast_ari_bridges_get_args {
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_get(struct ast_variable *headers, struct ast_ari_bridges_get_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_destroy() */
+/*! Argument struct for ast_ari_bridges_destroy() */
 struct ast_ari_bridges_destroy_args {
-       /*! \brief Bridge's id */
+       /*! Bridge's id */
        const char *bridge_id;
 };
 /*!
@@ -138,18 +138,22 @@ struct ast_ari_bridges_destroy_args {
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_destroy(struct ast_variable *headers, struct ast_ari_bridges_destroy_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_add_channel() */
+/*! Argument struct for ast_ari_bridges_add_channel() */
 struct ast_ari_bridges_add_channel_args {
-       /*! \brief Bridge's id */
+       /*! Bridge's id */
        const char *bridge_id;
-       /*! \brief Array of Ids of channels to add to bridge */
+       /*! Array of Ids of channels to add to bridge */
        const char **channel;
-       /*! \brief Length of channel array. */
+       /*! Length of channel array. */
        size_t channel_count;
-       /*! \brief Parsing context for channel. */
+       /*! Parsing context for channel. */
        char *channel_parse;
-       /*! \brief Channel's role in the bridge */
+       /*! Channel's role in the bridge */
        const char *role;
+       /*! Absorb DTMF coming from this channel, preventing it to pass through to the bridge */
+       int absorb_dtmf;
+       /*! Mute audio from this channel, preventing it to pass through to the bridge */
+       int mute;
 };
 /*!
  * \brief Body parsing function for /bridges/{bridgeId}/addChannel.
@@ -170,15 +174,15 @@ int ast_ari_bridges_add_channel_parse_body(
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_add_channel(struct ast_variable *headers, struct ast_ari_bridges_add_channel_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_remove_channel() */
+/*! Argument struct for ast_ari_bridges_remove_channel() */
 struct ast_ari_bridges_remove_channel_args {
-       /*! \brief Bridge's id */
+       /*! Bridge's id */
        const char *bridge_id;
-       /*! \brief Array of Ids of channels to remove from bridge */
+       /*! Array of Ids of channels to remove from bridge */
        const char **channel;
-       /*! \brief Length of channel array. */
+       /*! Length of channel array. */
        size_t channel_count;
-       /*! \brief Parsing context for channel. */
+       /*! Parsing context for channel. */
        char *channel_parse;
 };
 /*!
@@ -200,11 +204,39 @@ int ast_ari_bridges_remove_channel_parse_body(
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_remove_channel(struct ast_variable *headers, struct ast_ari_bridges_remove_channel_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_start_moh() */
+/*! Argument struct for ast_ari_bridges_set_video_source() */
+struct ast_ari_bridges_set_video_source_args {
+       /*! Bridge's id */
+       const char *bridge_id;
+       /*! Channel's id */
+       const char *channel_id;
+};
+/*!
+ * \brief Set a channel as the video source in a multi-party mixing bridge. This operation has no effect on bridges with two or fewer participants.
+ *
+ * \param headers HTTP headers
+ * \param args Swagger parameters
+ * \param[out] response HTTP response
+ */
+void ast_ari_bridges_set_video_source(struct ast_variable *headers, struct ast_ari_bridges_set_video_source_args *args, struct ast_ari_response *response);
+/*! Argument struct for ast_ari_bridges_clear_video_source() */
+struct ast_ari_bridges_clear_video_source_args {
+       /*! Bridge's id */
+       const char *bridge_id;
+};
+/*!
+ * \brief Removes any explicit video source in a multi-party mixing bridge. This operation has no effect on bridges with two or fewer participants. When no explicit video source is set, talk detection will be used to determine the active video stream.
+ *
+ * \param headers HTTP headers
+ * \param args Swagger parameters
+ * \param[out] response HTTP response
+ */
+void ast_ari_bridges_clear_video_source(struct ast_variable *headers, struct ast_ari_bridges_clear_video_source_args *args, struct ast_ari_response *response);
+/*! Argument struct for ast_ari_bridges_start_moh() */
 struct ast_ari_bridges_start_moh_args {
-       /*! \brief Bridge's id */
+       /*! Bridge's id */
        const char *bridge_id;
-       /*! \brief Channel's id */
+       /*! Channel's id */
        const char *moh_class;
 };
 /*!
@@ -226,9 +258,9 @@ int ast_ari_bridges_start_moh_parse_body(
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_start_moh(struct ast_variable *headers, struct ast_ari_bridges_start_moh_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_stop_moh() */
+/*! Argument struct for ast_ari_bridges_stop_moh() */
 struct ast_ari_bridges_stop_moh_args {
-       /*! \brief Bridge's id */
+       /*! Bridge's id */
        const char *bridge_id;
 };
 /*!
@@ -241,18 +273,24 @@ struct ast_ari_bridges_stop_moh_args {
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_stop_moh(struct ast_variable *headers, struct ast_ari_bridges_stop_moh_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_play() */
+/*! Argument struct for ast_ari_bridges_play() */
 struct ast_ari_bridges_play_args {
-       /*! \brief Bridge's id */
+       /*! Bridge's id */
        const char *bridge_id;
-       /*! \brief Media's URI to play. */
-       const char *media;
-       /*! \brief For sounds, selects language for sound. */
+       /*! Array of Media URIs to play. */
+       const char **media;
+       /*! Length of media array. */
+       size_t media_count;
+       /*! Parsing context for media. */
+       char *media_parse;
+       /*! For sounds, selects language for sound. */
        const char *lang;
-       /*! \brief Number of media to skip before playing. */
+       /*! Number of milliseconds to skip before playing. Only applies to the first URI if multiple media URIs are specified. */
        int offsetms;
-       /*! \brief Number of milliseconds to skip for forward/reverse operations. */
+       /*! Number of milliseconds to skip for forward/reverse operations. */
        int skipms;
+       /*! Playback Id. */
+       const char *playback_id;
 };
 /*!
  * \brief Body parsing function for /bridges/{bridgeId}/play.
@@ -275,23 +313,63 @@ int ast_ari_bridges_play_parse_body(
  * \param[out] response HTTP response
  */
 void ast_ari_bridges_play(struct ast_variable *headers, struct ast_ari_bridges_play_args *args, struct ast_ari_response *response);
-/*! \brief Argument struct for ast_ari_bridges_record() */
+/*! Argument struct for ast_ari_bridges_play_with_id() */
+struct ast_ari_bridges_play_with_id_args {
+       /*! Bridge's id */
+       const char *bridge_id;
+       /*! Playback ID. */
+       const char *playback_id;
+       /*! Array of Media URIs to play. */
+       const char **media;
+       /*! Length of media array. */
+       size_t media_count;
+       /*! Parsing context for media. */
+       char *media_parse;
+       /*! For sounds, selects language for sound. */
+       const char *lang;
+       /*! Number of milliseconds to skip before playing. Only applies to the first URI if multiple media URIs are specified. */
+       int offsetms;
+       /*! Number of milliseconds to skip for forward/reverse operations. */
+       int skipms;
+};
+/*!
+ * \brief Body parsing function for /bridges/{bridgeId}/play/{playbackId}.
+ * \param body The JSON body from which to parse parameters.
+ * \param[out] args The args structure to parse into.
+ * \retval zero on success
+ * \retval non-zero on failure
+ */
+int ast_ari_bridges_play_with_id_parse_body(
+       struct ast_json *body,
+       struct ast_ari_bridges_play_with_id_args *args);
+
+/*!
+ * \brief Start playback of media on a bridge.
+ *
+ * The media URI may be any of a number of URI's. Currently sound:, recording:, number:, digits:, characters:, and tone: URI's are supported. This operation creates a playback resource that can be used to control the playback of media (pause, rewind, fast forward, etc.)
+ *
+ * \param headers HTTP headers
+ * \param args Swagger parameters
+ * \param[out] response HTTP response
+ */
+void ast_ari_bridges_play_with_id(struct ast_variable *headers, struct ast_ari_bridges_play_with_id_args *args, struct ast_ari_response *response);
+/*! Argument struct for ast_ari_bridges_record() */
 struct ast_ari_bridges_record_args {
-       /*! \brief Bridge's id */
+       /*! Bridge's id */
        const char *bridge_id;
-       /*! \brief Recording's filename */
+       /*! Recording's filename */
        const char *name;
-       /*! \brief Format to encode audio in */
+       /*! Format to encode audio in */
        const char *format;
-       /*! \brief Maximum duration of the recording, in seconds. 0 for no limit. */
+       /*! Maximum duration of the recording, in seconds. 0 for no limit. */
        int max_duration_seconds;
-       /*! \brief Maximum duration of silence, in seconds. 0 for no limit. */
+       /*! Maximum duration of silence, in seconds. 0 for no limit. */
        int max_silence_seconds;
-       /*! \brief Action to take if a recording with the same name already exists. */
+       /*! Action to take if a recording with the same name already exists. */
        const char *if_exists;
-       /*! \brief Play beep when recording begins */
+       /*! Play beep when recording begins */
        int beep;
-       /*! \brief DTMF input to terminate recording. */
+       /*! DTMF input to terminate recording. */
        const char *terminate_on;
 };
 /*!