البدء — IngevoraMirage

البدءيأخذك هذا الدليل من أول تسجيل دخول إلى أول طلب يرسله تطبيقك. ويستخدم عدسة وجه مصنوعة من قالب. ستحتاج إلى حاسوب بمتصفح حديث، وإلى هاتف للتجربة.1. انضم إلى مساحة عملتعمل داخل مساحة عمل: وهي فريق شركتك في IngevoraMirage. المحرّر متاح على https://ingevoramirage.ingevora.com، وهناك طريقتان للدخول.عبر دعوة. يدعو Owner (المالك) في مساحة العمل عنوان بريدك الإلكتروني. يصلك بريد بعنوان "‹name› invited you to ‹workspace› on IngevoraMirage". يعمل رابطه مرة واحدة، لمدة 7 أيام.

إن لم يكن لديك حساب بعد، تطلب منك الصفحة اسمك وكلمة مرور، وقبول الشروط. اختر Create my account (إنشاء حسابي).

إن كان لديك حساب، اختر Sign in to join (سجّل الدخول للانضمام)، ثم سجّل الدخول، ثم اختر Join (انضمام).

بالتسجيل. ما دام التسجيل مفتوحًا، تعرض صفحة تسجيل الدخول الخيار Create an account (إنشاء حساب). أدخل Your name (اسمك) وWork email (بريد العمل) وWorkspace name (اسم مساحة العمل)، وضع علامة في المربع لقبول الشروط وسياسة الخصوصية، ثم اختر Continue (متابعة). يصلك بريد فيه رابط يعمل لمدة 24 ساعة، يفتح صفحة Create your password (أنشئ كلمة مرورك): اختر كلمة مرور، ثم Create my workspace (إنشاء مساحة عملي). تصبح بذلك Owner مساحة العمل الجديدة.إن لم تظهر Create an account في صفحة تسجيل الدخول، أو ظهرت في صفحة التسجيل رسالة Sign-up opens soon (يُفتح التسجيل قريبًا)، فالتسجيل غير مفتوح بعد. اطلب من Owner في مساحة عمل قائمة أن يدعوك.يجب ألّا تقلّ كلمة المرور عن 12 حرفًا.2. اصنع عدسة وجه من قالبتحتاج إلى دور Owner أو Designer (المصمّم) لهذه الخطوة.

افتح Face lenses (عدسات الوجه) واختر New face lens (عدسة وجه جديدة). وفي مساحة عمل فارغة، يؤدي Create your first face lens (أنشئ أول عدسة وجه) الغرض نفسه.

تحت Template (القالب)، اختر Face accessory (إكسسوار للوجه): تاج فوق الجبهة.

اكتب Name (الاسم) واختر Create (إنشاء). الاسم العربي اختياري.

يُفتح الاستوديو بطبقة واحدة هي crown، برسم تجريبي يمكنك استبداله لاحقًا. لرؤيتها على وجه، استخدم Choose a photo (اختر صورة) أو Use my camera (استخدم الكاميرا) في العارض. راجع جولة في الاستوديو.3. جرّبها على هاتفكاختر Test on phone (التجربة على الهاتف) في ترويسة الاستوديو. امسح رمز QR بكاميرا هاتفك، وافتح الصفحة، ثم اضغط Start camera (تشغيل الكاميرا). ترسم الصفحة المسودة الحالية فوق الكاميرا الأمامية وتتابع تعديلاتك. يعمل الرابط لمدة 30 دقيقة، والتجربة لا تنشر شيئًا. راجع التجربة على هاتفك.4. انشر الإصدار 1اختر Publish (النشر). يحفظ المحرّر تعديلاتك، ويفحص العدسة على الخادم، ثم ينشرها إن لم تكن هناك مشكلات. ستظهر لك الرسالة "Published version 1".إن احتاج شيء إلى إصلاح، فسيظهر في تبويب Issues (المشكلات). انقر مشكلةً للانتقال إلى طبقتها أو مُشغِّلها أو مقطعها. ويعرض تبويب Versions (الإصدارات) كل إصدار منشور. راجع الإصدارات: الأحدث والمثبّت.5. أصدر مفتاح APIتحتاج إلى دور Owner أو Developer (المطوّر) لهذه الخطوة.

افتح API keys (مفاتيح API) تحت Workspace في قائمة التنقل.

اكتب New key name (اسم المفتاح الجديد)، مثل "production server"، واختر Issue key (إصدار المفتاح).

انسخ المفتاح. يبدأ بـ mk_ ولا يُعرض إلا هذه المرة. احفظه في مخزن الأسرار على خادمك، ثم اختر I have stored it (حفظته).

راجع مفاتيح API.6. أرسل أول طلبافتح Developers (المطوّرون) تحت Workspace. في Your lenses and effects، انسخ معرّف عدستك. ثم استدعِ واجهة التسليم من خادمك، مع وضع مفتاحك في الترويسة X-Api-Key:

bash

curl -H "X-Api-Key: mk_…" https://mirage-api.ingevora.com/v1/lenses/8f3c2a10-…

يصف الرد أحدث إصدار منشور:

json

{
  "data": {
    "lensId": "8f3c2a10-…",
    "version": 1,
    "manifestUrl": "https://…/lenses/8f3c2a10-…/1/manifest.json",
    "manifestSha256": "3b7e…",
    "totalBytes": 48213,
    "minEngineVersion": 1,
    "publishedAt": "2026-10-02T09:30:00.000Z",
    "previewUrl": "https://…/lenses/8f3c2a10-…/1/preview.png"
  },
  "success": true
}

يعني الرمز 404 أن المعرّف خاطئ أو أن العدسة لم تُنشر قط. ويعني 403 أن عدسات الوجه معطّلة لمساحة عملك. راجع واجهة التسليم لمعرفة كل حقل.7. نزّلها بأماناجلب manifestUrl وتحقّق من أن بصمة SHA-256 الخاصة به تساوي manifestSha256. ثم اجلب كل صورة يذكرها ملف البيان (manifest)، من المجلد نفسه، وتحقّق منها مقابل قيمة sha256 التي يحدّدها لها ملف البيان. لا تستخدم العدسة إلا إذا نجحت جميع عمليات التحقّق. راجع التنزيل الآمن.الخطوات التالية

تعرّف على ما تستطيع طبقاتك فعله في عدسات الوجه وتأثيرات الشاشة.

اجعل العدسة تستجيب للوجه أو لتطبيقك في المُشغِّلات وأحداث تطبيقك.

استعدّ للأعطال في الأخطاء والحدود.