README

此包帮助您通过Mohammad Najafian连接到微软面部API。

安装

使用Composer安装

 composer require ikosar/lmfa

之后

 php artisan vendor:publish

配置

在Laravel根目录的配置文件夹中打开lmfa.php，然后您可以在此文件中输入您的api_key！

用法

普通请求（返回您面部的信息）

1. 首先，我们需要做这个 💯

 $face = new CheckFace();

2. 我们设置URL

如果您想自定义URL，请这样做 💯：（默认：https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect）

  $face->setUrl($url);

3. 还设置请求类型（post，get，delete，put）💯

到这一步，我们设置了请求的类型（仅小写）

  $face->setMethod("post");

4. 设置头部 💯

我们必须设置头部以使用微软的面部API（仅小写）

如果您想在头部或参数中放置API密钥，请使用此方法

  $face->getApiKey();

  $face->setHeaders(array(
     'Content-Type' => 'application/json',
     'Ocp-Apim-Subscription-Key' => $face->getApiKey(),
  ));

5. 设置参数 💯

到这一步，我们可以设置参数

  $face->setParameters(array(
      'returnFaceId' => 'true', // Recommended : True 
      'returnFaceLandmarks' => 'false', // Very information about face sizes
      'returnFaceAttributes' => 'age,gender,glasses,smile,noise,hair,accessories,emotion,makeup', // Your Requsted info
  ));

您可以在参数中的returnFaceAttributes中设置这些，一些面部属性：年龄、性别、眼镜、微笑、噪音、头发、配饰、情绪、化妆...

6. 设置图片 💯

然后，我们需要设置图片：我们必须将图片URL放在数组中，如下所示。

  $image = array(
      'url' => 'http://cdn-tehran.wisgoon.com/dlir-s3/10531466806488528869.JPG',
  );
  $face->setBody($image,true); // Set Image

7. 检查请求以完成设置 💯

我们必须在$face->send()之前进行检查。

         $face->check();
         $face->send();

8. 以JSON获取面部信息 💯

这样做

         $face->check();
         $result = $face->send();
         // Now JSON in $result  
         return $result;

完成并附上示例

       $image = array(
           'url' => 'https://upload.wikimedia.org/wikipedia/commons/thumb/d/d2/Donald_Trump_August_19%2C_2015_%28cropped%29.jpg/245px-Donald_Trump_August_19%2C_2015_%28cropped%29.jpg',
       );
       $url = "http://..."; 
       $face = new CheckFace();
       $face->setUrl($url);
       $face->setImage($image);
       $face->setMethod("post");
       $face->setHeaders(array(
           'Content-Type' => 'application/json',
           'Ocp-Apim-Subscription-Key' => $face->getApiKey(),
       ));
       $face->setParameters(array(
           'returnFaceId' => 'true',
           'returnFaceLandmarks' => 'false',
           'returnFaceAttributes' => 'age,gender,glasses,smile,noise,hair,accessories,emotion,makeup',
       ));
       $face->setBody($image);
       $face->check();
       $result = $face->send();

##许可证本项目采用MIT许可证##了解微软面部API###请求类型

https://westcentralus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236

ikosar / lmfa

维护者

详细信息