README

PhpKairos 是 Kairos 人脸识别 API 的优秀客户端

状态：稳定 请 报告任何您发现的错误，以便我们可以为每个人改进库。

需求

• PHP 版本 >= 5.5

安装

PhpKairos 的主要公共仓库托管在 https://github.com/ympons/PhpKairos.git。

要安装库的最新版本，只需键入

git clone https://github.com/ympons/PhpKairos.git

指定您希望文件存放的位置。

如果您尚未全局安装，您必须下载 composer。只需在 PhpKairos 目录中运行此命令。

php -r "readfile('https://getcomposer.org.cn/installer');" | php

现在获取与 PhpKairos 一起工作的所需库

php composer.phar --no-dev install

注意

如果您已经安装了 composer 或者您的现有项目使用它，您可以通过 Composer https://packagist.org.cn/packages/ympons/phpkairos 安装/添加 PhpKairos，它与这个 GitHub 仓库链接（因此它总是更新），并将其作为依赖项添加到您的项目中。

php composer.phar require "ympons/phpkairos:dev-master" --update-no-dev

使用

PhpKairos 指定自动加载信息，Composer 生成一个 vendor/autoload.php 文件。您可以简单地包含此文件，您将获得免费的自动加载，并使用完全限定名称声明 PhpKairos 客户端的用法。

require "vendor/autoload.php";
use PhpKairos\PhpKairos;

客户端初始化

$api     = 'http://api.kairos.com/';
$app_id  = 'your_app_id';
$app_key = 'your_app_key';
$client = new PhpKairos( $api, $app_id, $app_key );

注册一张图片

图像参数必须是公开可访问的 URL 或 Base64 编码的照片

$image        = 'http://media.kairos.com/kairos-elizabeth.jpg';
$subject_id   = 'subject1';
$gallery_name = 'gallerytest1';
$options      = [
  'selector' => 'SETPOSE',
  'symmetricFill' => true
];

$response = $client->enroll($image, $subject_id, $gallery_name, $options);
$result   = $response->getBody()->getContents();

识别一张图片

图像参数必须是公开可访问的 URL 或 Base64 编码的照片

$image        = 'http://media.kairos.com/kairos-elizabeth.jpg';
$gallery_name = 'gallerytest1';

$response = $client->recognize($image, $gallery_name);
$result   = $response->getBody()->getContents();

检测图像属性

图像参数必须是公开可访问的 URL 或 Base64 编码的照片

$encodedImage = 'iVBORw0KGgoAAA ... ABJRU5ErkJggg==\r\n';

$response = $client->detect($encodedImage);
$result   = $response->getBody()->getContents();

列出相册

列出您创建的所有相册

$response = $client->listGalleries();
$result   = $response->getBody()->getContents();

查看相册

列出相册中注册的所有主题

$gallery_name = 'gallerytest1';

$response = $client->viewGallery($gallery_name);
$result   = $response->getBody()->getContents();

删除相册

$gallery_name = 'gallerytest1';

$response = $client->removeGallery($gallery_name);
$result   = $response->getBody()->getContents();

删除主题

删除您在相册中注册的主题

$subject_id   = 'subject1';
$gallery_name = 'gallerytest1';

$response = $client->removeSubject($subject_id, $gallery_name);
$result   = $response->getBody()->getContents();

许可证

MIT 许可证，见 LICENSE.md。