Microsoft Face API: iOS 客户端库 & 示例
此代码库包含 Microsoft Face API 的 iOS 客户端库和示例，它是微软 Cognitive Services 的一部分，以前称为 Project Oxford。
客户端库
通过 CocoaPods 使用 iOS 客户端库是最简单的方式。要通过 Cocoapods 安装
- 安装 Cocoapods - 按照入门指南安装 Cocoapods。
- 在 Podfile 中添加以下内容：
pod 'ProjectOxfordFace'。 - 运行
pod install命令以安装最新的 ProjectOxfordFace pod。 - 将
#import <ProjectOxfordFace/MPOFaceSDK.h>添加到所有需要引用 SDK 的文件中。
示例
示例应用程序演示了 Microsoft Face API iOS 客户端库的使用。示例展示了面部检测、面部验证和面部分组等场景。
需求
iOS 版本必须为 8.1 或更高。
构建和运行示例
示例应用程序应已附带所需的 Pods。在 Xcode 中打开 ProjectOxfordFace.xcworkspace 并进行构建。
- 首先，您必须根据网站上的说明获取 Face API 订阅密钥。点击此处。
- 然后，在 Xcode 的示例子目录下，找到文件
MPOAppDelegate.h并插入 Face API 的订阅密钥。 - 要运行示例应用程序，请确保 Xcode 左上角的目标选择为
ProjectOxfordFace-Example，然后选择播放按钮或在菜单栏选择产品 > 运行。 - 应用程序启动后，点击按钮尝试不同的场景。
Microsoft 将接收您上传的图片，并可能使用它们来改进 Face API 和相关服务。通过提交图片，您确认您已从图片中的所有人获得同意。
遇到问题？
- 请确保您已选择
ProjectOxfordFace-Example作为目标。 - 请确保您已在
MPOTestConstants.h中包含订阅密钥。 - 请确保您已在 Xcode 中打开
.xcworkspace文件，而不是.xcodeproj文件。 - 请确保您已使用正确的
部署团队配置文件。 - 请确保您正在运行 iOS 8.1 或更高版本。
运行和探索单元测试
演示各种 Microsoft 认知服务场景的单元测试，如检测、识别、分组、相似度、验证和面孔列表，位于 Example/Tests。
要运行单元测试，首先在 MPOTestConstants.h 中插入您的订阅密钥，然后在 Xcode 中选择测试导航窗格以显示所有可运行的测试。
贡献
我们欢迎您的贡献。随时在存储库中提交问题和拉取请求，我们会尽力解决。了解更多关于如何帮助我们的信息，请参阅我们的贡献规则与指南。
您可以通过以下社区使用提问和建议与我们联系
- 支持问题： StackOverflow
- 反馈及功能请求： Cognitive 服务用户之声论坛
本项目已采用Microsoft 开源行为准则。有关更多信息，请参阅行为准则常见问题解答或与[email protected]联系，以了解任何其他问题或意见。
更新
许可协议
所有 Microsoft Cognitive Services SDK 和示例均采用 MIT 许可协议。有关详细信息，请参阅 LICENSE。
样本图片的许可协议另单独说明，请参阅 LICENSE-IMAGE。
开发者行为准则
使用认知服务的开发者，包括此客户端库和示例，应遵循 Microsoft Cognitive Services 的“开发者行为准则”，可在http://go.microsoft.com/fwlink/?LinkId=698895找到。