resource_playbacks.c File Reference

/api-docs/playbacks.{format} implementation- Playback control resources More...

#include "asterisk.h"
#include "asterisk/stasis_app_playback.h"
#include "resource_playbacks.h"

Include dependency graph for resource_playbacks.c:

Go to the source code of this file.

Functions
void	ast_ari_playbacks_control (struct ast_variable *headers, struct ast_ari_playbacks_control_args *args, struct ast_ari_response *response)
	Control a playback.
void	ast_ari_playbacks_get (struct ast_variable *headers, struct ast_ari_playbacks_get_args *args, struct ast_ari_response *response)
	Get a playback's details.
void	ast_ari_playbacks_stop (struct ast_variable *headers, struct ast_ari_playbacks_stop_args *args, struct ast_ari_response *response)
	Stop a playback.

Detailed Description

/api-docs/playbacks.{format} implementation- Playback control resources

Author

David M. Lee, II dlee@.nosp@m.digi.nosp@m.um.co.nosp@m.m

Definition in file resource_playbacks.c.

Function Documentation

ast_ari_playbacks_control()

void ast_ari_playbacks_control	(	struct ast_variable *	headers,
		struct ast_ari_playbacks_control_args *	args,
		struct ast_ari_response *	response
	)

Control a playback.

Parameters

	headers	HTTP headers
	args	Swagger parameters
[out]	response	HTTP response

Definition at line 89 of file resource_playbacks.c.

{
    RAII_VAR(struct stasis_app_playback *, playback, NULL, ao2_cleanup);
    enum stasis_app_playback_media_operation oper;
    enum stasis_playback_oper_results res;
 
    if (!args->operation) {
        ast_ari_response_error(response, 400,
            "Bad Request", "Missing operation");
        return;
    }
    if (strcmp(args->operation, "unpause") == 0) {
        oper = STASIS_PLAYBACK_UNPAUSE;
    } else if (strcmp(args->operation, "pause") == 0) {
        oper = STASIS_PLAYBACK_PAUSE;
    } else if (strcmp(args->operation, "restart") == 0) {
        oper = STASIS_PLAYBACK_RESTART;
    } else if (strcmp(args->operation, "reverse") == 0) {
        oper = STASIS_PLAYBACK_REVERSE;
    } else if (strcmp(args->operation, "forward") == 0) {
        oper = STASIS_PLAYBACK_FORWARD;
    } else {
        ast_ari_response_error(response, 400,
            "Bad Request", "Invalid operation %s",
            args->operation);
        return;
    }
 
    playback = stasis_app_playback_find_by_id(args->playback_id);
    if (playback == NULL) {
        ast_ari_response_error(response, 404, "Not Found",
            "Playback not found");
        return;
    }
 
    res = stasis_app_playback_operation(playback, oper);
    switch (res) {
    case STASIS_PLAYBACK_OPER_OK:
        ast_ari_response_no_content(response);
        return;
    case STASIS_PLAYBACK_OPER_FAILED:
        ast_ari_response_error(response, 500,
            "Internal Server Error", "Could not %s playback",
            args->operation);
        return;
    case STASIS_PLAYBACK_OPER_NOT_PLAYING:
        ast_ari_response_error(response, 409, "Conflict",
            "Can only %s while media is playing", args->operation);
        return;
    }
}

References ao2_cleanup, args, ast_ari_response_error(), ast_ari_response_no_content(), NULL, RAII_VAR, stasis_app_playback_find_by_id(), stasis_app_playback_operation(), STASIS_PLAYBACK_FORWARD, STASIS_PLAYBACK_OPER_FAILED, STASIS_PLAYBACK_OPER_NOT_PLAYING, STASIS_PLAYBACK_OPER_OK, STASIS_PLAYBACK_PAUSE, STASIS_PLAYBACK_RESTART, STASIS_PLAYBACK_REVERSE, and STASIS_PLAYBACK_UNPAUSE.

Referenced by ast_ari_playbacks_control_cb().

ast_ari_playbacks_get()

void ast_ari_playbacks_get	(	struct ast_variable *	headers,
		struct ast_ari_playbacks_get_args *	args,
		struct ast_ari_response *	response
	)

Get a playback's details.

Parameters

	headers	HTTP headers
	args	Swagger parameters
[out]	response	HTTP response

Definition at line 35 of file resource_playbacks.c.

{
    RAII_VAR(struct stasis_app_playback *, playback, NULL, ao2_cleanup);
    struct ast_json *json;
 
    playback = stasis_app_playback_find_by_id(args->playback_id);
    if (playback == NULL) {
        ast_ari_response_error(response, 404, "Not Found",
            "Playback not found");
        return;
    }
 
    json = stasis_app_playback_to_json(playback);
    if (json == NULL) {
        ast_ari_response_error(response, 500,
            "Internal Server Error", "Error building response");
        return;
    }
 
    ast_ari_response_ok(response, json);
}

References ao2_cleanup, args, ast_ari_response_error(), ast_ari_response_ok(), NULL, RAII_VAR, stasis_app_playback_find_by_id(), and stasis_app_playback_to_json().

Referenced by ast_ari_playbacks_get_cb().

ast_ari_playbacks_stop()

void ast_ari_playbacks_stop	(	struct ast_variable *	headers,
		struct ast_ari_playbacks_stop_args *	args,
		struct ast_ari_response *	response
	)

Stop a playback.

Parameters

	headers	HTTP headers
	args	Swagger parameters
[out]	response	HTTP response

Definition at line 58 of file resource_playbacks.c.

{
    RAII_VAR(struct stasis_app_playback *, playback, NULL, ao2_cleanup);
    enum stasis_playback_oper_results res;
 
    playback = stasis_app_playback_find_by_id(args->playback_id);
    if (playback == NULL) {
        ast_ari_response_error(response, 404, "Not Found",
            "Playback not found");
        return;
    }
 
    res = stasis_app_playback_operation(playback, STASIS_PLAYBACK_STOP);
    switch (res) {
    case STASIS_PLAYBACK_OPER_OK:
        ast_ari_response_no_content(response);
        return;
    case STASIS_PLAYBACK_OPER_FAILED:
        ast_ari_response_error(response, 500,
            "Internal Server Error", "Could not stop playback");
        return;
    case STASIS_PLAYBACK_OPER_NOT_PLAYING:
        /* Stop operation should be valid even when not playing */
        ast_assert(0);
        ast_ari_response_error(response, 500,
            "Internal Server Error", "Could not stop playback");
        return;
    }
}

References ao2_cleanup, args, ast_ari_response_error(), ast_ari_response_no_content(), ast_assert, NULL, RAII_VAR, stasis_app_playback_find_by_id(), stasis_app_playback_operation(), STASIS_PLAYBACK_OPER_FAILED, STASIS_PLAYBACK_OPER_NOT_PLAYING, STASIS_PLAYBACK_OPER_OK, and STASIS_PLAYBACK_STOP.

Referenced by ast_ari_playbacks_stop_cb().