asterisk/res/res_aeap/message_json.c
Kevin Harwell 272bac70dd res_aeap & res_speech_aeap: Add Asterisk External Application Protocol
Add framework to connect to, and read and write protocol based
messages from and to an external application using an Asterisk
External Application Protocol (AEAP). This has been divided into
several abstractions:

 1. transport - base communication layer (currently websocket only)
 2. message - AEAP description and data (currently JSON only)
 3. transaction - links/binds requests and responses
 4. aeap - transport, message, and transaction handler/manager

This patch also adds an AEAP implementation for speech to text.
Existing speech API callbacks for speech to text have been completed
making it possible for Asterisk to connect to a configured external
translator service and provide audio for STT. Results can also be
received from the external translator, and made available as speech
results in Asterisk.

Unit tests have also been created that test the AEAP framework, and
also the speech to text implementation.

ASTERISK-29726 #close

Change-Id: Iaa4b259f84aa63501e5fd2a6fb107f900b4d4ed2
2022-04-26 14:26:48 -05:00

192 lines
4.7 KiB
C

/*
* Asterisk -- An open source telephony toolkit.
*
* Copyright (C) 2021, Sangoma Technologies Corporation
*
* Kevin Harwell <kharwell@sangoma.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.
*/
#include "asterisk.h"
#include "asterisk/json.h"
#include "asterisk/res_aeap_message.h"
#define JSON_MSG(lvalue, rvalue) struct message_json *lvalue = \
((struct message_json *)rvalue)
/*!
* \brief Asterisk external application JSON message type
*/
struct message_json {
/*! The base message type (must be first) */
struct ast_aeap_message base;
/*! Underlying JSON data structure */
struct ast_json *json;
};
static int message_json_construct1(struct ast_aeap_message *self, const void *params)
{
JSON_MSG(msg, self);
msg->json = ast_json_ref((struct ast_json *)params) ?: ast_json_object_create();
return msg->json ? 0 : -1;
}
static int message_json_construct2(struct ast_aeap_message *self, const char *msg_type,
const char *name, const char *id, const void *params)
{
struct ast_json *msg_data;
int res;
msg_data = ast_json_pack("{s:s,s:s*}", msg_type, name, "id", id);
if (!msg_data) {
ast_log(LOG_ERROR, "AEAP message json: failed to create data for '%s: %s'", msg_type, name);
return -1;
}
if (params && ast_json_object_update(msg_data, (struct ast_json *)params)) {
ast_log(LOG_ERROR, "AEAP message json: failed to update data for '%s: %s'", msg_type, name);
ast_json_unref(msg_data);
return -1;
}
res = message_json_construct1(self, msg_data);
ast_json_unref(msg_data);
return res;
}
static void message_json_destruct(struct ast_aeap_message *self)
{
JSON_MSG(msg, self);
ast_json_unref(msg->json);
}
static int message_json_deserialize(struct ast_aeap_message *self, const void *buf, intmax_t size)
{
JSON_MSG(msg, self);
msg->json = ast_json_load_buf(buf, size, NULL);
return msg->json ? 0 : -1;
}
static int message_json_serialize(const struct ast_aeap_message *self, void **buf, intmax_t *size)
{
const JSON_MSG(msg, self);
*buf = ast_json_dump_string(msg->json);
if (!*buf) {
*size = 0;
return -1;
}
*size = strlen(*buf);
return 0;
}
static const char *message_json_id(const struct ast_aeap_message *self)
{
const JSON_MSG(msg, self);
return ast_json_object_string_get(msg->json, "id");
}
static int message_json_id_set(struct ast_aeap_message *self, const char *id)
{
JSON_MSG(msg, self);
if (ast_json_object_set(msg->json, "id", ast_json_string_create(id))) {
return -1;
}
return 0;
}
static const char *message_json_name(const struct ast_aeap_message *self)
{
const JSON_MSG(msg, self);
struct ast_json_iter *iter;
iter = ast_json_object_iter_at(msg->json, "response");
if (!iter) {
iter = ast_json_object_iter_at(msg->json, "request");
}
return iter ? ast_json_string_get(ast_json_object_iter_value(iter)) : "";
}
static void *message_json_data(struct ast_aeap_message *self)
{
JSON_MSG(msg, self);
return msg->json;
}
static int message_json_is_request(const struct ast_aeap_message *self)
{
const JSON_MSG(msg, self);
return ast_json_object_iter_at(msg->json, "request") != NULL;
}
static int message_json_is_response(const struct ast_aeap_message *self)
{
const JSON_MSG(msg, self);
return ast_json_object_iter_at(msg->json, "response") != NULL;
}
static const char *message_json_error_msg(const struct ast_aeap_message *self)
{
const JSON_MSG(msg, self);
return ast_json_object_string_get(msg->json, "error_msg");
}
static int message_json_error_msg_set(struct ast_aeap_message *self, const char *error_msg)
{
JSON_MSG(msg, self);
if (ast_json_object_set(msg->json, "error_msg", ast_json_string_create(error_msg))) {
return -1;
}
return 0;
}
static const struct ast_aeap_message_type message_type_json = {
.type_size = sizeof(struct message_json),
.type_name = "json",
.serial_type = AST_AEAP_DATA_TYPE_STRING,
.construct1 = message_json_construct1,
.construct2 = message_json_construct2,
.destruct = message_json_destruct,
.deserialize = message_json_deserialize,
.serialize = message_json_serialize,
.id = message_json_id,
.id_set = message_json_id_set,
.name = message_json_name,
.data = message_json_data,
.is_request = message_json_is_request,
.is_response = message_json_is_response,
.error_msg = message_json_error_msg,
.error_msg_set = message_json_error_msg_set,
};
const struct ast_aeap_message_type *ast_aeap_message_type_json = &message_type_json;