作者 | 哈猪猪
在文章1中我们计划用 HTTPClient 组件帮助我们与服务器通信，上传录音文件并接收识别结果，最终实现云语音识别。经过测试后没有问题，因此接下来我们需要理解该组件提供的功能，并实现文件对服务器的上传。
首先，根据 HTTPClient 组件的示例程序 http_examples.c，我们得知了一个完整的 HTTP 请求需要调用的接口流程，大致如下。以 POST 请求为例，并直接设置 url 而非 host&path：
http_client_config_t config = {
.url = "http://httpbin.org/get",
.event_handler = _http_event_handler,
};
http_client_handle_t client = http_client_init(&config);
​
const char *post_data = "field1=value1&field2=value2";
http_client_set_method(client, HTTP_METHOD_POST);
http_client_set_post_field(client, post_data, strlen(post_data));
err = http_client_perform(client);
if (err == HTTP_CLI_OK) {
LOGI(TAG, "HTTP POST Status = %d, content_length = %d \r\n",
http_client_get_status_code(client),
http_client_get_content_length(client));
} else {
LOGE(TAG, "HTTP POST request failed: 0x%x @#@@@@@@", (err));
e_count ++;
}
整个过程主要涉及以下功能：
[En]
The whole process mainly involves the following functions:
http_client_init() 主要是基于 config 对 client 结构的各种变量赋初值，包括在请求中会用的到的各种缓存空间，以及 header 中的基本信息。其中 config 未设置的会赋缺省值。也可以用库提供的各种 set_xxx 函数来对变量赋值。
http_client_set_post_field()：对于有请求体的 POST，我们需要调用这个函数将发送数据的指针以及长度赋予 client：
web_err_t http_client_set_post_field(http_client_handle_t client, const char *data, int len)
{
web_err_t err = WEB_OK;
client->post_data = (char *)data; // 待发送数据指针
client->post_len = len; // 待发送数据长度
LOGD(TAG, "set post file length = %d", len);
// 如果此前没有设置 Content-Type，则设置为 application/x-www-form-urlencoded
if (client->post_data)
{
char *value = NULL;
if ((err = http_client_get_header(client, "Content-Type", &value)) != WEB_OK)
{
return err;
}
if (value == NULL)
{
err = http_client_set_header(client, "Content-Type", "application/x-www-form-urlencoded");
}
}
else
{
client->post_len = 0;
err = http_client_set_header(client, "Content-Type", NULL);
}
return err;
}
阅读源码可见，库默认支持”Content-Type”为”application/x-www-form-urlencoded”的 POST 请求，而我们要上传音频文件是”multipart/form-data”类型的。然而浏览了整个 HTTPClient 组件发现它就支持这一种类型……POST 的具体实现也只支持这一种。我们接着往下看就知道了……
http_client_perform()：无论是什么 HTTP 请求，在设置完 client 之后最后都是经由这一个函数来具体实现。该函数将根据当前所处的 HTTP 请求流程，调用对应的函数，而这些函数最终会调用 transport 组件即在传输层上读写，最终实现整个 HTTP 请求。http_client_perform() 依次主要调用了以下几个函数：
http_client_prepare();
http_client_connect();
http_client_request_send();
http_client_send_post_data();
http_client_fetch_headers();
http_check_response();
http_client_get_data();
http_client_close();
实现的功能与其函数名一致，也是我们熟知的 HTTP 请求流程。其中我们最关心的当然是http_client_send_post_data()：
static web_err_t http_client_send_post_data(http_client_handle_t client)
{
// 此时请求头应发送完毕
if (client->state != HTTP_STATE_REQ_COMPLETE_HEADER)
{
LOGE(TAG, "Invalid state");
return WEB_ERR_INVALID_STATE;
}
// 没有要发送的 post_data 直接返回（包括其它请求）
if (!(client->post_data && client->post_len))
{
goto success;
}
​
// 发送 post_data
int wret = http_client_write(client, client->post_data + client->data_written_index, client->data_write_left);
if (wret < 0)
{
return wret;
}
// 在 request send 里面 data_write_left 最后被赋值为 post_len
client->data_write_left -= wret;
// 在 request send 里面 data_written_index 最后被赋值为 0
client->data_written_index += wret;
​
// 发送完毕
if (client->data_write_left <= 0) { goto success; } else return err_http_write_data; success: 更新状态 client->state = HTTP_STATE_REQ_COMPLETE_DATA;
return WEB_OK;
}</=>
可见，整个 POST 实现只会发送一次 post_data，它指向我们最初在 http_client_set_post_field() 中填入的待发送数据。然而，我们知道要发送”multipart/form-data”类型的数据，需要按照格式用 boundary 对请求体进行封装，并在请求头中提前告知 boundary。当然，HTTPClient 组件是没有实现这些的……因此如果我们要利用 HTTPClient 发送音频数据，就必须手动实现”multipart/form-data”类型请求体的封装与发送。
当我终于大致理解了 HTTPClient 组件后，我在浏览 YOC 源码时发现了一个就叫”http”的组件，它并没有出现在 YOC 文档里然而它已经实现了”multipart/form-data”类型的 POST……囿于我技术水平有限，源码缺少注释，感觉学习成本过高，遂放弃。
事实上针对本项目要实现的云语音识别，YOC 还有很多更适合的组件：麦克风服务，云音交互(AUI Cloud)……甚至后者本身就是为语音识别等应用构建的。然而由于源码没有注释，只有接口介绍文档，以及其它板子上的相关例程，感觉”移植”组件对自己难度过大，最终都没有使用，选择了基于 HTTPClient 手动实现音频数据的发送。
欢迎关注公众号： 芯片开放社区（ID：OCC_THEAD），查看更多应用实战文章。
Original: https://blog.csdn.net/OCC_THEAD/article/details/123706836
Author: 平头哥芯片开放社区
Title: 【平头哥RVB2601开发板试用体验】基于 HTTPClient 的云语音识别 2
原创文章受到原创版权保护。转载请注明出处：https://www.johngo689.com/497994/
转载文章受原作者版权保护。转载请注明原作者出处！