جزئیات شغل

پیاده‌سازی سیستم دریافت، نمایش، انتخاب و همگام‌سازی شبکه‌ای آواتارها از طریق API سامانه سه‌بعدی متا ( manager of backend )

تجربه: 3

سن: 18 الی 30

محدوده حقوق و دستمزد: قابل مذاکره

جای خالی: 1

طبیعت شغلی : پیمانی

تاریخ ارسال : 2026.11.14

آخرین تاریخ : 2027.01.18

۱. شرح تسک و هدف (Overview & Objective)

هدف این تسک، پیاده‌سازی کامل چرخه انتخاب، دانلود پویا و همگام‌سازی شبکه‌ای (Network Synchronization) آواتارهای شهروندان در بخش بازی‌سازی پروژه Metaverse-Rang-World-3D-Multiverse است.

به محض ورود (لاگین) هر شهروند به محیط متاورس رنگ، لیستی از آواتارهای موجود از طریق وب‌سرویس بکند سامانه سه‌بعدی متا (api.model3d.ir) دریافت و به کاربر نمایش داده می‌شود. شهروند در هر بار ورود به محیط می‌تواند آواتار دلخواه خود را مشاهده، بررسی و انتخاب کند تا مدل سه‌بعدی آواتار دانلود شده و جایگزین کپسول پیش‌فرض کاراکتر در محیط اصلی شود. همچنین آواتار انتخابی باید به‌صورت شبکه‌ای (Multiplayer/Networked) برای سایر شهروندان حاضر در محیط قابل مشاهده باشد، بدون اینکه فرآیند دانلود آواتار باعث ایجاد لگ، فریز یا تاخیر (Delay/Lag) در اجرای بازی برای خود کاربر یا سایر شهروندان شود.

تصویر رابط کاربری موبایل که آواتار ها را به شکل اسلایدر نمایش می دهد .

۲. جریان کاربری و سناریوی عملکرد (User Flow)
  1. ورود و فراخوانی اولیه لیست آواتارها:
    • بلافاصله پس از لاگین موفق شهروند و پیش از ورود نهایی به محیط سه‌بعدی، درخواست دریافت لیست آواتارهای موجود به اندپوینت دسته‌بندی دارایی‌ها در api.model3d.ir ارسال می‌شود.
    • پنجره (UI Panel) لیست آواتارها باز شده و کارت‌های آواتارها شامل تصویر آواتار (Thumbnail)، نام آواتار (Title/Name) و شناسه آواتار (ID) نمایش داده می‌شوند.
  2. مشاهده جزئیات آواتار (کارت بزرگ‌تر / Modal جزئیات):
    • با کلیک کاربر بر روی هر کارت آواتار در لیست، یک درخواست به اندپوینت دریافت اطلاعات تکمیلی محصول (/user/assets/products/{product}) به همراه ID آن آواتار ارسال می‌گردد.
    • پس از دریافت پاسخ، کارت بزرگ‌تر (نمای جزئیات آواتار) نمایش داده می‌شود که حاوی:
      • تصویر بزرگ‌تر و باکیفیت آواتار
      • جزئیات و مشخصات کامل آواتار
      • لینک دانلود فایل مدل سه‌بعدی (دریافت شده از پاسخ API)
      • دکمه انتخاب (Select)
  3. انتخاب، دانلود و جایگزینی با کپسول در محیط:
    • با کلیک کاربر بر روی دکمه انتخاب، فایل مدل آواتار از طریق لینک دانلود ارائه‌شده در پاسخ API به‌صورت غیرهمزمان (Asynchronous) دانلود و بارگذاری می‌شود.
    • پس از تکمیل بارگذاری، کل صفحه/پنجره انتخاب آواتار بسته شده و آواتار انتخاب‌شده در محیط بازی جایگزین کپسول (Capsule) پیش‌فرض کاراکتر می‌شود.
    • این فرآیند در هر بار ورود شهروند به محیط در دسترس خواهد بود تا کاربر بتواند آواتار مورد نظر خود را برای آن نشست انتخاب کند.


پایه آدرس سرویس (Base URL): https://api.model3d.ir
فرمت تبادل داده: application/json

عنوان سرویسمتد HTTPمسیر (Endpoint)پارامتر ورودی (Path)کاربرد در تسک
دریافت لیست محصولات دسته‌بندیGET/user/assets/categories/{category}category (نوع: integer - اجباری)دریافت لیست آواتارهای موجود پس از لاگین شامل تصویر، نام و آی‌دی هر آواتار
دریافت اطلاعات تکمیلی محصولGET/user/assets/products/{product}product (نوع: integer - اجباری)دریافت اطلاعات کامل آواتار انتخابی شامل تصویر بزرگ‌تر، جزئیات و لینک دانلود مدل

ساختار نمونه پاسخ‌های API (Response Schema - 200 OK)

{
  "data": {},
  "message": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  }. الزامات شبکه و کارایی (Networking & Performance Requirements)
  • همگام‌سازی شبکه‌ای (Networked Avatars):
    • آواتار انتخاب‌شده توسط هر شهروند باید در شبکه (Multiplayer) همگام‌سازی شود تا سایر شهروندان حاضر در محیط (و شهروندانی که بعداً وارد می‌شوند) بتوانند آواتار انتخابی او را به‌درستی مشاهده کنند.
    • شناسه آواتار (product ID) یا لینک دارایی باید از طریق لایه شبکه به سایر کلاینت‌ها مخابره شده و کلاینت‌های دیگر نیز مدل مربوطه را دریافت و جایگزین کپسول آن بازیکن نمایند.
  • عدم ایجاد لگ، فریز یا تاخیر (Zero-Lag / Asynchronous Loading):
    • فرآیند دانلود، استخراج و ساخت (Instantiation) مدل سه‌بعدی آواتار در محیط (چه برای بازیکن محلی و چه هنگام ورود شهروند جدید برای سایر بازیکنان) باید کاملاً غیرهمزمان (Async / Non-blocking) در پس‌زمینه انجام شود.
    • ورود شهروند جدید یا دانلود آواتار او به هیچ عنوان نباید باعث افت فریم (FPS Drop)، توقف ترد اصلی بازی (Main Thread Freeze) یا ایجاد تاخیر و لگ در حرکت و تعاملات سایر شهروندان شود.
    • تا لحظه تکمیل دانلود و آماده‌سازی کامل مدل سه‌بعدی آواتار یک شهروند روی کلاینت سایر کاربران، کپسول موقت (یا نمایشگر بارگذاری سبک) بدون ایجاد اختلال حفظ شده و به محض آماده شدن مدل، جایگزینی به‌صورت نرم انجام پذیرد.
    • پیشنهاد می‌شود از مکانیزم کش محلی (Local Caching) بر اساس شناسه و نسخه آواتار استفاده شود تا از دانلود تکراری آواتارهای یکسان در نشست‌های بعدی یا برای بازیکنان دارای آواتار مشابه جلوگیری گردد.

۵. معیارهای پذیرش و تست (Acceptance Criteria)

  • ارسال خودکار درخواست GET /user/assets/categories/{category} بلافاصله پس از لاگین کاربر به محیط.
    نمایش صحیح لیست آواتارهای دریافتی در رابط کاربری شامل کارت‌هایی با تصویر، نام و آی‌دی آواتار.
    ارسال درخواست GET /user/assets/products/{product} با کلیک روی کارت هر آواتار و باز شدن کارت بزرگ‌تر (جزئیات).
    نمایش تصویر بزرگ‌تر، جزئیات آواتار، لینک دانلود و دکمه انتخاب در نمای جزئیات آواتار.
    دانلود غیرهمزمان فایل آواتار از لینک ارائه‌شده در API پس از کلیک بر روی دکمه انتخاب، بسته شدن کامل صفحه رابط کاربری انتخاب آواتار و جایگزینی صحیح آواتار به جای کپسول در محیط.
    فعال بودن فرآیند انتخاب آواتار در هر بار ورود شهروند به محیط.
    همگام‌سازی کامل آواتار در شبکه به‌طوری که سایر کاربران بتوانند آواتار انتخابی هر شهروند را در محیط مشاهده کنند.
    عدم بروز هرگونه لگ، فریز یا دیلی در گیم‌پلی و شبکه هنگام ورود شهروندان جدید و دانلود همزمان آواتار آن‌ها.
    استقرار و قابلیت استفاده کامل بر روی نسخه اصلی پروژه (Main Build / Production) و موفقیت در تست‌های عملکردی و شبکه‌ای روی نسخه اصلی.
مشخصات کار تعریف شده

عنوان شغلی: پیاده‌سازی سیستم دریافت، نمایش، انتخاب و همگام‌سازی شبکه‌ای آواتارها از طریق API سامانه سه‌بعدی متا

تعیین: manager of backend

تجربه: 3

سن: 18 الی 30

محدوده حقوق و دستمزد: قابل مذاکره

جای خالی: 1

طبیعت شغلی : پیمانی

تاریخ ارسال : 2026.11.14

آخرین تاریخ : 2027.01.18

اکنون درخواست دهید