# فيديو HeyGen Avatar

أنشئ فيديو لمقدّم متحدث من صورة HeyGen الرمزية. تُنشئ هذه العقدة فيديو لصورة رمزية بالذكاء الاصطناعي تنطق النص الذي تقدمه أو تُزامن حركة الشفاه مع الصوت الخاص بك، باستخدام محركات العرض من HeyGen.

## المدخلات

### المدخلات العامة

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `المحرك` | محرك العرض؛ يسرد كل خيار فقط الصور الرمزية التي تدعمه. يوفّر "auto" كل الصور الرمزية ويختار أفضل محرك لها (مع تفضيل Avatar IV). تتمتع Avatar V بأعلى دقة، بينما Avatar III هو الأكثر اقتصادية. | DYNAMIC_COMBO | نعم | `"auto"`<br>`"avatar_iv"`<br>`"avatar_iii"`<br>`"avatar_v"` |
| `معرف الصورة الرمزية المخصص` | معرّف مظهر الصورة الرمزية في HeyGen (اختياري). عند تعيينه، يتجاوز الصورة الرمزية المحددة أعلاه. يمكن استخدام أي من أكثر من 3000 مظهر عام لدى HeyGen (أو صورك الرمزية الخاصة). الافتراضي: `""`. | STRING | لا |  |
| `الكلام` | تشغيل الصورة الرمزية عبر نص مكتوب (تحويل النص إلى كلام من HeyGen) أو الصوت الخاص بك. اسم العرض: "speech source". | DYNAMIC_COMBO | نعم | `"script"`<br>`"audio"` |
| `الدقة` | دقة فيديو الإخراج. الافتراضي: `"1080p"`. | COMBO | لا | `"720p"`<br>`"1080p"` |
| `نسبة العرض إلى الارتفاع` | نسبة أبعاد فيديو الإخراج. يتبع "auto" لقطات مصدر الصورة الرمزية. الافتراضي: `"auto"`. | COMBO | لا | `"auto"`<br>`"16:9"`<br>`"9:16"`<br>`"1:1"`<br>`"4:5"`<br>`"5:4"` |
| `لون الخلفية` | لون خلفية صلب اختياري كرمز ست عشري (hex) (مثل `"#00ff00"`). اتركه فارغًا لاستخدام خلفية الصورة الرمزية الخاصة بها. إذا تم توفيره، يجب أن تبدأ القيمة بـ `#`. الافتراضي: `""`. | STRING | لا |  |
| `البذرة` | لا يُرسَل إلى HeyGen؛ غيّره لفرض إعادة التشغيل. الافتراضي: `42`. | INT | لا | الحد الأدنى: 0<br>الحد الأقصى: 2147483647 |

### مدخلات `auto`

عندما تكون قيمة `engine` هي `"auto"`، يتوفر المعامل الفرعي التالي:

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `avatar` | مظهر الصورة الرمزية لتقديم الفيديو (منتقى من مكتبة HeyGen العامة). يتم اختيار أفضل محرك يدعمه المظهر تلقائيًا. | COMBO | نعم | خيارات متعددة متاحة |

### مدخلات `avatar_iv`

عندما تكون قيمة `engine` هي `"avatar_iv"`، يتوفر المعامل الفرعي التالي:

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `avatar` | مظاهر الصور الرمزية التي تدعم محرك Avatar IV. | COMBO | نعم | خيارات متعددة متاحة |

### مدخلات `avatar_iii`

عندما تكون قيمة `engine` هي `"avatar_iii"`، يتوفر المعامل الفرعي التالي:

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `avatar` | مظاهر الصور الرمزية التي تدعم محرك Avatar III. | COMBO | نعم | خيارات متعددة متاحة |

### مدخلات `avatar_v`

عندما تكون قيمة `engine` هي `"avatar_v"`، يتوفر المعامل الفرعي التالي:

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `avatar` | مظاهر الصور الرمزية التي تدعم محرك Avatar V. | COMBO | نعم | خيارات متعددة متاحة |

### مدخلات `script`

عندما تكون قيمة `speech` هي `"script"`، تتوفر المعاملات الفرعية التالية:

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `text` | النص الذي ستتحدث به الصورة الرمزية (حتى 5000 حرف). يجب أن يكون الكلام المُنشأ بطول ثانية واحدة على الأقل. الافتراضي: `""`. | STRING | نعم | الحد الأدنى: حرف واحد<br>الحد الأقصى: 5000 حرف |
| `voice` | الصوت الخاص بالنص. يستخدم الخيار الافتراضي الصوت الذي خصصته HeyGen للصورة الرمزية. يُتجاهل إذا تم تعيين `custom_voice_id`. | COMBO | نعم | `"(avatar's default voice)"`<br>خيارات صوتية عامة متعددة متاحة |
| `custom_voice_id` | معرّف صوت HeyGen (اختياري). عند تعيينه، يتجاوز الصوت المحدد أعلاه. يمكن استخدام أي صوت من مكتبة HeyGen (أكثر من 2000). الافتراضي: `""`. | STRING | لا |  |
| `voice_speed` | مضاعِف سرعة الكلام. الافتراضي: `1.0`. | FLOAT | لا | الحد الأدنى: 0.5<br>الحد الأقصى: 1.5<br>الخطوة: 0.05 |

### مدخلات `audio`

عندما تكون قيمة `speech` هي `"audio"`، يتوفر المعامل الفرعي التالي:

| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
|-----------|-------------|-----------|----------|-------|
| `audio` | الصوت الذي ستزامن الصورة الرمزية حركة شفاهها معه، حتى 10 دقائق. | AUDIO | نعم |  |

ملاحظة: `engine` و `speech` هما محدّدان يكشفان عن معاملات فرعية مختلفة حسب القيمة المختارة. لمحدد `speech` وضعان متنافيان: في وضع `"script"`، يكون `text` مطلوبًا؛ وإذا تم توفير `custom_voice_id`، فإنه يتجاوز `voice`. في وضع `"audio"`، تُزامن الصورة الرمزية حركة شفاهها مع مقطع الصوت المقدم. يجب أن يكون `background_color` رمز لون ست عشري يبدأ بـ `#` عند توفيره. عند تعيين `custom_avatar_id`، فإنه يتجاوز اختيار `avatar`، ويجب أن يدعم مظهر الصورة الرمزية هذا قيمة `engine` المحددة؛ وإلا فسيتم رفع خطأ ما لم تكن قيمة `engine` هي `"auto"`.

## المخرجات

| اسم المخرَج | الوصف | نوع البيانات |
|-------------|-------|--------------|
| `VIDEO` | فيديو المقدّم بالصورة الرمزية المُنشأ. | VIDEO |

> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/ar.md)

---
**Source fingerprint (SHA-256):** `86dc799d3a8cf2666449b0d422853b12feffb81ce002f84594f9b925d58b522a`
