Datové struktury rozpoznávání tváře
Tento článek vysvětluje datové struktury používané ve službě Rozpoznávání tváře pro operace rozpoznávání tváře. Tyto datové struktury uchovávají data o tvářích a osobách.
Upozornění
Přístup ke službě Rozpoznávání tváře je omezený na základě kritérií způsobilosti a použití, aby bylo možné podporovat naše zásady zodpovědné umělé inteligence. Služba Rozpoznávání tváře je dostupná jenom pro zákazníky a partnery spravované Microsoftem. Pro přístup použijte formulář pro příjem rozpoznávání tváře. Další informace najdete na stránce s omezeným přístupem k tváři.
Datové struktury používané s identifikací
Rozhraní API pro rozpoznávání tváře používá datové struktury kontejnerů k ukládání dat rozpoznávání tváře ve formě objektů Person . Pro tento účel existují tři typy kontejnerů, které jsou uvedené od nejstarších po nejnovější. Doporučujeme vždy používat nejnovější verzi.
PersonGroup
PersonGroup je nejmenší datová struktura kontejneru.
- Při vytváření skupiny PersonGroup je potřeba zadat model rozpoznávání. Když se do této skupiny PersonGroup přidají všechny tváře, použije tento model ke zpracování. Tento model musí odpovídat verzi modelu s ID tváře z rozhraní DETECT API.
- Musíte volat rozhraní API pro trénování, aby se všechna nová data tváře odrážela ve výsledcích identifikace rozhraní API. To zahrnuje přidávání a odebírání tváří a přidávání nebo odebírání osob.
- U předplatného úrovně Free může obsahovat až 1 000 osob. U placeného předplatného S0 může mít až 10 000 osob.
PersonGroupPerson představuje osobu, která má být identifikována. Může obsahovat až 248 tváří.
Velká skupina osob
LargePersonGroup je novější datová struktura, která podporuje až 1 milion entit (pro předplatné úrovně S0). Je optimalizovaná pro podporu rozsáhlých dat. Sdílí většinu funkcí PersonGroup : Při vytváření je potřeba zadat model rozpoznávání a před použitím musí být volána rozhraní API pro trénování.
Adresář osob
PersonDirectory je nejnovější datová struktura tohoto typu. Podporuje větší měřítko a vyšší přesnost. Každý prostředek Azure Face má jednu výchozí datovou strukturu PersonDirectory . Je to plochý seznam objektů PersonDirectoryPerson – může obsahovat až 20 milionů.
PersonDirectoryPerson představuje osobu, která má být identifikována. Na základě staršího modelu PersonGroupPerson umožňuje přidat tváře z různých modelů rozpoznávání do stejné osoby. Operace Identifikace však může odpovídat pouze tvářím získaným se stejným modelem rozpoznávání.
DynamicPersonGroup je zjednodušená datová struktura, která umožňuje dynamicky odkazovat na PersonDirectoryPerson. Nevyžaduje operaci Trénování: jakmile se data aktualizují, je připravená k použití s rozhraním Identify API.
Pro operaci Identifikace můžete použít také místní seznam ID osoby. To vám umožní určit užší skupinu, ze které se má identifikovat. Můžete to udělat ručně, abyste zlepšili výkon identifikace ve velkých skupinách.
Výše uvedené datové struktury lze použít společně. Příklad:
- V systému řízení přístupu může PersonDirectory představovat všechny zaměstnance společnosti, ale menší skupina DynamicPersonGroup může představovat pouze zaměstnance, kteří mají přístup k jednomu patře budovy.
- V systému připojování letů může PersonDirectory představovat všechny zákazníky letecké společnosti, ale DynamicPersonGroup představuje pouze cestující na konkrétním letu. Místní seznam ID osoby může představovat cestující, kteří provedli změnu za poslední minutu.
Další podrobnosti najdete v průvodci postupy pro PersonDirectory. Rychlé porovnání skupiny LargePersonGroup a PersonDirectory:
| Podrobnosti | LargePersonGroup | PersonDirectory |
|---|---|---|
| Kapacita | Skupina LargePersonGroup může obsahovat až 1 milion objektů PersonGroupPerson . | Kolekce může ukládat až 20 milionů identit PersonDirectoryPerson . |
| Identifikátor PersonURI | /largepersongroups/{groupId}/persons/{personId} |
(/v1.0-preview-or-above)/persons/{personId} |
| Vlastnictví | Objekty PersonGroupPerson vlastní výhradně LargePersonGroup , do které patří. Pokud chcete mít stejnou identitu uloženou ve více skupinách, budete muset pro každou skupinu vytvořit velkou osobu skupiny osob a pro každou skupinu přidat tvář velké osoby , která končí sadou ID osob v několika skupinách. | Objekty PersonDirectoryPerson jsou přímo uloženy uvnitř PersonDirectory, jako plochý seznam. Pomocí místního seznamu ID osoby můžete identifikovat z adresáře osob nebo volitelně vytvořit dynamickou skupinu osob a hybridní zahrnutí osoby do skupiny. Na vytvořený objekt PersonDirectoryPerson lze odkazovat více DynamicPersonGroup bez duplicit. |
| Model | Model rozpoznávání určuje skupina LargePersonGroup. Nové tváře pro všechny objekty PersonGroupPerson se přidružují k tomuto modelu při jejich přidání. | Objekt PersonDirectoryPerson připraví oddělené úložiště na model rozpoznávání. Model můžete zadat při přidávání nových tváří, ale rozhraní API Pro identifikaci se může shodovat pouze s tvářemi získanými stejným modelem rozpoznávání, který je přidružený k dotazovacím tvářím. |
| Školení | Musíte volat rozhraní API pro trénování, aby se všechna nová data tváří a osob odrážela ve výsledcích identifikace rozhraní API. | Není nutné provádět trénovaná volání, ale rozhraní API, jako je přidání osoby, se stává dlouho běžící operací, což znamená, že byste měli použít hlavičku odpovědi "Operation-Location" (Umístění operace) a zkontrolovat, jestli se aktualizace dokončila. |
| Vyčištění | Odstranit velkou skupinu osob odstraní také všechny objekty PersonGroupPerson , které obsahuje, spolu s jejich daty o tváři. | Odstranění dynamické skupiny osob neodkazuje jenom na PersonDirectoryPerson. Pokud chcete odstranit skutečnou osobu a data tváře, přečtěte si téma Odstranit osobu. |
Datové struktury používané s funkcemi Najít podobné
Na rozdíl od rozhraní API pro identifikaci se rozhraní API Find Similar API používá v aplikacích, u kterých je obtížné nastavit registraci osoby (například obrázky tváří zachycené z analýzy videa nebo z analýzy fotoalba).
FaceList
FaceList představuje plochý seznam trvalých tváří. Může obsahovat 1 000 tváří.
LargeFaceList
LargeFaceList je novější verze, která může obsahovat až 1 000 000 tváří.
Další krok
Teď, když znáte struktury dat tváře, napište skript, který je používá v operaci Identifikace.