Microsoft Face API: Windows Client Library & Sample
This SDK has been deprecated and been replaced by Microsoft.Azure.CognitiveServices.Vision.Face which is a part of Azure SDK.
This repo contains the Windows client library & sample for the Microsoft Face API, an offering within Microsoft Cognitive Services, formerly known as Project Oxford.
The Client Library
The client library is a thin C# client wrapper for Microsoft Face API. The easiest way to use this client library is to get microsoft.projectoxford.face package from nuget.
Please go to Face API Package in nuget for more details.
The Sample
This sample is a Windows WPF application to demonstrate the use of Face API. It demonstrates face detection, face verification, face grouping, finding similar faces, and face identification.
Build the Sample
- Starting in the folder where you clone the repository (this folder).
- In a git command line tool, type
git submodule init(or do this through a UI). - Pull in the shared Windows code by calling
git submodule update. - Start Microsoft Visual Studio 2015 and select
File > Open > Project/Solution. - Go to
Sample-WPF Folder. - Double-click the Visual Studio 2015 Solution (.sln) file FaceAPI-WPF-Samples.
- Press Ctrl+Shift+B, or select
Build > Build Solution.
Run the Sample
After the build is complete, press F5 to run the sample.
First, you must obtain a Face API subscription key by following instructions on our website.
Locate the text edit box saying "Paste your subscription key here to start" on
the top right corner. Paste your subscription key. You can choose to persist
your subscription key in your machine by clicking "Save Key" button. When you
want to delete the subscription key from the machine, click "Delete Key" to
remove it from your machine.
Click on "Select Scenario" to use samples of different scenarios, and
follow the instructions on screen.
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.
There are sample images to be used with this sample application. You can find these images under Face > Windows > Data folder. Please note the use of these images is licensed under LICENSE-IMAGE.
Contributing
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:
- Support questions: StackOverflow
- Feedback & feature requests: Cognitive Services UserVoice Forum
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Updates
License
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.
Developer Code of Conduct
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.
