This repo contains the iOS client library & sample for the Microsoft Face API, an offering within Microsoft Cognitive Services, formerly known as Project Oxford.
The easiest way to consume the iOS client library is via CocoaPods. To install via Cocoapods:
pod installto install the latest ProjectOxfordFace pod.
#import <ProjectOxfordFace/MPOFaceSDK.h>to all files that need to reference the SDK.
The sample app demonstrates the use of the Microsoft Face API iOS client library. The sample shows scenarios such as face detection, face verification, and face grouping.
iOS must be version 8.1 or higher.
The sample app should already have the necessary Pods shipped with it. Open the
ProjectOxfordFace.xcworkspace in Xcode and build.
MPOAppDelegate.hand insert your subscription key for the Face API.
ProjectOxfordFace-Exampleand select the play button or select Product > Run on the menu bar.
Microsoft will receive the images you upload and may use them to improve Face API and related services. By submitting an image, you confirm you have consent from everyone in it.
ProjectOxfordFace-Exampleas the target.
.xcworkspacefile and not the
.xcodeprojfile in Xcode.
Unit tests that demonstrate various Microsoft Cognitive Services scenarios such as detection, identification, grouping, similarity, verification, and face lists are located at
To run the unit tests, first insert your subscription key in
MPOTestConstants.h and then select the test navigator pane in Xcode to display all of the tests which can be run.
We welcome contributions. Feel free to file issues and pull requests on the repo and we'll address them as we can. Learn more about how you can help on our Contribution Rules & Guidelines.
You can reach out to us anytime with questions and suggestions using our communities below:
All Microsoft Cognitive Services SDKs and samples are licensed with the MIT License. For more details, see LICENSE.
Sample images are licensed separately, please refer to LICENSE-IMAGE.
Developers using Cognitive Services, including this client library & sample, are expected to follow the “Developer Code of Conduct for Microsoft Cognitive Services”, found at http://go.microsoft.com/fwlink/?LinkId=698895.