MediaPipe Yüz İşaretçisi görevi, resimlerdeki ve videolardaki yüzlerin yer işaretlerini ve yüz ifadelerini tespit etmenize olanak tanır. Bu görevi insanların yüz ifadelerini tanımlamak, yüz filtreleri ve efektleri uygulamak ve sanal avatarlar oluşturmak için kullanabilirsiniz. Bu görev, tek görüntülerle veya sürekli bir görüntü akışıyla çalışabilen makine öğrenimi (ML) modellerini kullanır. Görev, yüzlerin 3 boyutlu önemli noktalarını, ayrıntılı yüz yüzeylerini gerçek zamanlı olarak tahmin etmek için harmanlanan şekilleri puanları (yüz ifadesini temsil eden katsayılar) ve efekt oluşturmak için gereken dönüşümleri gerçekleştirmek için dönüşüm matrislerini üretir.
Başlayın
Hedef platformunuzun uygulama rehberlerinden birini izleyerek bu görevi kullanmaya başlayın. Bu platforma özel kılavuzlar, önerilen bir model ve önerilen yapılandırma seçenekleriyle birlikte kod örneği dahil olmak üzere, bu görevin temel bir şekilde uygulanmasında size yol gösterir:
- Android - Kod örneği - Kılavuz
- Python - Kod örneği - Kılavuz
- Web - Kod örneği - Kılavuz
Görev ayrıntıları
Bu bölümde, bu görevin özellikleri, girişleri, çıkışları ve yapılandırma seçenekleri açıklanmaktadır.
Özellikler
- Giriş resmi işleme: İşleme resim döndürme, yeniden boyutlandırma, normalleştirme ve renk alanı dönüştürme işlemlerini içerir.
- Puan eşiği - Sonuçları tahmin puanlarına göre filtreleyin.
| Görev girişleri | Görev çıkışları |
|---|---|
Yüz İşaretçisi, aşağıdaki veri türlerinden birinin girişini kabul eder:
|
Yüz İşaretçisi aşağıdaki sonuçları verir:
|
Yapılandırma seçenekleri
Bu görev aşağıdaki yapılandırma seçeneklerine sahiptir:
| Seçenek Adı | Açıklama | Değer Aralığı | Varsayılan Değer |
|---|---|---|---|
running_mode |
Görevin çalışma modunu ayarlar. Üç mod vardır: RESİM: Tek resimli girişler için mod. VİDEO: Bir videonun kodu çözülmüş karelerine yönelik mod. LIVE_STREAM: Kamera gibi giriş verilerini içeren bir canlı yayın modu. Bu modda, sonuçları eşzamansız olarak almak üzere bir işleyici ayarlamak için resultListener çağrılmalıdır. |
{IMAGE, VIDEO, LIVE_STREAM} |
IMAGE |
num_faces |
FaceLandmarker tarafından algılanabilen maksimum yüz sayısı. Yumuşatma yalnızca num_faces 1 olarak ayarlandığında uygulanır.
|
Integer > 0 |
1 |
min_face_detection_confidence |
Yüz algılamanın başarılı olarak kabul edilmesi için gereken minimum güven puanı. | Float [0.0,1.0] |
0.5 |
min_face_presence_confidence |
Yüz belirgin işareti algılamada yüz varlığı için minimum güven puanı. | Float [0.0,1.0] |
0.5 |
min_tracking_confidence |
Yüz izlemenin başarılı kabul edilmesi için gereken minimum güven puanı. | Float [0.0,1.0] |
0.5 |
output_face_blendshapes |
Yüz İşaretçisi'nin yüz karıştırma şekilleri oluşturup oluşturmayacağı. Yüz harmanlama şekilleri, 3D yüz modelini oluşturmak için kullanılır. | Boolean |
False |
output_facial_transformation_matrixes |
FaceLandmarker'ın yüz dönüştürme matrisi oluşturup oluşturmayacağı. FaceLandmarker, yüz yer işaretlerini standart bir yüz modelinden algılanan yüze dönüştürmek için matrisi kullanır. Böylece kullanıcılar, algılanan önemli noktalara efekt uygulayabilir. | Boolean |
False |
result_callback |
Sonuç işleyiciyi, FaceLandmarker canlı yayın modundayken işaretçi sonuçlarını eşzamansız olarak alacak şekilde ayarlar.
Yalnızca çalıştırma modu LIVE_STREAM olarak ayarlandığında kullanılabilir |
ResultListener |
N/A |
Modeller
Yüz Tanımlayıcı, yüzdeki önemli noktaları tahmin etmek için bir dizi model kullanır. İlk model yüzleri algılar, ikinci model algılanan yüzlerdeki önemli noktaları tespit eder ve üçüncü model de yüz özelliklerini ve ifadeleri tanımlamak için bu önemli noktaları kullanır.
Aşağıdaki modeller, indirilebilir bir model paketinde gruplanmıştır:
- Yüz algılama modeli: Birkaç önemli yüz işaretiyle birlikte yüzleri algılar.
- Yüz örgü modeli: Yüzün tam eşlemesini ekler. Model, 478 adet 3 boyutlu önemli yüz yapısı tahmini sağlar.
- Blendshape tahmin modeli: Yüz ağı modelinden çıktı alır. Yüzlerin farklı ifadelerini temsil eden katsayılar olan 52 harman şekil puanı tahmini kullanılır.
Yüz algılama modeli, mobil GPU çıkarımı için optimize edilmiş hafif ve doğru bir yüz algılayıcısı olan BlazeFace kısa menzilli modelidir. Daha fazla bilgi için Yüz Dedektörü görevine bakın.
Aşağıdaki resimde, model paketi sonucundan yüzdeki önemli noktaların eksiksiz bir eşlemesi gösterilmektedir.
Yüzün önemli noktalarının daha ayrıntılı bir görünümü için tam boyutlu resme bakın.
| Model paketi | Giriş şekli | Veri türü | Model Kartları | Sürümler |
|---|---|---|---|---|
| FaceLandmarker | Yüz Dedektörü: 192 x 192 FaceMesh-V2: 256 x 256 Harmanlama şekli: 1 x 146 x 2 |
kayan nokta 16 |
Yüz Dedektörü FaceMesh-V2 Harmanlanmış Şekil |
En son |