基于ESP32-S3方案的2.1寸旋钮屏ZX2D10来了，同步分享ESP32应用功能技术之「WEB API接口」

启明智显基于ESP32-S3与国产芯高效开发平台8ms设计开发的一款磁编码结构的旋钮屏。结构紧凑、简单，外观精致；支持WIFI、蓝牙，语音交互等功能。

产品说明：

1. 使用乐鑫 ESP32-S3 WI-FI SOC 芯片， SOC 提供 WI-FI 与 BLE 连接能力。

2. 屏幕采用 2.1 寸 480*480 分辨率的圆形 IPS 显示器

3. 内置 16MByte Flash 用与构建众多页面

4. 旋钮采用霍尔编码器

5. 支持使用 8ms UI 快速搭建平台

应用领域：

智能家电：智能家居、家用净水器、智能马桶、按摩椅、微波炉、咖啡机、毛巾烘干机、油烟机、空气净化

器、热水器、筋膜枪等

商业设备：数字功放一体机、温度控制器、智能考勤机、点钞机、商业烤箱、自动贩卖机、 3D 打印机等

储能设备：移动电源、智能换电柜、新能源充电桩等

 

ESP32 应用功能技术之「 WEB API 接口」

ESP32作为 Wi-Fi SOC 芯片，承载着物联网属性。在物联网开发中， WEB API 是获取内容服务的主要方式，通过 WEB API接口，可以在互联网上获取相当之多的内容。无论是地图服务还是语音识别，都可以通过 WEB API 接口实现。

 

什么是 API ？

API （ Application Programming Interface ，应用程序接口）是一些预先定义的函数，或指软件系统不同组成部分衔接的约定。 用来提供应用程序与开发人员基于某软件或硬件得以访问的一组例程，而又无需访问原码，或 理解内部工作机制的细节。

API 是指应用程序编程接口。 API 是连接不同计算机应用程序的应用程序。

服务器应用程序连接客户端和数据库以相互通信。通过从数据库中读取数据，它将标准响应发送给客户端。这样的应用程序称为API 。

API 通常被视为专门用于 HTTP 协议的概念。但这不是真的。 API 是一个通用概念。连接不同计算机应用程序的任 何事物都可以称为API 。您可以基于任何其他协议（例如 SMTP ， FTP ， AMQ ，网络套接字等）创建 API 。

Web API ， Web 服务 API ， JSON API 以及更多其他的名称？

API 的命名没有严格的限制，有几种通用名称表示 HTTP API 。根据上下文，公司对 HTTP API 使用不同的命名。边界很窄，并且都具有相同的含义，并且在HTTP API 之上几乎没有任何规范。例如， JSON API 表示 HTTP API ，它发送JSON 作为默认响应格式。

Web API 是网络应用程序接口。包含了广泛的功能，网络应用通过 API 接口，可以实现存储服务、消息服务、计算服务等能力，利用这些能力可以进行开发出强大功能的web 应用。

什么是 Web API ？

官方定义如下，强调两个关键点，即可以对接各种客户端（浏览器，移动设备），构建 http 服务的框架。

ASP.NET Web API is a framework that makes it easy to build HTTP services that reach a broad range of clients, including browsers and mobile devices. ASP.NET Web API is an ideal platform for building RESTful applications on the .NET Framework.

Web API 可以使用任何类型的通信协议，数据交互格式为 XML 以及 JSON 。

Web API 的主要功能

1. 支持基于 Http verb (GET, POST, PUT, DELETE) 的 CRUD (create, retrieve, update, delete) 操作

    通过不同的 http 动作表达不同的含义，这样就不需要暴露多个 API 来支持这些基本操作。

2. 请求的回复通过 Http Status Code 表达不同含义，并且客户端可以通过 Accept header 来与服务器协商格式，例

如你希望服务器返回 JSON 格式还是 XML 格式。

3. 请求的回复格式支持 JSON ， XML ，并且可以扩展添加其他格式。

针对 ESP32 的 WEB API 访问（基于 HTTP 请求）

 

ESP32 的 WEB API 基本是基于 HTTP 请求来实现

以百度的在线的语音识别功能，一般 WEB API 请求调用流程

1. 创建账号及应用： 在 ai.baidu.com 控制台中，创建应用，勾选开通 ” 语音技术 “-” 短语音识别、短语音识别极速版“ 能力。获取 AppID 、 API Key 、 Secret Key ，并通过请求鉴权接口换取 token ，详细见 “ 接入指南” 。

2. 创建识别请求： POST 方式，音频可通过 JSON 和 RAW 两种方式提交。 JSON 方式音频数据由于 base64 编码，数据会增大1/3 。其他填写具体请求参数 。

3. 短语音识别请求地址：  http://vop.baidu.com/server_api

4. 返回识别结果：识别结果会即刻返回，采用 JSON 格式封装，如果识别成功，识别结果放在 JSON 的 “result” 字段中，统一采用 utf-8 方式编码。