你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

PersonGroupOperations 类

定义

PersonGroupOperations 操作。

public class PersonGroupOperations : Microsoft.Azure.CognitiveServices.Vision.Face.IPersonGroupOperations, Microsoft.Rest.IServiceOperations<Microsoft.Azure.CognitiveServices.Vision.Face.FaceClient>
type PersonGroupOperations = class
    interface IServiceOperations<FaceClient>
    interface IPersonGroupOperations
Public Class PersonGroupOperations
Implements IPersonGroupOperations, IServiceOperations(Of FaceClient)
继承
PersonGroupOperations
实现

构造函数

PersonGroupOperations(FaceClient)

初始化 PersonGroupOperations 类的新实例。

属性

Client

获取对 FaceClient 的引用

方法

CreateWithHttpMessagesAsync(String, String, String, String, Dictionary<String,List<String>>, CancellationToken)

使用指定的 personGroupId、名称以及用户提供的 userData 和 recognitionModel 创建新的人员组。 <br /> 人员组是上传的人员数据的容器,包括人脸图像和人脸识别功能。 <br /> 创建后,使用 PersonGroup Person - Create 将人员添加到组中,然后调用 PersonGroup - Train 使此组准备好 进行人脸 - 识别。 <br /> 此人的人脸、图像和 userData 将存储在服务器上,直到调用 PersonGroup Person - DeletePersonGroup - Delete 。 <Br/>

  • 免费层订阅配额:1,000 人组。 每个可容纳多达1,000人。
  • S0 层订阅配额:1,000,000 人组。 每个可容纳多达10,000人。
  • 若要处理更大规模的人脸识别问题,请考虑使用 LargePersonGroup。 <应指定 br/> “recognitionModel”以与此人员组相关联。 “recognitionModel”的默认值为“recognition_01”,如果需要最新的模型,请在此参数中显式指定所需的模型。 添加到现有人员组的新人脸将使用已与集合关联的识别模型。 无法将人员组中的现有人脸特征更新为由其他版本的识别模型提取的特征。
DeleteWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)

删除现有人员组。 人员组中所有人员的持久化人脸特征也将被删除。

GetTrainingStatusWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)

检索已完成或正在进行的) (人员组的培训状态。

GetWithHttpMessagesAsync(String, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken)

检索人员组名称,userData 和 recognitionModel。 若要获取此 personGroup 下的人员信息,请使用 PersonGroup Person - List

ListWithHttpMessagesAsync(String, Nullable<Int32>, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken)

列出人员组的 personGroupId、name、userData 和 recognitionModel。<Br/>

  • 人员组按 personGroupId 的字母顺序存储。
  • “start”参数 (字符串,可选) 是用户提供的 personGroupId 值,通过字符串比较返回的条目具有较大的 ID。 “start”设置为空,表示从第一个项返回。
  • “top”参数 (int,可选) 指定要返回的条目数。 在一次调用中可以返回最大 1000 个条目。 若要获取更多内容,可以使用当前调用的最后一个重新优化条目的 ID 指定“start”。 <br /> 例如,总共 5 个人组:“group1”, ..., “group5”。 <br /> “start=&top=” 将返回所有 5 个组。 <br /> “start=&top=2”将返回“group1”、“group2”。 <br /> “start=group2&top=3”将返回“group3”、“group4”、“group5”。
TrainWithHttpMessagesAsync(String, Dictionary<String,List<String>>, CancellationToken)

将人员组训练任务排队,训练任务可能不会立即启动。

UpdateWithHttpMessagesAsync(String, String, String, Dictionary<String,List<String>>, CancellationToken)

更新现有人员组的显示名称和 userData。 不会更新请求正文中未显示的属性。

扩展方法

CreateAsync(IPersonGroupOperations, String, String, String, String, CancellationToken)

使用指定的 personGroupId、名称以及用户提供的 userData 和 recognitionModel 创建新的人员组。 <br /> 人员组是上传的人员数据的容器,包括人脸图像和人脸识别功能。 <br /> 创建后,使用 PersonGroup Person - Create 将人员添加到组中,然后调用 PersonGroup - Train 使此组准备好 进行人脸 - 识别。 <br /> 此人的人脸、图像和 userData 将存储在服务器上,直到调用 PersonGroup Person - DeletePersonGroup - Delete 。 <Br/>

  • 免费层订阅配额:1,000 人组。 每个可容纳多达1,000人。
  • S0 层订阅配额:1,000,000 人组。 每个可容纳多达10,000人。
  • 若要处理更大规模的人脸识别问题,请考虑使用 LargePersonGroup。 <应指定 br/> “recognitionModel”以与此人员组相关联。 “recognitionModel”的默认值为“recognition_01”,如果需要最新的模型,请在此参数中显式指定所需的模型。 添加到现有人员组的新人脸将使用已与集合关联的识别模型。 无法将人员组中的现有人脸特征更新为由其他版本的识别模型提取的特征。
DeleteAsync(IPersonGroupOperations, String, CancellationToken)

删除现有人员组。 人员组中所有人员的持久化人脸特征也将被删除。

GetAsync(IPersonGroupOperations, String, Nullable<Boolean>, CancellationToken)

检索人员组名称,userData 和 recognitionModel。 若要获取此 personGroup 下的人员信息,请使用 PersonGroup Person - List

GetTrainingStatusAsync(IPersonGroupOperations, String, CancellationToken)

检索已完成或正在进行的) (人员组的培训状态。

ListAsync(IPersonGroupOperations, String, Nullable<Int32>, Nullable<Boolean>, CancellationToken)

列出人员组的 personGroupId、name、userData 和 recognitionModel。<Br/>

  • 人员组按 personGroupId 的字母顺序存储。
  • “start”参数 (字符串,可选) 是用户提供的 personGroupId 值,通过字符串比较返回的条目具有较大的 ID。 “start”设置为空,表示从第一个项返回。
  • “top”参数 (int,可选) 指定要返回的条目数。 在一次调用中可以返回最大 1000 个条目。 若要获取更多内容,可以使用当前调用的最后一个重新优化条目的 ID 指定“start”。 <br /> 例如,总共 5 个人组:“group1”, ..., “group5”。 <br /> “start=&top=” 将返回所有 5 个组。 <br /> “start=&top=2”将返回“group1”、“group2”。 <br /> “start=group2&top=3”将返回“group3”、“group4”、“group5”。
TrainAsync(IPersonGroupOperations, String, CancellationToken)

将人员组训练任务排队,训练任务可能不会立即启动。

UpdateAsync(IPersonGroupOperations, String, String, String, CancellationToken)

更新现有人员组的显示名称和 userData。 不会更新请求正文中未显示的属性。

适用于