@azure/cognitiveservices-face

中文文档
5.0.0发布于 2021/12/01MITTypeScriptESM + CJS近 30 天下载 6097

FaceClient Library with typescript type definitions for node.js and browser.

此软件包已被标记为弃用

This package has been deprecated. For more information, please see: https://learn.microsoft.com/azure/ai-services/face/overview-identity

原始使用文档
文档目录5 节
  1. An isomorphic javascript sdk for - FaceClient
  2. Currently supported environments
  3. How to Install
  4. How to use
  5. Related projects

An isomorphic javascript sdk for - FaceClient

This package contains an isomorphic SDK for FaceClient.

Currently supported environments

How to Install

npm install @azure/cognitiveservices-face

How to use

nodejs - Authentication, client creation and list personGroupPerson as an example written in TypeScript.

Install @azure/ms-rest-azure-js
npm install @azure/ms-rest-azure-js
Sample code

The following sample detects the facial features on the given image. To know more, refer to the Azure Documentation on Face APIs

const { FaceClient, FaceModels } = require("@azure/cognitiveservices-face");
const { CognitiveServicesCredentials } = require("@azure/ms-rest-azure-js");

async function main() {
  const faceKey = process.env["faceKey"] || "<faceKey>";
  const faceEndPoint = process.env["faceEndPoint"] || "<faceEndPoint>";
  const cognitiveServiceCredentials = new CognitiveServicesCredentials(faceKey);
  const client = new FaceClient(cognitiveServiceCredentials, faceEndPoint);
  const url =
    "https://pbs.twimg.com/profile_images/3354326900/3a5168f2b45c07d0965098be1a4e3007.jpeg";
  const options = {
    returnFaceLandmarks: true
  };
  client.face
    .detectWithUrl(url, options)
    .then(result => {
      console.log("The result is: ");
      console.log(result);
    })
    .catch(err => {
      console.log("An error occurred:");
      console.error(err);
    });
}

main();

browser - Authentication, client creation and list personGroupPerson as an example written in JavaScript.

Sample code
  • index.html
<!DOCTYPE html>
<html lang="en">
  <head>
    <title>@azure/cognitiveservices-face sample</title>
    <script src="node_modules/@azure/ms-rest-js/dist/msRest.browser.js"></script>
    <script src="node_modules/@azure/cognitiveservices-face/dist/cognitiveservices-face.js"></script>
    <script type="text/javascript">
      const faceKey = "<YOUR_FACE_KEY>";
      const faceEndPoint = "<YOUR_FACE_ENDPOINT>";
      const cognitiveServiceCredentials = new msRest.ApiKeyCredentials({
        inHeader: {
          "Ocp-Apim-Subscription-Key": faceKey
        }
      });
      const client = new Azure.CognitiveservicesFace.FaceClient(
        cognitiveServiceCredentials,
        faceEndPoint
      );

      const url =
        "https://pbs.twimg.com/profile_images/3354326900/3a5168f2b45c07d0965098be1a4e3007.jpeg";
      const options = {
        returnFaceLandmarks: true
      };
      client.face
        .detectWithUrl(url, options)
        .then(result => {
          console.log("The result is: ");
          console.log(result);
        })
        .catch(err => {
          console.log("An error occurred:");
          console.error(err);
        });
    </script>
  </head>
  <body></body>
</html>

Impressions

版本与发布记录

@azure/cognitiveservices-face 共发布 9 个版本,首次发布于 2018/11/15;过去 12 个月发布了 0 个版本。

版本发布日期距今
5.0.0latest2021/12/014 年前
4.2.02021/03/165 年前
4.1.02020/07/256 年前
4.0.02019/09/127 年前
3.1.02019/06/127 年前
3.0.02019/03/307 年前

关于 @azure/cognitiveservices-face 的常见问题

@azure/cognitiveservices-face 是什么?

FaceClient Library with typescript type definitions for node.js and browser.注意:该包已被作者标记为弃用——This package has been deprecated. For more information, please see: https://learn.microsoft.com/azure/ai-services/face/overview-identity

如何安装 @azure/cognitiveservices-face?

在项目目录运行 npm install @azure/cognitiveservices-face,或使用 pnpm add / yarn add / bun add。

@azure/cognitiveservices-face 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@azure/cognitiveservices-face 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@azure/cognitiveservices-face 可以商用吗?

@azure/cognitiveservices-face 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@azure/cognitiveservices-face 的下载量有多少?

根据 npm 官方下载统计,@azure/cognitiveservices-face 在 2026/10/08 – 2026/11/06 这 30 天内被下载 6,097 次,日均约 203 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@azure/cognitiveservices-face 还在维护吗?

最新版本 5.0.0 发布于 2021/12/01(4 年前);至今共发布 9 个版本,其中过去 12 个月发布了 0 个;首次发布于 2018/11/15。作者已将其标记为弃用,新项目建议寻找替代方案。