Face Detection Operations - Detect
Emberi arcok észlelése egy képen, arc téglalapok visszaadása, valamint opcionálisan faceId-ekkel, tereptárgyakkal és attribútumokkal.
Fontos
Annak érdekében, hogy mérsékeljük azokat a lehetséges visszaéléseket, amelyek a felhasználókat sztereotípiákhoz, diszkriminációhoz vagy tisztességtelen szolgáltatásmegtagadáshoz vezethetnek, megszűnnek a Face API-attribútumok, amelyek érzelmeket, nemet, kort, mosolyt, arcszőrzetet, hajat és sminket jeleznek előre. További információ erről a döntésről https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.
-
- A rendszer nem tárol lemezképet. Csak a kinyert arcfunkció(ka)t tárolja a rendszer a kiszolgálón. A faceId az arcfunkció azonosítója, és az "Azonosítás", az "Ellenőrzés" és a "Hasonló keresése" kifejezésben lesz használva. A tárolt arcfunkciók lejárnak, és az eredeti észlelési hívás után a faceIdTimeToLive által megadott időpontban törlődnek.
- A választható paraméterek közé tartoznak a faceId, a tájékozódási pontok és az attribútumok. Az attribútumok közé tartozik a headPose, a szemüveg, az occlusion, a tartozékok, az életlenítés, az expozíció, a zaj, a maszk és a qualityForRecognition. Előfordulhat, hogy bizonyos attribútumok esetében visszaadott eredmények némelyike nem túl pontos.
- A JPEG, a PNG, a GIF (az első képkocka) és a BMP formátum támogatott. Az engedélyezett képfájlméret 1 KB és 6 MB között van.
- A minimálisan észlelhető arcméret 36x36 képpont a képen, amely nem nagyobb, mint 1920x1080 képpont. A 1920x1080 képpontnál nagyobb méretű képekhez arányosan nagyobb minimális arcméretre lesz szükség.
- Egy képhez legfeljebb 100 arc adható vissza. Az arcok a nagytól a kicsiig az arc téglalapmérete szerint vannak rangsorolva.
- Az "Azonosítás", az "Ellenőrzés" és a "Hasonló keresése" (a "returnFaceId" értéke igaz) lekérdezés optimális eredményéhez használjon olyan arcokat, amelyek a következők: előlapi, világos és minimálisan 200x200 képpont méretűek (szemenként 100 képpont).
- Különböző "detectionModel" értékek adhatók meg. A különböző észlelési modellek használatához és összehasonlításához tekintse meg a következőt: https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
- "detection_02": Az arcattribútumok és a tájékozódási pontok le vannak tiltva, ha ezt az észlelési modellt választja.
- "detection_03": Az arcattribútumok (maszk, életlenítés és headPose) és a tereptárgyak támogatottak, ha ezt az észlelési modellt választja.
- A rendszer különböző "recognitionModel" értékeket ad meg. Ha olyan követő műveletekre van szükség, mint az "Ellenőrzés", az "Azonosítás", a "Hasonló keresése", adja meg a felismerési modellt a "recognitionModel" paraméterrel. A recognitionModel alapértelmezett értéke "recognition_01", ha a legújabb modellre van szükség, explicit módon adja meg a szükséges modellt ebben a paraméterben. A megadott azonosító megadása után az észlelt faceId-azonosítók a megadott felismerési modellhez lesznek társítva. További részletekért tekintse meg a következőt: https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.
POST {endpoint}/face/{apiVersion}/detect
POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
api
|
path | True |
string |
API-verzió |
endpoint
|
path | True |
string uri |
Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://{resource-name}.cognitiveservices.azure.com). |
detection
|
query |
Az észlelt faceId-ekhez társított "detectionModel". A támogatott detectionModel értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01". |
||
face
|
query |
integer int32 |
A gyorsítótárazott arcazonosító másodperces száma. A támogatott tartomány 60 másodperctől 86400 másodpercig terjed. Az alapértelmezett érték 86400 (24 óra). |
|
recognition
|
query |
Az észlelt faceId-ekhez társított "recognitionModel". A támogatott "recognitionModel" értékek a következők: "recognition_01", "recognition_02", "recognition_03" vagy "recognition_04". Az alapértelmezett érték a "recognition_01". A "recognition_04" használata ajánlott, mivel a maszkot viselő arcok pontossága a "recognition_03" és a "recognition_01" és a "recognition_02" esetében javult. |
||
return
|
query |
Elemezze és adja vissza a vesszővel tagolt sztring egy vagy több megadott arcattribútumát, például a "returnFaceAttributes=headPose,szemüveg" karakterláncot. A Face attribútumelemzés további számítási és időköltséggel rendelkezik. |
||
return
|
query |
boolean |
Az észlelt arcok faceId azonosítóit adja vissza. Az alapértelmezett érték az igaz. |
|
return
|
query |
boolean |
Az észlelt arcok arcjeleneteit adja vissza, vagy sem. Az alapértelmezett érték a hamis. |
|
return
|
query |
boolean |
A "recognitionModel" értéket adja vissza, vagy sem. Az alapértelmezett érték a hamis. Ez csak akkor alkalmazható, ha returnFaceId = true. |
Kérelem törzse
Media Types: "application/octet-stream"
Name | Típus | Description |
---|---|---|
imageContent |
string |
A bemeneti kép bináris fájlja. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A sikeres hívás arcbejegyzések tömböt ad vissza, amely az arc téglalapmérete szerint csökkenő sorrendben van rangsorolva. Az üres válasz azt jelzi, hogy nem észlelhető arc. |
|
Other Status Codes |
Váratlan hibaválasz. Fejlécek x-ms-error-code: string |
Biztonság
Ocp-Apim-Subscription-Key
Az Azure AI Face-előfizetés titkos kulcsa.
Típus:
apiKey
In:
header
AADToken
Az Azure Active Directory OAuth2-folyamat
Típus:
oauth2
Folyamat:
accessCode
Engedélyezési URL:
https://api.example.com/oauth2/authorize
Jogkivonat URL-címe:
https://api.example.com/oauth2/token
Hatókörök
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Példák
Detect with Image
Mintakérelem
POST {endpoint}/face/v1.1-preview.1/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60
"<your-image-bytes-here>"
Mintaválasz
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"recognitionModel": "recognition_03",
"faceRectangle": {
"width": 78,
"height": 78,
"left": 394,
"top": 54
},
"faceLandmarks": {
"pupilLeft": {
"x": 412.7,
"y": 78.4
},
"pupilRight": {
"x": 446.8,
"y": 74.2
},
"noseTip": {
"x": 437.7,
"y": 92.4
},
"mouthLeft": {
"x": 417.8,
"y": 114.4
},
"mouthRight": {
"x": 451.3,
"y": 109.3
},
"eyebrowLeftOuter": {
"x": 397.9,
"y": 78.5
},
"eyebrowLeftInner": {
"x": 425.4,
"y": 70.5
},
"eyeLeftOuter": {
"x": 406.7,
"y": 80.6
},
"eyeLeftTop": {
"x": 412.2,
"y": 76.2
},
"eyeLeftBottom": {
"x": 413,
"y": 80.1
},
"eyeLeftInner": {
"x": 418.9,
"y": 78
},
"eyebrowRightInner": {
"x": 4.8,
"y": 69.7
},
"eyebrowRightOuter": {
"x": 5.5,
"y": 68.5
},
"eyeRightInner": {
"x": 441.5,
"y": 75
},
"eyeRightTop": {
"x": 446.4,
"y": 71.7
},
"eyeRightBottom": {
"x": 447,
"y": 75.3
},
"eyeRightOuter": {
"x": 451.7,
"y": 73.4
},
"noseRootLeft": {
"x": 428,
"y": 77.1
},
"noseRootRight": {
"x": 435.8,
"y": 75.6
},
"noseLeftAlarTop": {
"x": 428.3,
"y": 89.7
},
"noseRightAlarTop": {
"x": 442.2,
"y": 87
},
"noseLeftAlarOutTip": {
"x": 424.3,
"y": 96.4
},
"noseRightAlarOutTip": {
"x": 446.6,
"y": 92.5
},
"upperLipTop": {
"x": 437.6,
"y": 105.9
},
"upperLipBottom": {
"x": 437.6,
"y": 108.2
},
"underLipTop": {
"x": 436.8,
"y": 111.4
},
"underLipBottom": {
"x": 437.3,
"y": 114.5
}
},
"faceAttributes": {
"glasses": "sunglasses",
"headPose": {
"roll": 2.1,
"yaw": 3,
"pitch": 1.6
},
"occlusion": {
"foreheadOccluded": false,
"eyeOccluded": false,
"mouthOccluded": false
},
"accessories": [
{
"type": "headwear",
"confidence": 0.99
},
{
"type": "glasses",
"confidence": 1
},
{
"type": "mask",
"confidence": 0.87
}
],
"blur": {
"blurLevel": "medium",
"value": 0.51
},
"exposure": {
"exposureLevel": "goodExposure",
"value": 0.55
},
"noise": {
"noiseLevel": "low",
"value": 0.12
},
"qualityForRecognition": "high"
}
}
]
Definíciók
Name | Description |
---|---|
Accessory |
Kiegészítő elem és a megfelelő megbízhatósági szint. |
Accessory |
A tartozék típusa. |
Blur |
A homályosság szintjét jelzi. |
Blur |
A képen belüli elmosódást leíró tulajdonságok. |
Detection |
Az észlelt faceId-ekhez társított "detectionModel". A támogatott detectionModel értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01". |
Exposure |
Az expozíció szintjét jelzi. |
Exposure |
A kép expozíciós szintjét leíró tulajdonságok. |
Face |
Az észlelt arc arcattribútumai. |
Face |
Elemezze és adja vissza a vesszővel tagolt sztring egy vagy több megadott arcattribútumát, például a "returnFaceAttributes=headPose,szemüveg" karakterláncot. A Face attribútumelemzés további számítási és időköltséggel rendelkezik. |
Face |
Válasz az API észlelésére. |
Face |
A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages. |
Face |
A hiba részleteit tartalmazó válasz. |
Face |
27 pontos arc-tájékozódási pontok gyűjteménye, amely az arcösszetevők fontos pozícióira mutat. |
Face |
Egy téglalap, amelyen belül egy arc található. |
Facial |
Arcszőrzet-attribútumokat leíró tulajdonságok. |
Glasses |
Az arc szemüvegtípusa. |
Hair |
A jelölt színek és megbízhatósági szint tömbje az egyes színek jelenlétében. |
Hair |
A hajszín neve. |
Hair |
A hajattribútumokat leíró tulajdonságok. |
Head |
Térhatású tekercs/yaw/pitch szögek az arc irányához. |
Landmark |
A képen belüli tájékozódási koordináták. |
Mask |
A maszk adott arcon való jelenlétét leíró tulajdonságok. |
Mask |
A maszk típusa. |
Noise |
A zaj szintjét jelzi. |
Noise |
A kép zajszintét leíró tulajdonságok. |
Occlusion |
Az adott arcon az elzáródásokat leíró tulajdonságok. |
Quality |
A képminőséget jelzi a felismeréshez. |
Recognition |
Az arc felismerési modellje. |
AccessoryItem
Kiegészítő elem és a megfelelő megbízhatósági szint.
Name | Típus | Description |
---|---|---|
confidence |
number |
A tartozéktípus megbízhatósági szintje. [0,1] közötti tartomány. |
type |
A tartozék típusa. |
AccessoryType
A tartozék típusa.
Name | Típus | Description |
---|---|---|
glasses |
string |
Szemüveg. |
headwear |
string |
Fejkopás. |
mask |
string |
Maszk. |
BlurLevel
A homályosság szintjét jelzi.
Name | Típus | Description |
---|---|---|
high |
string |
Magas életlenítési szint. |
low |
string |
Alacsony életlenítési szint. |
medium |
string |
Közepes életlenítési szint. |
BlurProperties
A képen belüli elmosódást leíró tulajdonságok.
Name | Típus | Description |
---|---|---|
blurLevel |
Egy számérték, amely a homályosság szintjét jelzi. |
|
value |
number |
A 0 és 1 közötti elmosódottságot jelző szám. |
DetectionModel
Az észlelt faceId-ekhez társított "detectionModel". A támogatott detectionModel értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01".
Name | Típus | Description |
---|---|---|
detection_01 |
string |
Az alapértelmezett észlelési modell. Javasoljuk, hogy közel előtérbeli arcfelismeréshez. Kivételesen nagy szögű (fej-póz) arcokkal, elzárt arcokkal vagy rossz kép tájolással rendelkező forgatókönyvek esetén előfordulhat, hogy az ilyen esetekben az arcok nem észlelhetők. |
detection_02 |
string |
A 2019 májusában kiadott észlelési modell nagyobb pontosságot eredményez, különösen a kis, oldalsó és homályos arcokon. |
detection_03 |
string |
A 2021 februárjában kiadott észlelési modell nagyobb pontosságot eredményez, különösen a kis arcokon. |
ExposureLevel
Az expozíció szintjét jelzi.
Name | Típus | Description |
---|---|---|
goodExposure |
string |
Jó expozíciós szint. |
overExposure |
string |
Magas expozíciós szint. |
underExposure |
string |
Alacsony expozíciós szint. |
ExposureProperties
A kép expozíciós szintjét leíró tulajdonságok.
Name | Típus | Description |
---|---|---|
exposureLevel |
Az expozíció szintjét jelző enumerálási érték. |
|
value |
number |
0 és 1 közötti expozíciós szintet jelző szám. [0, 0,25) expozíció alatt áll. [0,25, 0,75) jó expozíció. [0,75, 1] túl van téve az expozíciónak. |
FaceAttributes
Az észlelt arc arcattribútumai.
Name | Típus | Description |
---|---|---|
accessories |
Tulajdonságok, amelyek egy adott arcon lévő tartozékokat írják le. |
|
age |
number |
Életkor évek alatt. |
blur |
A képen belüli elmosódást leíró tulajdonságok. |
|
exposure |
A kép expozíciós szintjét leíró tulajdonságok. |
|
facialHair |
Arcszőrzet-attribútumokat leíró tulajdonságok. |
|
glasses |
Szemüveg típus, ha bármelyik arc. |
|
hair |
A hajattribútumokat leíró tulajdonságok. |
|
headPose |
Térhatású tekercs/yaw/pitch szögek az arc irányához. |
|
mask |
A maszk adott arcon való jelenlétét leíró tulajdonságok. |
|
noise |
A kép zajszintét leíró tulajdonságok. |
|
occlusion |
Az adott arcon az elzáródásokat leíró tulajdonságok. |
|
qualityForRecognition |
Az általános képminőséget leíró tulajdonságok arra vonatkozóan, hogy az észlelés során használt kép megfelelő minőségű-e az arcfelismerési kísérlethez. |
|
smile |
number |
Mosoly intenzitása, [0,1] közötti szám. |
FaceAttributeType
Elemezze és adja vissza a vesszővel tagolt sztring egy vagy több megadott arcattribútumát, például a "returnFaceAttributes=headPose,szemüveg" karakterláncot. A Face attribútumelemzés további számítási és időköltséggel rendelkezik.
Name | Típus | Description |
---|---|---|
accessories |
string |
Kiegészítők az arc körül, beleértve a "fejruhát", a "szemüveget" és a "maszkot". Az üres tömb azt jelenti, hogy a rendszer nem észlel tartozékokat. Vegye figyelembe, hogy ez az arc észlelése után történik. A nagyméretű maszk nem eredményezhet arcfelismerést. |
age |
string |
Életkor évek alatt. |
blur |
string |
Az arc elmosódott vagy sem. A Szint az "Alacsony", a "Közepes" vagy a "Magas" értéket adja vissza. Az érték [0,1] közötti számot ad vissza, minél nagyobb a homályosabb érték. |
exposure |
string |
Arc expozíciós szintje. A Szint a "GoodExposure", "OverExposure" vagy "UnderExposure" értéket adja vissza. |
facialHair |
string |
Arcszőrzet-attribútumokat leíró tulajdonságok. |
glasses |
string |
Szemüveg típus. Az értékek közé tartozik a "NoGlasses", "ReadingGlasses", "Sunglasses", "SwimmingGoggles". |
hair |
string |
A hajattribútumokat leíró tulajdonságok. |
headPose |
string |
Térhatású tekercs/yaw/pitch szögek az arc irányához. |
mask |
string |
Hogy minden arc visel-e maszkot. A maszk típusa "noMask", "faceMask", "otherMaskOrOcclusion" vagy "bizonytalan" értéket ad vissza. Az érték egy logikai "noseAndMouthCovered" értéket ad vissza, amely azt jelzi, hogy az orr és a száj lefedve van-e. |
noise |
string |
Az arc képpontjainak zajszintje. A Szint az "Alacsony", a "Közepes" és a "Magas" értéket adja vissza. Az érték egy [0,1] közötti számot ad vissza, minél nagyobb a zajosabb |
occlusion |
string |
Hogy minden arcterület el van-e csukva, beleértve a homlokot, a szemet és a szájat. |
qualityForRecognition |
string |
Az általános képminőség azt illetően, hogy az észlelés során használt kép megfelelő minőségű-e az arcfelismerési kísérlethez. Az érték alacsony, közepes vagy magas nem hivatalos minősítés. Személyregisztrációhoz csak "kiváló" minőségű képek használata ajánlott, azonosítási forgatókönyvek esetén pedig a "közepes" vagy annál magasabb minőség ajánlott. Az attribútum csak recognition_03 vagy recognition_04 felismerési modellek használatakor érhető el. |
smile |
string |
Mosoly intenzitása, [0,1] közötti szám. |
FaceDetectionResult
Válasz az API észlelésére.
Name | Típus | Description |
---|---|---|
faceAttributes |
Arcattribútumok az észlelt archoz. |
|
faceId |
string |
Az észlelt arc egyedi faceId azonosítója, amelyet az észlelési API hoz létre, és az észlelési hívás után 24 órával lejár. Ennek visszaadásához a "returnFaceId" paraméternek igaznak kell lennie. |
faceLandmarks |
27 pontból álló tömb, amely az arcösszetevők fontos pozícióira mutat. Ennek visszaadásához a "returnFaceLandmarks" paraméternek igaznak kell lennie. |
|
faceRectangle |
A képen látható arc helyének téglalap területe. |
|
recognitionModel |
A faceId azonosítóhoz társított "recognitionModel". Ez csak akkor lesz visszaadva, ha a "returnRecognitionModel" explicit módon igaz értékre van állítva. |
FaceError
A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.
Name | Típus | Description |
---|---|---|
code |
string |
A kiszolgáló által definiált hibakódok egyike. |
message |
string |
A hiba emberi olvasásra alkalmas ábrázolása. |
FaceErrorResponse
A hiba részleteit tartalmazó válasz.
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
FaceLandmarks
27 pontos arc-tájékozódási pontok gyűjteménye, amely az arcösszetevők fontos pozícióira mutat.
Name | Típus | Description |
---|---|---|
eyeLeftBottom |
A bal szem aljának koordinátái. |
|
eyeLeftInner |
A bal szem belső koordinátái. |
|
eyeLeftOuter |
A bal szem koordinátái. |
|
eyeLeftTop |
A bal szem tetejének koordinátái. |
|
eyeRightBottom |
A jobb szem aljának koordinátái. |
|
eyeRightInner |
A jobb szem belső koordinátái. |
|
eyeRightOuter |
A jobb szem külső koordinátái. |
|
eyeRightTop |
A jobb felső szem koordinátái. |
|
eyebrowLeftInner |
A bal szemöldök belső koordinátái. |
|
eyebrowLeftOuter |
A bal szemöldök külső koordinátái. |
|
eyebrowRightInner |
A jobb szemöldök belső koordinátái. |
|
eyebrowRightOuter |
A jobb szemöldök külső koordinátái. |
|
mouthLeft |
A száj koordinátái balra. |
|
mouthRight |
A száj koordinátái jobbra. |
|
noseLeftAlarOutTip |
Az orr koordináta-koordinátái kicsúsztak. |
|
noseLeftAlarTop |
Az orr bal felső részének koordinátái. |
|
noseRightAlarOutTip |
Az orr jobb oldali csúcsának koordinátái. |
|
noseRightAlarTop |
Az orr jobb felső részének koordinátái. |
|
noseRootLeft |
Az orrgyökér koordinátái balra. |
|
noseRootRight |
Az orrgyökér koordinátái jobbra. |
|
noseTip |
Az orrhegy koordinátái. |
|
pupilLeft |
A bal szem tanulójának koordinátái. |
|
pupilRight |
A jobb szem pupilláinak koordinátái. |
|
underLipBottom |
A száj alsó részének koordinátái. |
|
underLipTop |
Az ajakfelső koordinátái. |
|
upperLipBottom |
A felső ajak aljának koordinátái. |
|
upperLipTop |
A felső ajakfelső koordinátái. |
FaceRectangle
Egy téglalap, amelyen belül egy arc található.
Name | Típus | Description |
---|---|---|
height |
integer |
A téglalap magassága képpontban. |
left |
integer |
A bal széltől mért távolság, ha a kép a téglalap bal szélétől képpontban van. |
top |
integer |
A felső széltől mért távolság, ha a kép a téglalap felső széléig, képpontban kifejezve. |
width |
integer |
A téglalap szélessége képpontban. |
FacialHair
Arcszőrzet-attribútumokat leíró tulajdonságok.
Name | Típus | Description |
---|---|---|
beard |
number |
Egy tulajdonsághoz társított megbízhatósági szintet jelző szám 0 és 1 között. |
moustache |
number |
Egy tulajdonsághoz társított megbízhatósági szintet jelző szám 0 és 1 között. |
sideburns |
number |
Egy tulajdonsághoz társított megbízhatósági szintet jelző szám 0 és 1 között. |
GlassesType
Az arc szemüvegtípusa.
Name | Típus | Description |
---|---|---|
noGlasses |
string |
Nincs szemüveg az arcon. |
readingGlasses |
string |
Normál szemüveg az arcon. |
sunglasses |
string |
Napszemüveg az arcon. |
swimmingGoggles |
string |
Úszószemüveg az arcon. |
HairColor
A jelölt színek és megbízhatósági szint tömbje az egyes színek jelenlétében.
Name | Típus | Description |
---|---|---|
color |
A hajszín neve. |
|
confidence |
number |
A szín megbízhatósági szintje. [0,1] közötti tartomány. |
HairColorType
A hajszín neve.
Name | Típus | Description |
---|---|---|
black |
string |
Fekete. |
blond |
string |
Szőke. |
brown |
string |
Barna. |
gray |
string |
Szürke. |
other |
string |
Egyéb. |
red |
string |
Piros. |
unknown |
string |
Unknown. |
white |
string |
Fehér. |
HairProperties
A hajattribútumokat leíró tulajdonságok.
Name | Típus | Description |
---|---|---|
bald |
number |
A megbízhatósági szintet leíró szám, amely azt jelzi, hogy a személy kopasz-e. |
hairColor |
A jelölt színek és megbízhatósági szint tömbje az egyes színek jelenlétében. |
|
invisible |
boolean |
Logikai érték, amely leírja, hogy a haj látható-e a képen. |
HeadPose
Térhatású tekercs/yaw/pitch szögek az arc irányához.
Name | Típus | Description |
---|---|---|
pitch |
number |
A szögek értéke. |
roll |
number |
A szögek értéke. |
yaw |
number |
A szögek értéke. |
LandmarkCoordinate
A képen belüli tájékozódási koordináták.
Name | Típus | Description |
---|---|---|
x |
number |
A vízszintes összetevő képpontban. |
y |
number |
A függőleges összetevő képpontban. |
MaskProperties
A maszk adott arcon való jelenlétét leíró tulajdonságok.
Name | Típus | Description |
---|---|---|
noseAndMouthCovered |
boolean |
Logikai érték, amely azt jelzi, hogy az orr és a száj lefedve van-e. |
type |
A maszk típusa. |
MaskType
A maszk típusa.
Name | Típus | Description |
---|---|---|
faceMask |
string |
Arcmaszk. |
noMask |
string |
Nincs maszk. |
otherMaskOrOcclusion |
string |
Más típusú maszkok és elzáródások. |
uncertain |
string |
Bizonytalan. |
NoiseLevel
A zaj szintjét jelzi.
Name | Típus | Description |
---|---|---|
high |
string |
Magas zajszint. |
low |
string |
Alacsony zajszint. |
medium |
string |
Közepes zajszint. |
NoiseProperties
A kép zajszintét leíró tulajdonságok.
Name | Típus | Description |
---|---|---|
noiseLevel |
Egy számérték, amely a zaj szintjét jelzi. |
|
value |
number |
0 és 1 közötti zajszintet jelző szám. [0, 0,25) expozíció alatt áll. [0,25, 0,75) jó expozíció. [0,75, 1] túl van téve az expozíciónak. [0, 0,3) alacsony zajszint. [0.3, 0.7) közepes zajszint. [0.7, 1] magas zajszint. |
OcclusionProperties
Az adott arcon az elzáródásokat leíró tulajdonságok.
Name | Típus | Description |
---|---|---|
eyeOccluded |
boolean |
Logikai érték, amely azt jelzi, hogy a szemek el vannak-e zártak. |
foreheadOccluded |
boolean |
Logikai érték, amely azt jelzi, hogy a homlok el van-e zárt állapotban. |
mouthOccluded |
boolean |
Logikai érték, amely azt jelzi, hogy a száj el van-e csukva. |
QualityForRecognition
A képminőséget jelzi a felismeréshez.
Name | Típus | Description |
---|---|---|
high |
string |
Kiváló minőség. |
low |
string |
Gyenge minőség. |
medium |
string |
Közepes minőség. |
RecognitionModel
Az arc felismerési modellje.
Name | Típus | Description |
---|---|---|
recognition_01 |
string |
A "Detect" alapértelmezett felismerési modellje. A 2019 márciusa előtt létrehozott faceId azonosítók mindegyike ehhez a felismerési modellhez van kötve. |
recognition_02 |
string |
A felismerési modell 2019 márciusában jelent meg. |
recognition_03 |
string |
A felismerési modell 2020 májusában jelent meg. |
recognition_04 |
string |
A 2021 februárjában kiadott felismerési modell. Javasoljuk, hogy ezt a felismerési modellt használja a jobb felismerési pontosság érdekében. |