التعرّف على الوجوه
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
باستخدام واجهة برمجة التطبيقات الخاصة بميزة "التعرّف على الوجوه" في أدوات تعلّم الآلة، يمكنك اكتشاف الوجوه في صورة، وتحديد ملامح الوجه الرئيسية، ومعرفة حدود الوجوه المكتشفة. يُرجى ملاحظة أنّ واجهة برمجة التطبيقات
ترصد الوجوه، ولا تتعرّف على الأشخاص .
باستخدام ميزة "التعرّف على الوجه"، يمكنك الحصول على المعلومات التي تحتاجها لتنفيذ مهام مثل تجميل الصور الذاتية وصور الأشخاص أو إنشاء صور رمزية من صورة المستخدم.
بما أنّ أدوات تعلّم الآلة يمكنها رصد الوجوه في الوقت الفعلي، يمكنك استخدامها في تطبيقات مثل محادثات الفيديو أو الألعاب التي تستجيب لتعبيرات اللاعبين.
iOS
Android
الإمكانات الرئيسية
- التعرّف على ملامح الوجه وتحديد موقعها
الحصول على إحداثيات العينين والأذنين والخدّين والأنف والفم لكل وجه يتم التعرّف عليه
- الحصول على تحديد حول ملامح الوجه
يمكنك الحصول على تفاصيل حول الوجوه التي تم رصدها والعيون والحواجب والشفاه والأنف.
- التعرّف على تعابير الوجه
حدِّد ما إذا كان الشخص يبتسم أو يغلق عينيه.
- تتبُّع الوجوه عبر إطارات الفيديو
احصل على معرّف لكل وجه فريد تم رصده.
ويكون المعرّف متسقًا في مختلف الاستدعاءات، لذلك يمكنك
معالجة الصورة على شخص معيّن في بث فيديو.
- معالجة إطارات الفيديو في الوقت الفعلي
يتم تنفيذ ميزة "التعرّف على الوجه" على الجهاز، وهي سريعة بما يكفي لاستخدامها في تطبيقات الوقت الفعلي، مثل معالجة الفيديو.
أمثلة النتائج
مثال 1
لكل وجه تم رصده:
| الوجه 1 من 3 |
|---|
| المضلّع المتداخل |
(884.880004882812, 149.546676635742),
(1030.77197265625, 149.546676635742),
(1030.77197265625,
3229.32038.
|
| زوايا الدوران |
ص: -14.054030418395996، ي: -55.007488250732422 |
| رقم تعريف التتبّع |
2 |
| معالم الوجه |
| العين اليسرى |
(945.869323730469, 211.867126464844) |
| العين اليمنى |
(971.579467773438، 247.257247924805) |
| أسفل الفم |
(907.756591796875، 259.714477539062) |
... وما إلى ذلك.
|
| احتمالات الميزات |
| الابتسام |
0.88979166746139526 |
| العين اليسرى مفتوحة |
0.98635888937860727 |
| العين اليمنى مفتوحة |
0.99258323386311531 |
|
المثال 2 (اكتشاف محيط الوجه)
عند تفعيل ميزة "التعرّف على محيط الوجه"، ستحصل أيضًا على قائمة بالنقاط
لكل ميزة تم رصدها في الوجه. وتمثّل هذه النقاط شكل العنصر. توضّح الصورة التالية كيفية تحديد هذه النقاط بوجه.
انقر على الصورة لتكبيرها:
| خطوط حول ميزات الوجه |
|---|
| جسر أنف |
(505.149811، 221.201797)، (506.987122، 313.285919)
|
| العين اليسرى |
(232.85431)
|
| أعلى الشفة العلوية |
421.662048
|
| (وغير ذلك) |
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eML Kit's Face Detection API can detect faces and their features in images and videos, but it does not recognize individuals.\u003c/p\u003e\n"],["\u003cp\u003eIt can be used for tasks such as adding effects to photos, creating avatars, and building interactive applications that respond to facial expressions.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides facial feature coordinates, contours, expression detection (like smiling), and face tracking across video frames.\u003c/p\u003e\n"],["\u003cp\u003eFace detection happens on the device and is fast enough for real-time applications.\u003c/p\u003e\n"]]],[],null,["With ML Kit's face detection API, you can detect faces in an image, identify\nkey facial features, and get the contours of detected faces. Note that the API\n*detects faces* , it does not *recognize people* .\n\nWith face detection, you can get the information you need to perform tasks like\nembellishing selfies and portraits, or generating avatars from a user's photo.\nBecause ML Kit can perform face detection in real time, you can use it in\napplications like video chat or games that respond to the player's expressions.\n\n[iOS](/ml-kit/vision/face-detection/ios)\n[Android](/ml-kit/vision/face-detection/android)\n\nKey capabilities\n\n- **Recognize and locate facial features** Get the coordinates of the eyes, ears, cheeks, nose, and mouth of every face detected.\n- **Get the contours of facial features** Get the contours of detected faces and their eyes, eyebrows, lips, and nose.\n- **Recognize facial expressions** Determine whether a person is smiling or has their eyes closed.\n- **Track faces across video frames** Get an identifier for each unique detected face. The identifier is consistent across invocations, so you can perform image manipulation on a particular person in a video stream.\n- **Process video frames in real time** Face detection is performed on the device, and is fast enough to be used in real-time applications, such as video manipulation.\n\nExample results\n\nExample 1\n\nFor each face detected:\n\n| Face 1 of 3 ||\n|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Bounding polygon** | (884.880004882812, 149.546676635742), (1030.77197265625, 149.546676635742), (1030.77197265625, 329.660278320312), (884.880004882812, 329.660278320312) |\n| **Angles of rotation** | Y: -14.054030418395996, Z: -55.007488250732422 |\n| **Tracking ID** | 2 |\n| **Facial landmarks** | |---------------------|--------------------------------------| | **Left eye** | (945.869323730469, 211.867126464844) | | **Right eye** | (971.579467773438, 247.257247924805) | | **Bottom of mouth** | (907.756591796875, 259.714477539062) | ... etc. |\n| **Feature probabilities** | |--------------------|---------------------| | **Smiling** | 0.88979166746139526 | | **Left eye open** | 0.98635888937860727 | | **Right eye open** | 0.99258323386311531 | |\n\nExample 2 (face contour detection)\n\nWhen you have face contour detection enabled, you also get a list of points\nfor each facial feature that was detected. These points represent the shape of\nthe feature. The following image illustrates how these points map to a face.\nClick the image to enlarge it:\n\n[](/static/ml-kit/vision/face-detection/images/face_contours.svg)\n\n| Facial feature contours ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Nose bridge** | (505.149811, 221.201797), (506.987122, 313.285919) |\n| **Left eye** | (404.642029, 232.854431), (408.527283, 231.366623), (413.565796, 229.427856), (421.378296, 226.967682), (432.598755, 225.434143), (442.953064, 226.089508), (453.899811, 228.594818), (461.516418, 232.650467), (465.069580, 235.600845), (462.170410, 236.316147), (456.233643, 236.891602), (446.363922, 237.966888), (435.698914, 238.149323), (424.320740, 237.235168), (416.037720, 236.012115), (409.983459, 234.870300) |\n| **Top of upper lip** | (421.662048, 354.520813), (428.103882, 349.694061), (440.847595, 348.048737), (456.549988, 346.295532), (480.526489, 346.089294), (503.375702, 349.470459), (525.624634, 347.352783), (547.371155, 349.091980), (560.082031, 351.693268), (570.226685, 354.210175), (575.305420, 359.257751) |\n| (etc.) | |"]]
