README

This SDK is the wrapper for faceplusplus.com's API. Provides modern ways to use the API in PHP.

Install

It's very easy to install via composer

composer require nguyenvanduocit/face-sdk

Register API

This API is free to use, you can register your application at FacePlusPlus to get apiKey and apiSecretKey.

Usage

require_once '../vendor/autoload.php';
use FaceSDK\Node\RecognizedImage;
$faceAPI = new \FaceSDK\FaceSDK( 'YOUR_API', 'YOUR_API', 'http://apicn.faceplusplus.com' );
$response  = $faceAPI->post( '/detection/detect', [
	'url' => 'http://2anhdep.vn/wp-content/uploads/2014/11/anh-ngoc-trinh-dep-trong-nhung-bo-noi-y-xuyen-thau-khien-nguoi-xem-do-mat-6.jpg',
	'attribute'=>'glass,gender,age,race,smiling,glass,pose'
] );

/** @var RecognizedImage $detectedImage */
$detectedImage = $response->getRecognizedImage();
var_dump('$detectedImage', $detectedImage);

/** @var \FaceSDK\Node\RecognizedFace[] $faces */
$faces = $detectedImage->getFaces();
var_dump('$faces', $faces);

/** @var \FaceSDK\Node\RecognizedFaceAttribute $attrs */
$attrs =  $faces[0]->getAttributes();
var_dump('$attrs', $attrs);

Example

There are two example in folder example :

• face-hightlight.php : Draw a rectangle around main face, and tell if she/he is smiling
• face-recognize.php : The demo with the example code below.

TODO

• Implement all API from FacePlusPlus Doc
• Improve Exception

Contribute

Feel free to make PR

Development

This SDK was shipped with many implement and lesson from Facebook PHP SDK.