前言
AWS Rekognition 是一款免费的面部识别和分析服务，允许开发者以简单且经济实惠的方式向应用程序添加功能，以识别和分析图像中的面部、场景和物体。而 @aws-sdk/client-rekognition 则是 AWS 的官方 JavaScript SDK，可用于在前端中调用 Rekognition 的 API。本文将详细介绍如何使用这个 npm 包。
前置条件
- AWS 账户
- Node.js
安装
使用 npm 安装 @aws-sdk/client-rekognition。
npm install @aws-sdk/client-rekognition
使用
1. 引入库
const {
RekognitionClient,
DetectFacesCommand,
SearchFacesByImageCommand,
CreateCollectionCommand,
IndexFacesCommand,
} = require("@aws-sdk/client-rekognition");在这里，我们引入了 Rekognition 的客户端、检测脸部的命令、根据图像搜索人脸的命令、创建集合的命令和人脸索引的命令。
2. 创建客户端
const client = new RekognitionClient({
region: "your-region",
credentials: {
accessKeyId: "your-access-key-id",
secretAccessKey: "your-secret-access-key",
},
});这里创建了一个 Rekognition 客户端，需要传入 AWS 所在的区域和你的凭证信息。
3. 检测人脸
-- -------------------- ---- -------
----- ------ - -
------ -
--------- -
------- -----------------
----- ---------------------
--
--
----------- --------
--
----- ------- - --- ---------------------------
----- ------ - ----- ---------------------这段代码检测 S3 存储桶中的图像，并返回图像中检测到的所有人脸及其相关属性。其中，params 中包含了图像所在的 S3 存储桶和对象的键，Attributes 则表示想要检测什么属性，比如 "ALL" 表示检测所有可用属性。result 即为检测结果。
4. 搜索人脸
-- -------------------- ---- -------
----- ------ - -
------------- ---------------------
------ -
--------- -
------- -----------------
----- ---------------------
--
--
--------- ---
------------------- ---
--
----- ------- - --- ----------------------------------
----- ------ - ----- ---------------------这段代码在指定的人脸集合中搜索与给定图像相似的脸，并返回最相似的人脸及其相关信息。其中，params 包含了要搜索的人脸集合 ID、图像所在的 S3 存储桶和对象的键、最多返回的脸数以及阈值。result 即为搜索结果。
5. 创建人脸集合
const params = {
CollectionId: "your-collection-id",
};
const command = new CreateCollectionCommand(params);
const result = await client.send(command);这段代码创建一个人脸集合，其中 params 包含集合 ID。result 即为创建结果。
6. 将人脸添加到集合中
-- -------------------- ---- -------
----- ------ - -
------------- ---------------------
---------------- -------------------------
------ -
--------- -
------- -----------------
----- ---------------------
--
--
--
----- ------- - --- --------------------------
----- ------ - ----- ---------------------这段代码将图像中的人脸添加到指定集合中。其中，params 包含要添加到的集合 ID，外部图像 ID 和图像所在的 S3 存储桶和对象键。result 即为添加结果。
示例代码
下面是一个完整的示例代码。
-- -------------------- ---- -------
----- -
------------------
-------------------
--------------------------
------------------------
------------------
- - ---------------------------------------
----- ------ - --- -------------------
------- --------------
------------ -
------------ ---------------------
---------------- -------------------------
--
---
----- -------- ------------- -
----- ------ - -
------ -
--------- -
------- -----------------
----- ---------------------
--
--
----------- --------
--
----- ------- - --- ---------------------------
----- ------ - ----- ---------------------
--------------------
-
----- -------- -------------------- -
----- ------ - -
------------- ---------------------
------ -
--------- -
------- -----------------
----- ---------------------
--
--
--------- ---
------------------- ---
--
----- ------- - --- ----------------------------------
----- ------ - ----- ---------------------
--------------------
-
----- -------- ------------------ -
----- ------ - -
------------- ---------------------
--
----- ------- - --- --------------------------------
----- ------ - ----- ---------------------
--------------------
-
----- -------- ------------ -
----- ------ - -
------------- ---------------------
---------------- -------------------------
------ -
--------- -
------- -----------------
----- ---------------------
--
--
--
----- ------- - --- --------------------------
----- ------ - ----- ---------------------
--------------------
-
--------------
---------------------
-------------------
-------------总结
本文详细介绍了如何使用 @aws-sdk/client-rekognition 这个 npm 包来调用 AWS Rekognition 的 API。希望读者能够通过本文学到如何在前端使用 AWS 的服务，并且能够应用到实际项目中。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5f6f483ba9b7065299ccba63