microsoft / cognitive-face-dotnetcore

.NET Core SDK for the Microsoft Face API, part of Cognitive Services

⚠️ This repository has been archived. Please visit the Face QuickStart to get started with the latest Face SDKs. ⚠️

Face API: .NET Core Client Library & Sample

Branch	Build Status
develop
master

Overview

This repo contains the .NET Core client library and sample for the Microsoft Face API, an offering within Microsoft Cognitive Services, formerly known as Project Oxford.

• Learn about the Face API
• Read the documentation
• Find more SDKs & Samples

Before you can use the SDK or run the sample application you must subscribe to the Face API which is part of Microsoft Cognitive Services. You can learn how to subscribe here.

The Client Library

The client library is a thin .NET Core client wrapper for the Face API. The easiest way to use this client library is to get the microsoft.projectxoford.face.dotnetcore package from nuget. Please go to the .NET Core Face API Package in Nuget for more details.

Contributing

Contributions are welcome. 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.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

License

All Microsoft Cognitive Services SDKs and samples are licensed with the MIT License. For more details, see LICENSE.

Developer Code of Conduct

Developers using this project are expected to follow the “Developer Code of Conduct for Microsoft Cognitive Services” at http://go.microsoft.com/fwlink/?LinkId=698895.

Disclaimer

The image, voice, video or text understanding capabilities of Microsoft.ProjectOxford.Face.DotNetCore use Microsoft Cognitive Services. Microsoft will receive the images, audio, video, and other data that you upload (via this app) for service improvement purposes.

Report Abuse

To report abuse of the Microsoft Cognitive Services to Microsoft, please visit the Microsoft Cognitive Services website at https://www.microsoft.com/cognitive-services, and use the "Report Abuse" link at the bottom of the page to contact Microsoft.

Privacy Policy

For more information about Microsoft privacy policies please see their privacy statement here: https://go.microsoft.com/fwlink/?LinkId=521839.

cognitive-face-dotnetcore's Issues

FaceAPIException does not set Message

https://github.com/Microsoft/Cognitive-Face-DotNetCore/blob/master/ClientLibrary/FaceAPIException.cs#L59-L64

The constructors for this exception don't set Exception.Message, so when you log exceptions, you don't get any useful details:
Microsoft.ProjectOxford.Face.FaceAPIException: Exception of type 'Microsoft.ProjectOxford.Face.FaceAPIException' was thrown.

Probably just doing a :base(errorMessage) would be enough?

Cannot get FaceAttributes from Face object

I'm trying to get face attributes like age and gender from Face object but it throws a NullReferenceException on this line. As you can see, FaceAttributes property is null.