Wrapper class to detect faces from http://face.com, you will need an API key and API Secret which you can get in developer.face.com.
This controller implements a custom object called FWObject where you can set properties to find in the image.
You can search faces using REST or POST service and you can receive JSON or XML response but you always get a NSDictionary with all data, you don't have to parse the raw response.
Dependencies: This projects uses FBGraph to connect Facebook and SBJSON
You can analyze images from the web or local images, but always as JPG files.
- Added multiple POST images, FWImage has a property tag returned on delegate method, tag property on failure or REST request has -1 value.
- Added recognition for images on REST/POST for Facebook accounts
- Added photo training
- Added Twitter/Facebook authentication
- Added status account management
- Added framework support (you MUST install https://github.com/kstenerud/iOS-Universal-Framework for framework templates)
//Define your API from faces.com --> http://developers.face.com/account/
[FWKeysHelper setFaceAPI:@"YOUR_FACE_API_KEY"];
[FWKeysHelper setFaceSecretAPI:@"YOUR_FACE_API_SECRET_KEY"];
//Define your Facebook Tokens at https://developers.facebook.com and set them in your face.com account
[FWKeysHelper setFacebookAppID:@"YOUR_FACEBOOK_APPLICATION_ID"];
//Define your xAuth Tokens at developer.twitter.com and set them in your face.com account
[FWKeysHelper setTwitterConsumerKey:@"YOUR_TWITTER_CONSUMER_KEY"];
[FWKeysHelper setTwitterConsumerSecret:@"YOUR_TWITTER_CONSUMER_SECRET"];
//Images must be ALWAYS JPG
FWObject *object = [FWObject new];
//REST
NSMutableArray *urlImages = [NSMutableArray new];
NSURL *urlImage = [NSURL URLWithString:@"http://images.wikia.com/powerrangers/images/f/fe/ActorJohnCho_John_Shea_55027822.jpg"];
[urlImages addImageToArray:urlImage];
[object setUrls:urlImages];
object.isRESTObject = YES;
//END REST
/*
//POST
UIImage *image = [UIImage imageNamed:@"girls.jpg"];
NSMutableArray *images = [[NSMutableArray alloc] init];
FWImage *fwImage = [[FWImage alloc] initWithData:UIImageJPEGRepresentation(image, 1.0)
imageName:@"girls"
extension:@"jpg"
andFullPath:@""];
fwImage.tag = 999;
[images addImagePOSTToArray:fwImage];
[object setPostImages:images];
object.isRESTObject = NO;
//END POST
*/
object.wantRecognition = NO;
[object setDetector:DETECTOR_TYPE_DEFAULT];
[object setFormat:FORMAT_TYPE_JSON];
NSMutableArray *attr = [NSMutableArray new];
[attr addAttributeToArray:ATTRIBUTE_GENDER];
[attr addAttributeToArray:ATTRIBUTE_GLASSES];
[attr addAttributeToArray:ATTRIBUTE_SMILING];
[object setAttributes:attr];
[object setCallback:@""];
[object setCallback_url:nil];
FWObject *recognition = [FWObject objectWithObject:object];
recognition.wantRecognition = YES;
recognition.accountNamespace = @"";
recognition.useFacebook = YES;
//recognition.twitter_username = @"";
//recognition.twitter_password = @"";
NSMutableArray *uidsArray = [NSMutableArray new];
[uidsArray addUIDsToArray:@"friends@facebook.com"]; //only for facebook authentication
//[uidsArray addUIDsToArray:@"xxxx@twitter.com"]; //only for twitter authentication
recognition.uids = uidsArray;
FWImageController *controller = [[FWImageController alloc] initWithNibName:@"FWImageController" bundle:nil];
controller.objects = [NSArray arrayWithObjects:object, recognition, nil];
controller.delegate = self;
[self presentModalViewController:controller animated:YES];
FWObject *statusObject = [FWObject objectWithObject:recognition];
//WARNING SLOW OPERATION!!!
//if (!recognition.isRESTObject)
[[FaceWrapper instance] statusFaceWithFWObject:statusObject delegate:self]; //POST ONLY
//FWObject *trainObject = [FWObject objectWithObject:recognition];
//trainObject.callback_url = [NSURL URLWithString:@"http://www.facebook.com/connect/login_success.html"]; //dummy callback URL
//WARNING SLOW OPERATION!!!
//[[FaceWrapper instance] trainFaceWithFWObject:trainObject delegate:self runInBackground:NO];
On delegate method you will receive the response for detection or recognition:
- (void)controllerDidFindFaceItemWithObject:(NSDictionary *)faces postImageTag:(int)tag
{
ParseObject *parsed = [[ParseObject alloc] initWithRawDictionary:faces];
[parsed loopOverFaces:^(NSDictionary *face) {
NSLog(@"FACE: %@", face);
}];
}
Also, you should implement FaceWrapperDelegate to make train or status operations:
On training operations you MUST provide a callback URL due to slowness operation.
//Train method [[FaceWrapper instance] statusFaceWithFWObject:statusObject delegate:self]; //POST ONLY //Status method [[FaceWrapper instance] trainFaceWithFWObject:trainObject delegate:self runInBackground:NO];
#pragma mark -
#pragma mark FaceWrapperDelegate methods
- (void)faceWrapperTrainFaceSuccess:(NSDictionary *)faceData photoTag:(int)tag
{
NSLog(@"TRAIN: %@", faceData);
}
- (void)faceWrapperStatusFacing:(NSDictionary *)faceData photoTag:(int)tag
{
NSLog(@"STATUS: %@", faceData);
}
Use detection method just to place squares on photo's faces:
[[FaceWrapper instance] detectFaceWithFWObject:object
runInBackground:NO
completionData:^(NSDictionary *response, int tagImagePost) {
//Detection response and tag of the image
}];
Facebook.get service how-to:
FBGetterObject *fbObject = [[FBGetterObject alloc] initWithFWObject:recognition];
uidsArray = [NSMutableArray new];
[uidsArray addUIDsToArray:@"xxxxxxx@facebook.com"];
fbObject.uids = uidsArray;
fbObject.format = FORMAT_TYPE_JSON;
fbObject.limit = 10;
fbObject.callback_url = nil;
fbObject.attributes = [NSArray arrayWithObjects:[FBGetterManager objectFromFBAttribute:FBATTRIBUTE_GENDER_FEMALE], [FBGetterManager objectFromFBAttribute:FBATTRIBUTE_GLASSES_TRUE], [FBGetterManager objectFromFBAttribute:FBATTRIBUTE_PITCH_CENTER], [FBGetterManager objectFromFBAttribute:FBATTRIBUTE_ROLL_RANGE], [FBGetterManager objectFromFBAttribute:FBATTRIBUTE_YAW_CENTER], nil];
fbObject.rollRange = CGPointMake(40.0, 150.0);
[FBGetterManager requestForFacebookWithObject:fbObject completionBlock:^(NSDictionary *dictionary) {
NSLog(@"FBDICTIONARY: %@", dictionary);
}];
Actually, FaceWrapper has tags.save, tags.remove and tags.add, see the following example:
//DOC URL: http://developers.face.com/docs/api/tags-save/
FWObject *taggerObject = [FWObject objectWithObject:object];
taggerObject.tagUID = @"YOUR_TAG_UID";
taggerObject.tagLabel = @"YOUR_TAG_LABEL";
taggerObject.tagUID = @"YOUR_TAG_UID";
taggerObject.callback = @"";
taggerObject.password = @"YOUR_PASSWORD"; //for use when saving tags is a privileged action in your client-side application (must be enabled in application settings)
NSMutableArray *arrayTids = [NSMutableArray new];
[arrayTids addTidToArray:0]; //example how to add tid
taggerObject.tids = arrayTids; //one or more tag ids to associate with the passed uid. The tag id is a reference field in the response of faces.detect and faces.recognize methods
[[TaggerManager sharedInstance] actionTagWithObject:taggerObject
doAction:TAG_ACTION_SAVE
blockCompletion:^(NSDictionary *data) {
NSLog(@"%@", data);
}];
[[TaggerManager sharedInstance] actionTagWithObject:taggerObject
doAction:TAG_ACTION_REMOVE
blockCompletion:^(NSDictionary *data) {
NSLog(@"%@", data);
}];
//DOC URL: http://developers.face.com/docs/api/tags-add/
taggerObject.tagURL = @"YOUR_TAG_URL";
taggerObject.tagX = 0;
taggerObject.tagY = 0;
taggerObject.tagWidth = 0;
taggerObject.tagUID = @"YOUR_TAG_UID";
taggerObject.taggerID = @"YOUR_TAGGER_ID";
taggerObject.tagLabel = @"YOUR_LABEL";
taggerObject.callback = @"";
taggerObject.password = @"YOUR_PASSWORD";
[[TaggerManager sharedInstance] addTagWithObject:object blockCompletion:^(NSDictionary *data) {
NSLog(@"%@", data);
}];
FaceWrapper project now turns to framework (but also single files support), the new framework tries to reach an easy way to integrate with face.com services.
Just drag WrapperFace.embeddedframework to your protect folder, select WrapperFace.framework from your project [BUILD PHASES] -> [LINK BINARY WITH LIBRARIES] -> [BUTTON "+"].
On your build setting into "Other linker Flags" add -ObjC and -all_load.
Import framework as:
#import <WrapperFace/FWImageController.h> #import <WrapperFace/FWKeysHelper.h>
- faces.detect
- faces.recognize
- faces.group
- faces.train
- faces.status
- account.users
- account.limits/.spaces
- facebook.get
- tags.save
- tags.remove
- tags.add
Follow me on twitter : http://twitter.com/#!/sergimtzlosa