다음을 통해 공유

FaceDetectWithStreamOptionalParams interface

  • 참조
패키지:
@azure/cognitiveservices-face

선택적 매개 변수입니다.

Extends
RequestOptionsBase

속성

detectionModel

검색 모델의 이름입니다. 검색 모델은 제출된 이미지에서 얼굴을 감지하는 데 사용됩니다. 얼굴 - 감지 또는 (Large)FaceList - 얼굴 추가 또는 (Large)PersonGroup - 얼굴 추가를 수행할 때 검색 모델 이름을 제공할 수 있습니다. 기본값은 'detection_01'이며, 다른 모델이 필요한 경우 명시적으로 지정하세요. 가능한 값은 'detection_01', 'detection_02', 'detection_03'입니다. 기본값: 'detection_01'.
faceIdTimeToLive

캐시되는 faceId의 시간(초)입니다. 지원되는 범위는 60초에서 86400초까지입니다. 기본값은 86400(24시간)입니다. 기본값: 86400.
recognitionModel

인식 모델의 이름입니다. 인식 모델은 얼굴 기능이 추출되어 감지된 faceId, (Large)FaceList 또는 (Large)PersonGroup과 연결될 때 사용됩니다. Face - Detect 또는 (Large)FaceList - Create or (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'는 마스크 및 품질ForRecognition만 지원합니다. 또한 qualityForRecognition은 'recognitionModel'이 'recognition_03' 또는 'recognition_04'로 지정된 경우에만 지원됩니다. 각 얼굴 특성 분석에는 추가 계산 및 시간 비용이 있습니다.
returnFaceId

작업이 감지된 얼굴의 faceId를 반환해야 하는지 여부를 나타내는 값입니다. 기본값: true.
returnFaceLandmarks

작업이 감지된 얼굴의 랜드마크를 반환해야 하는지 여부를 나타내는 값입니다. 기본값: false
returnRecognitionModel

작업이 응답에서 'recognitionModel'을 반환해야 하는지 여부를 나타내는 값입니다. 기본값: false

상속된 속성

abortSignal

요청을 중단하는 데 사용할 수 있는 신호입니다.
customHeaders

요청을 보내기 전에 적용할 사용자 정의 사용자 지정 요청 헤더입니다.
onDownloadProgress

다운로드 진행 시 발생하는 콜백입니다.
onUploadProgress

업로드 진행 시 발생하는 콜백입니다.
timeout

요청이 자동으로 종료되기 전에 걸릴 수 있는 시간(밀리초)입니다.

속성 세부 정보

detectionModel

검색 모델의 이름입니다. 검색 모델은 제출된 이미지에서 얼굴을 감지하는 데 사용됩니다. 얼굴 - 감지 또는 (Large)FaceList - 얼굴 추가 또는 (Large)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

인식 모델의 이름입니다. 인식 모델은 얼굴 기능이 추출되어 감지된 faceId, (Large)FaceList 또는 (Large)PersonGroup과 연결될 때 사용됩니다. Face - Detect 또는 (Large)FaceList - Create or (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'는 마스크 및 품질ForRecognition만 지원합니다. 또한 qualityForRecognition은 'recognitionModel'이 'recognition_03' 또는 'recognition_04'로 지정된 경우에만 지원됩니다. 각 얼굴 특성 분석에는 추가 계산 및 시간 비용이 있습니다.

returnFaceAttributes?: FaceAttributeType[]

속성 값

FaceAttributeType[]

returnFaceId

작업이 감지된 얼굴의 faceId를 반환해야 하는지 여부를 나타내는 값입니다. 기본값: 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에서 상속됨