diff options
-rw-r--r-- | include/asterisk/stasis_app.h | 10 | ||||
-rw-r--r-- | res/ari/resource_channels.c | 16 | ||||
-rw-r--r-- | res/ari/resource_channels.h | 13 | ||||
-rw-r--r-- | res/res_ari_channels.c | 59 | ||||
-rw-r--r-- | res/stasis/control.c | 15 | ||||
-rw-r--r-- | rest-api/api-docs/channels.json | 26 |
6 files changed, 139 insertions, 0 deletions
diff --git a/include/asterisk/stasis_app.h b/include/asterisk/stasis_app.h index 8b1f4563a..0f4ca27a9 100644 --- a/include/asterisk/stasis_app.h +++ b/include/asterisk/stasis_app.h @@ -284,6 +284,16 @@ int stasis_app_control_continue(struct stasis_app_control *control, const char * int stasis_app_control_ring(struct stasis_app_control *control); /*! + * \brief Stop locally generated ringing on the channel associated with this control. + * + * \param control Control for \c res_stasis. + * + * \return 0 for success. + * \return -1 for error. + */ +int stasis_app_control_ring_stop(struct stasis_app_control *control); + +/*! * \brief Send DTMF to the channel associated with this control. * * \param control Control for \c res_stasis. diff --git a/res/ari/resource_channels.c b/res/ari/resource_channels.c index 2b09a3281..2ddfae1c5 100644 --- a/res/ari/resource_channels.c +++ b/res/ari/resource_channels.c @@ -140,6 +140,22 @@ void ast_ari_channels_ring(struct ast_variable *headers, ast_ari_response_no_content(response); } +void ast_ari_channels_ring_stop(struct ast_variable *headers, + struct ast_ari_channels_ring_stop_args *args, + struct ast_ari_response *response) +{ + RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup); + + control = find_control(response, args->channel_id); + if (control == NULL) { + return; + } + + stasis_app_control_ring_stop(control); + + ast_ari_response_no_content(response); +} + void ast_ari_channels_mute(struct ast_variable *headers, struct ast_ari_channels_mute_args *args, struct ast_ari_response *response) diff --git a/res/ari/resource_channels.h b/res/ari/resource_channels.h index 089f3fa7a..6106b0061 100644 --- a/res/ari/resource_channels.h +++ b/res/ari/resource_channels.h @@ -152,6 +152,19 @@ struct ast_ari_channels_ring_args { * \param[out] response HTTP response */ void ast_ari_channels_ring(struct ast_variable *headers, struct ast_ari_channels_ring_args *args, struct ast_ari_response *response); +/*! \brief Argument struct for ast_ari_channels_ring_stop() */ +struct ast_ari_channels_ring_stop_args { + /*! \brief Channel's id */ + const char *channel_id; +}; +/*! + * \brief Stop ringing indication on a channel if locally generated. + * + * \param headers HTTP headers + * \param args Swagger parameters + * \param[out] response HTTP response + */ +void ast_ari_channels_ring_stop(struct ast_variable *headers, struct ast_ari_channels_ring_stop_args *args, struct ast_ari_response *response); /*! \brief Argument struct for ast_ari_channels_send_dtmf() */ struct ast_ari_channels_send_dtmf_args { /*! \brief Channel's id */ diff --git a/res/res_ari_channels.c b/res/res_ari_channels.c index 82cb1740f..6f2005e61 100644 --- a/res/res_ari_channels.c +++ b/res/res_ari_channels.c @@ -486,6 +486,64 @@ fin: __attribute__((unused)) return; } /*! + * \brief Parameter parsing callback for /channels/{channelId}/ring. + * \param get_params GET parameters in the HTTP request. + * \param path_vars Path variables extracted from the request. + * \param headers HTTP headers. + * \param[out] response Response to the HTTP request. + */ +static void ast_ari_channels_ring_stop_cb( + struct ast_variable *get_params, struct ast_variable *path_vars, + struct ast_variable *headers, struct ast_ari_response *response) +{ + struct ast_ari_channels_ring_stop_args args = {}; + struct ast_variable *i; +#if defined(AST_DEVMODE) + int is_valid; + int code; +#endif /* AST_DEVMODE */ + + for (i = path_vars; i; i = i->next) { + if (strcmp(i->name, "channelId") == 0) { + args.channel_id = (i->value); + } else + {} + } + ast_ari_channels_ring_stop(headers, &args, response); +#if defined(AST_DEVMODE) + code = response->response_code; + + switch (code) { + case 0: /* Implementation is still a stub, or the code wasn't set */ + is_valid = response->message == NULL; + break; + case 500: /* Internal Server Error */ + case 501: /* Not Implemented */ + case 404: /* Channel not found */ + case 409: /* Channel not in a Stasis application */ + is_valid = 1; + break; + default: + if (200 <= code && code <= 299) { + is_valid = ast_ari_validate_void( + response->message); + } else { + ast_log(LOG_ERROR, "Invalid error response %d for /channels/{channelId}/ring\n", code); + is_valid = 0; + } + } + + if (!is_valid) { + ast_log(LOG_ERROR, "Response validation failed for /channels/{channelId}/ring\n"); + ast_ari_response_error(response, 500, + "Internal Server Error", "Response validation failed"); + } +#endif /* AST_DEVMODE */ + +fin: __attribute__((unused)) + return; +} +/*! * \brief Parameter parsing callback for /channels/{channelId}/dtmf. * \param get_params GET parameters in the HTTP request. * \param path_vars Path variables extracted from the request. @@ -1242,6 +1300,7 @@ static struct stasis_rest_handlers channels_channelId_ring = { .path_segment = "ring", .callbacks = { [AST_HTTP_POST] = ast_ari_channels_ring_cb, + [AST_HTTP_DELETE] = ast_ari_channels_ring_stop_cb, }, .num_children = 0, .children = { } diff --git a/res/stasis/control.c b/res/stasis/control.c index 6c61df061..868aff5ea 100644 --- a/res/stasis/control.c +++ b/res/stasis/control.c @@ -341,6 +341,21 @@ int stasis_app_control_ring(struct stasis_app_control *control) return 0; } +static void *app_control_ring_stop(struct stasis_app_control *control, + struct ast_channel *chan, void *data) +{ + ast_indicate(control->channel, -1); + + return NULL; +} + +int stasis_app_control_ring_stop(struct stasis_app_control *control) +{ + stasis_app_send_command_async(control, app_control_ring_stop, NULL); + + return 0; +} + struct stasis_app_control_mute_data { enum ast_frame_type frametype; unsigned int direction; diff --git a/rest-api/api-docs/channels.json b/rest-api/api-docs/channels.json index d3ed5194d..dd611ccaa 100644 --- a/rest-api/api-docs/channels.json +++ b/rest-api/api-docs/channels.json @@ -287,6 +287,32 @@ "reason": "Channel not in a Stasis application" } ] + }, + { + "httpMethod": "DELETE", + "summary": "Stop ringing indication on a channel if locally generated.", + "nickname": "ringStop", + "responseClass": "void", + "parameters": [ + { + "name": "channelId", + "description": "Channel's id", + "paramType": "path", + "required": true, + "allowMultiple": false, + "dataType": "string" + } + ], + "errorResponses": [ + { + "code": 404, + "reason": "Channel not found" + }, + { + "code": 409, + "reason": "Channel not in a Stasis application" + } + ] } ] }, |