你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
PersonGroupPerson class
表示 PersonGroupPerson 的类。
构造函数
Person |
创建 PersonGroupPerson。 |
方法
构造函数详细信息
PersonGroupPerson(FaceClientContext)
创建 PersonGroupPerson。
new PersonGroupPerson(client: FaceClientContext)
参数
- client
- FaceClientContext
对服务客户端的引用。
方法详细信息
addFaceFromStream(string, string, HttpRequestBody, PersonGroupPersonAddFaceFromStreamOptionalParams)
将某个人员的人脸添加到人员组以进行人脸识别或验证。 若要处理包含多个人脸的图像,可以将输入人脸指定为具有 targetFace 矩形的图像。 它返回一个 persistedFaceId,表示添加的人脸。 不会存储任何图像。
只有提取的人脸特征将存储在服务器上,直到调用 PersonGroup PersonFace - Delete、 PersonGroup 人员 - 删除 或 PersonGroup - Delete 。
请注意 persistedFaceId 不同于 Face - Detect 生成的 faceId。
- 人脸图像质量越高,识别精度就越高。 请考虑高质量的人脸:正面、清晰、人脸大小为 200x200 像素 (100 像素,眼睛) 或更大。
- 每人参赛最多可以容纳 248 张人脸。
- 支持 JPEG、PNG、GIF (第一帧) 和 BMP 格式。 允许的图像文件大小为 1KB 到 6MB。
- “targetFace”矩形应包含一个面。 零张或多张人脸将被视为错误。 如果提供的“targetFace”矩形未从 人脸 - 检测返回,则不能保证成功检测和添加人脸。
- 超过可检测的人脸大小 (36x36 - 4096x4096 像素) ,大头部姿势或大遮挡将导致故障。
- 向同一人员添加/删除人脸将按顺序处理。 向/从不同人员添加/删除人脸是并行处理的。
- 在不超过 1920x1080 像素的图像中,可检测到的最小人脸大小为 36x36 像素。 尺寸大于 1920x1080 像素的图像需要按比例增大最小人脸大小。
- 可以提供不同的“detectionModel”值。 若要使用和比较不同的检测模型,请参阅 如何指定检测模型。
function addFaceFromStream(personGroupId: string, personId: string, image: HttpRequestBody, options?: PersonGroupPersonAddFaceFromStreamOptionalParams): Promise<PersonGroupPersonAddFaceFromStreamResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- image
- HttpRequestBody
图像流。
可选参数
返回
Promise<Models.PersonGroupPersonAddFaceFromStreamResponse>
addFaceFromStream(string, string, HttpRequestBody, PersonGroupPersonAddFaceFromStreamOptionalParams, ServiceCallback<PersistedFace>)
function addFaceFromStream(personGroupId: string, personId: string, image: HttpRequestBody, options: PersonGroupPersonAddFaceFromStreamOptionalParams, callback: ServiceCallback<PersistedFace>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- image
- HttpRequestBody
图像流。
可选参数
- callback
回调
addFaceFromStream(string, string, HttpRequestBody, ServiceCallback<PersistedFace>)
function addFaceFromStream(personGroupId: string, personId: string, image: HttpRequestBody, callback: ServiceCallback<PersistedFace>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- image
- HttpRequestBody
图像流。
- callback
回调
addFaceFromUrl(string, string, string, PersonGroupPersonAddFaceFromUrlOptionalParams)
将某个人员的人脸添加到人员组以进行人脸识别或验证。 若要处理包含多个人脸的图像,可以将输入人脸指定为具有 targetFace 矩形的图像。 它返回一个 persistedFaceId,表示添加的人脸。 不会存储任何图像。
只有提取的人脸特征将存储在服务器上,直到调用 PersonGroup PersonFace - Delete、 PersonGroup 人员 - 删除 或 PersonGroup - Delete 。
请注意 persistedFaceId 不同于 Face - Detect 生成的 faceId。
- 人脸图像质量越高,识别精度就越高。 请考虑高质量的人脸:正面、清晰、人脸大小为 200x200 像素 (100 像素,眼睛) 或更大。
- 每人参赛最多可以容纳 248 张人脸。
- 支持 JPEG、PNG、GIF (第一帧) 和 BMP 格式。 允许的图像文件大小为 1KB 到 6MB。
- “targetFace”矩形应包含一个面。 零张或多张人脸将被视为错误。 如果提供的“targetFace”矩形未从 人脸 - 检测返回,则不能保证成功检测和添加人脸。
- 超过可检测的人脸大小 (36x36 - 4096x4096 像素) ,大头部姿势或大遮挡将导致故障。
- 向同一人员添加/删除人脸将按顺序处理。 向/从不同人员添加/删除人脸是并行处理的。
- 在不超过 1920x1080 像素的图像中,可检测到的最小人脸大小为 36x36 像素。 尺寸大于 1920x1080 像素的图像需要按比例增大最小人脸大小。
- 可以提供不同的“detectionModel”值。 若要使用和比较不同的检测模型,请参阅 如何指定检测模型。
function addFaceFromUrl(personGroupId: string, personId: string, url: string, options?: PersonGroupPersonAddFaceFromUrlOptionalParams): Promise<PersonGroupPersonAddFaceFromUrlResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- url
-
string
图像的可公开访问 URL
可选参数
返回
Promise<Models.PersonGroupPersonAddFaceFromUrlResponse>
addFaceFromUrl(string, string, string, PersonGroupPersonAddFaceFromUrlOptionalParams, ServiceCallback<PersistedFace>)
function addFaceFromUrl(personGroupId: string, personId: string, url: string, options: PersonGroupPersonAddFaceFromUrlOptionalParams, callback: ServiceCallback<PersistedFace>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- url
-
string
图像的可公开访问 URL
可选参数
- callback
回调
addFaceFromUrl(string, string, string, ServiceCallback<PersistedFace>)
function addFaceFromUrl(personGroupId: string, personId: string, url: string, callback: ServiceCallback<PersistedFace>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- url
-
string
图像的可公开访问 URL
- callback
回调
create(string, PersonGroupPersonCreateOptionalParams)
在指定的人员组中创建新用户。
function create(personGroupId: string, options?: PersonGroupPersonCreateOptionalParams): Promise<PersonGroupPersonCreateResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
可选参数
返回
Promise<PersonGroupPersonCreateResponse>
Promise<Models.PersonGroupPersonCreateResponse>
create(string, PersonGroupPersonCreateOptionalParams, ServiceCallback<Person>)
function create(personGroupId: string, options: PersonGroupPersonCreateOptionalParams, callback: ServiceCallback<Person>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
可选参数
- callback
回调
create(string, ServiceCallback<Person>)
function create(personGroupId: string, callback: ServiceCallback<Person>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- callback
回调
deleteFace(string, string, string, RequestOptionsBase)
通过指定的 largePersonGroupId、personId 和 persistedFaceId,删除大型人员组中的人脸。
向同一人员添加/删除人脸将按顺序处理。
向/从不同人员添加/删除人脸是并行处理的。
function deleteFace(personGroupId: string, personId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<RestResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
- options
- RequestOptionsBase
可选参数
返回
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteFace(string, string, string, RequestOptionsBase, ServiceCallback<void>)
function deleteFace(personGroupId: string, personId: string, persistedFaceId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
- options
- RequestOptionsBase
可选参数
- callback
-
ServiceCallback<void>
回调
deleteFace(string, string, string, ServiceCallback<void>)
function deleteFace(personGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<void>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
- callback
-
ServiceCallback<void>
回调
deleteMethod(string, string, RequestOptionsBase)
从人员组中删除现有人员。 将删除人员条目中的 persistedFaceId、userData、人员名称和人脸功能。
function deleteMethod(personGroupId: string, personId: string, options?: RequestOptionsBase): Promise<RestResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- options
- RequestOptionsBase
可选参数
返回
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteMethod(string, string, RequestOptionsBase, ServiceCallback<void>)
function deleteMethod(personGroupId: string, personId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- options
- RequestOptionsBase
可选参数
- callback
-
ServiceCallback<void>
回调
deleteMethod(string, string, ServiceCallback<void>)
function deleteMethod(personGroupId: string, personId: string, callback: ServiceCallback<void>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- callback
-
ServiceCallback<void>
回调
get(string, string, RequestOptionsBase)
检索人员的信息,包括已注册的持久化人脸、姓名和 userData。
function get(personGroupId: string, personId: string, options?: RequestOptionsBase): Promise<PersonGroupPersonGetResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- options
- RequestOptionsBase
可选参数
返回
Promise<PersonGroupPersonGetResponse>
Promise<Models.PersonGroupPersonGetResponse>
get(string, string, RequestOptionsBase, ServiceCallback<Person>)
function get(personGroupId: string, personId: string, options: RequestOptionsBase, callback: ServiceCallback<Person>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- options
- RequestOptionsBase
可选参数
- callback
回调
get(string, string, ServiceCallback<Person>)
function get(personGroupId: string, personId: string, callback: ServiceCallback<Person>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- callback
回调
getFace(string, string, string, RequestOptionsBase)
检索持久化人脸 (由 persistedFaceId、personId 及其所属 personGroupId) 指定的信息。
function getFace(personGroupId: string, personId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<PersonGroupPersonGetFaceResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
- options
- RequestOptionsBase
可选参数
返回
Promise<PersonGroupPersonGetFaceResponse>
Promise<Models.PersonGroupPersonGetFaceResponse>
getFace(string, string, string, RequestOptionsBase, ServiceCallback<PersistedFace>)
function getFace(personGroupId: string, personId: string, persistedFaceId: string, options: RequestOptionsBase, callback: ServiceCallback<PersistedFace>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
- options
- RequestOptionsBase
可选参数
- callback
回调
getFace(string, string, string, ServiceCallback<PersistedFace>)
function getFace(personGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<PersistedFace>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
- callback
回调
list(string, PersonGroupPersonListOptionalParams)
列出人员组中的所有人员,并检索人员信息 (包括人员) 的已注册人脸的 personId、姓名、userData 和 persistedFaceIds。
function list(personGroupId: string, options?: PersonGroupPersonListOptionalParams): Promise<PersonGroupPersonListResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
可选参数
返回
Promise<PersonGroupPersonListResponse>
Promise<Models.PersonGroupPersonListResponse>
list(string, PersonGroupPersonListOptionalParams, ServiceCallback<Person[]>)
function list(personGroupId: string, options: PersonGroupPersonListOptionalParams, callback: ServiceCallback<Person[]>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
可选参数
- callback
回调
list(string, ServiceCallback<Person[]>)
function list(personGroupId: string, callback: ServiceCallback<Person[]>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- callback
回调
update(string, string, PersonGroupPersonUpdateOptionalParams)
更新某个人员的姓名或 userData。
function update(personGroupId: string, personId: string, options?: PersonGroupPersonUpdateOptionalParams): Promise<RestResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
可选参数
返回
Promise<RestResponse>
Promise<msRest.RestResponse>
update(string, string, PersonGroupPersonUpdateOptionalParams, ServiceCallback<void>)
function update(personGroupId: string, personId: string, options: PersonGroupPersonUpdateOptionalParams, callback: ServiceCallback<void>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
可选参数
- callback
-
ServiceCallback<void>
回调
update(string, string, ServiceCallback<void>)
function update(personGroupId: string, personId: string, callback: ServiceCallback<void>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- callback
-
ServiceCallback<void>
回调
updateFace(string, string, string, PersonGroupPersonUpdateFaceOptionalParams)
将某个人员的人脸添加到人员组以进行人脸识别或验证。 若要处理包含多个人脸的图像,可以将输入人脸指定为具有 targetFace 矩形的图像。 它返回一个 persistedFaceId,表示添加的人脸。 不会存储任何图像。
只有提取的人脸特征将存储在服务器上,直到调用 PersonGroup PersonFace - Delete、 PersonGroup 人员 - 删除 或 PersonGroup - Delete 。
请注意 persistedFaceId 不同于 Face - Detect 生成的 faceId。
- 人脸图像质量越高,识别精度就越高。 请考虑高质量的人脸:正面、清晰、人脸大小为 200x200 像素 (100 像素,眼睛) 或更大。
- 每人参赛最多可以容纳 248 张人脸。
- 支持 JPEG、PNG、GIF (第一帧) 和 BMP 格式。 允许的图像文件大小为 1KB 到 6MB。
- “targetFace”矩形应包含一个面。 零张或多张人脸将被视为错误。 如果提供的“targetFace”矩形未从 人脸 - 检测返回,则不能保证成功检测和添加人脸。
- 超过可检测的人脸大小 (36x36 - 4096x4096 像素) ,大头部姿势或大遮挡将导致故障。
- 向同一人员添加/删除人脸将按顺序处理。 向/从不同人员添加/删除人脸是并行处理的。
function updateFace(personGroupId: string, personId: string, persistedFaceId: string, options?: PersonGroupPersonUpdateFaceOptionalParams): Promise<RestResponse>
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
可选参数
返回
Promise<RestResponse>
Promise<msRest.RestResponse>
updateFace(string, string, string, PersonGroupPersonUpdateFaceOptionalParams, ServiceCallback<void>)
function updateFace(personGroupId: string, personId: string, persistedFaceId: string, options: PersonGroupPersonUpdateFaceOptionalParams, callback: ServiceCallback<void>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
可选参数
- callback
-
ServiceCallback<void>
回调
updateFace(string, string, string, ServiceCallback<void>)
function updateFace(personGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<void>)
参数
- personGroupId
-
string
引用特定人员组的 ID。
- personId
-
string
引用特定人员的 ID。
- persistedFaceId
-
string
引用现有人脸的特定 persistedFaceId 的 ID。
- callback
-
ServiceCallback<void>
回调