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

FaceOperations.GroupWithHttpMessagesAsync 方法

定义

根据人脸相似性将候选人脸划分为多个组。<Br/>

  • 输出是一个或多个不连续的人脸组和一个乱组。 人脸组包含外观相似的人脸,通常是同一个人。 人脸组按组大小(即人脸数量)进行排名。 请注意,属于同一人的人脸可能会在结果中拆分为多个组。
  • MessyGroup 是一个特殊的人脸组,其中包含无法从原始人脸中找到任何相似的对应人脸的人脸。 如果所有人脸都找到了对应人,则结果中不会显示 messyGroup。
  • 组 API 至少需要 2 张候选人脸,最多需要 1000 张。 建议尝试 人脸 - 验证 是否只有 2 张候选人脸。
  • 与查询人脸关联的“recognitionModel”faceIds 应相同。
public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>> GroupWithHttpMessagesAsync (System.Collections.Generic.IList<Guid> faceIds, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GroupWithHttpMessagesAsync : System.Collections.Generic.IList<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>>
override this.GroupWithHttpMessagesAsync : System.Collections.Generic.IList<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>>
Public Function GroupWithHttpMessagesAsync (faceIds As IList(Of Guid), Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of GroupResult))

参数

faceIds
IList<Guid>

人脸 - 检测创建的候选 faceId 数组。 最多 1000 张人脸

customHeaders
Dictionary<String,List<String>>

将添加到请求的标头。

cancellationToken
CancellationToken

取消标记。

返回

实现

例外

当操作返回无效状态代码时引发

无法反序列化响应时引发

当所需参数为 null 时引发

当所需参数为 null 时引发

适用于