通过

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

FaceDetectWithStreamOptionalParams interface

  • 参考
包:
@azure/cognitiveservices-face

可选参数。

Extends
RequestOptionsBase

属性

detectionModel

检测模型的名称。 检测模型用于检测提交图像中的人脸。 执行人脸 - 检测或 (大型) FaceList - 添加人脸或 (大型) PersonGroup - 添加人脸时，可以提供检测模型名称。 默认值为“detection_01”，如果需要其他模型，请显式指定它。 可能的值包括：“detection_01”、“detection_02”、“detection_03”。 默认值：“detection_01”。
faceIdTimeToLive

正在缓存的 faceId 的秒数。 支持的范围从 60 秒到 86400 秒不等。 默认值为 86400 (24 小时) 。 默认值：86400。
recognitionModel

识别模型的名称。 提取人脸特征并将其与检测到的 faceIds 相关联时，将使用识别模型， (大型) FaceList 或 (大型) PersonGroup。 执行 Face - Detect 或 (Large) FaceList - Create 或 (Large) PersonGroup - Create 时，可以提供识别模型名称。 默认值为“recognition_01”，如果需要最新模型，请显式指定所需的模型。 可能的值包括：“recognition_01”、“recognition_02”、“recognition_03”、“recognition_04”。 默认值：“recognition_01”。
returnFaceAttributes

分析并返回逗号分隔字符串中的一个或多个指定人脸属性，例如“returnFaceAttributes=age，gender”。 可用属性取决于指定的“detectionModel”。 “detection_01”支持年龄、性别、头部、微笑、面部、眼镜、情感、头发、化妆、遮挡、配件、模糊、曝光、噪音和质量ForRecognition。 虽然“detection_02”不支持任何属性和“detection_03”仅支持 mask 和 qualityForRecognition。 此外，仅当将“recognitionModel”指定为“recognition_03”或“recognition_04”时，才支持 qualityForRecognition。 请注意，每个人脸属性分析都有额外的计算和时间成本。
returnFaceId

一个值，该值指示操作是否应返回检测到的人脸的 faceIds。 默认值：true。
returnFaceLandmarks

一个值，该值指示操作是否应返回检测到的人脸的地标。 默认值：false。
returnRecognitionModel

一个值，该值指示操作是否应返回“recognitionModel”作为响应。 默认值：false。

继承属性

abortSignal

可用于中止请求的信号。
customHeaders

用户定义的自定义请求标头，将在发送请求之前应用。
onDownloadProgress

下载进度时触发的回调。
onUploadProgress

上传进度时触发的回调。
timeout

请求在自动终止之前可以花费的毫秒数。

属性详细信息

detectionModel

检测模型的名称。 检测模型用于检测提交图像中的人脸。 执行人脸 - 检测或 (大型) FaceList - 添加人脸或 (大型) PersonGroup - 添加人脸时，可以提供检测模型名称。 默认值为“detection_01”，如果需要其他模型，请显式指定它。 可能的值包括：“detection_01”、“detection_02”、“detection_03”。 默认值：“detection_01”。

detectionModel?: DetectionModel

属性值

DetectionModel

faceIdTimeToLive

正在缓存的 faceId 的秒数。 支持的范围从 60 秒到 86400 秒不等。 默认值为 86400 (24 小时) 。 默认值：86400。

faceIdTimeToLive?: number

属性值

number

recognitionModel

识别模型的名称。 提取人脸特征并将其与检测到的 faceIds 相关联时，将使用识别模型， (大型) FaceList 或 (大型) PersonGroup。 执行 Face - Detect 或 (Large) FaceList - Create 或 (Large) PersonGroup - Create 时，可以提供识别模型名称。 默认值为“recognition_01”，如果需要最新模型，请显式指定所需的模型。 可能的值包括：“recognition_01”、“recognition_02”、“recognition_03”、“recognition_04”。 默认值：“recognition_01”。

recognitionModel?: RecognitionModel

属性值

RecognitionModel

returnFaceAttributes

分析并返回逗号分隔字符串中的一个或多个指定人脸属性，例如“returnFaceAttributes=age，gender”。 可用属性取决于指定的“detectionModel”。 “detection_01”支持年龄、性别、头部、微笑、面部、眼镜、情感、头发、化妆、遮挡、配件、模糊、曝光、噪音和质量ForRecognition。 虽然“detection_02”不支持任何属性和“detection_03”仅支持 mask 和 qualityForRecognition。 此外，仅当将“recognitionModel”指定为“recognition_03”或“recognition_04”时，才支持 qualityForRecognition。 请注意，每个人脸属性分析都有额外的计算和时间成本。

returnFaceAttributes?: FaceAttributeType[]

属性值

FaceAttributeType[]

returnFaceId

一个值，该值指示操作是否应返回检测到的人脸的 faceIds。 默认值：true。

returnFaceId?: boolean

属性值

boolean

returnFaceLandmarks

一个值，该值指示操作是否应返回检测到的人脸的地标。 默认值：false。

returnFaceLandmarks?: boolean

属性值

boolean

returnRecognitionModel

一个值，该值指示操作是否应返回“recognitionModel”作为响应。 默认值：false。

returnRecognitionModel?: boolean

属性值

boolean

继承属性详细信息

abortSignal

可用于中止请求的信号。

abortSignal?: AbortSignalLike

属性值

AbortSignalLike

继承自 msRest.RequestOptionsBase.abortSignal

customHeaders

用户定义的自定义请求标头，将在发送请求之前应用。

customHeaders?: {[key: string]: string}

属性值

{[key: string]: string}

继承自 msRest.RequestOptionsBase.customHeaders

onDownloadProgress

下载进度时触发的回调。

onDownloadProgress?: (progress: TransferProgressEvent) => void

属性值

(progress: TransferProgressEvent) => void

继承自 msRest.RequestOptionsBase.onDownloadProgress

onUploadProgress

上传进度时触发的回调。

onUploadProgress?: (progress: TransferProgressEvent) => void

属性值

(progress: TransferProgressEvent) => void

继承自 msRest.RequestOptionsBase.onUploadProgress

timeout

请求在自动终止之前可以花费的毫秒数。

timeout?: number

属性值

number

继承自 msRest.RequestOptionsBase.timeout