ac-dc/face

维护者

详细信息

github.com/ac-dc/face

源代码

v2.0.1 2021-12-23 10:49 UTC

This package is auto-updated.

Last update: 2024-09-23 17:12:26 UTC


README

目录

  1. 安装
  2. 配置
  3. 如何使用
    1. 检测API
    2. 相册
      1. 创建
      2. 更新
      3. 删除
      4. 获取所有相册
      5. 获取一个相册
      6. 将人脸添加到相册
      7. 从相册中移除人脸
    3. 搜索
    4. 获取一个人脸
  4. 许可证
  5. 安全

安装

要获取最新版本,需要使用composer的项目

composer require eduardostuart/face

一旦安装,您需要在您的 config/app.php 中注册 Face Service provider

return [
    // ....
    Face\FaceServiceProvider::class,
]

并在 config/app.php 中添加 Face Facade。

return [
    // ....
    'Face' => Face\Facades\Face::class,
]

配置

要开始使用 Laravel Face,您需要发布 Face 配置文件。

php artisan vendor:publish --provider="Face\FaceServiceProvider"

您还需要为应用程序使用的服务添加凭据(或自定义设置)。这些信息应放在 config/face.php 文件中。

如何使用

检测

检测和分析人脸。

// ...
use Face;

$results = Face::detect('https://.../photo.jpg');

相册

创建相册

// ...
use Face;

$album = Face::createAlbum("my album name", [
    "face-id-1", "face-id-2", 
]);

// $album->getName();
// $album->getTags();
// $album->getFaces();
// $album->toJson();
// $album->toArray();

删除相册

// ...
use Face;

if(Face::removeAlbum("album-id")){
    echo "OK!";
}

更新相册

// ...
use Face;

$albumUpdated = Face::updateAlbum("album-id", "new album name");

获取所有相册

// ...
use Face;

$albums = Face::albums();
print_r($albums->toArray());

获取一个相册

// ...
use Face;

$album = Face::album("album-id");
echo $album->getName();

将人脸添加到相册

// ...
use Face;

if(Face::addIntoAlbum("album-id", ["face-1-id","face-2-id"])){
    echo "Added!";
}

从相册中移除人脸

// ...
use Face;

if(Face::removeFaceFromAlbum("album-id", ["face-1-id","face-2-id"])){
    echo "Removed!";
}

搜索

找到一个或多个相似的人脸。

// ...
use Face;

$albumId = '1234';

$result = Face::search($albumId, 'https://.../photo.jpg');

// $result->getTotal();
// $result->getResults();

获取一个人脸

// ...
use Face;

$result = Face::getFace('face-id');

// $result->getAttributes();
// $result->getId();
// $result->getReference();

提供者

许可证

Face 是一个开源软件,受 MIT 许可证 许可

安全

如果您在此软件包中发现安全漏洞,请发送电子邮件至 Eduardo Stuart,地址为 hi@s.tuart.me。所有安全漏洞都将得到及时处理。