رفتن به محتوا
xuka●توسعه‌دهندگان
بازگشت به ژوکا
فهرست فضای توسعه‌دهندگان
XUKA DEVELOPERS

بازی‌ات را برای ژوکا بساز

راهنمای اتصال بازی، مرجع کیت و دارایی‌های آماده؛ همه در یک جا.

شروع سریعمشاهدهٔ SDK

اولین اتصال به ژوکا

از آماده‌سازی پروژه تا برقراری ارتباط با شِل.

  1. راه‌اندازی پروژه

    ساختار بازی و محیط اجرای محلی را آماده کن.

  2. اتصال کیت بازی

    کلاینت کیت و قابلیت‌های موردنیاز بازی را تعریف کن.

  3. اجرای بازی در ژوکا

    بازی را از ژوکا اجرا کن تا ارتباط با شِل برقرار شود.

راهنمای کامل شروع کار
client.js
import { createGameClient } from "/sdk/client.mjs";

const sdk = createGameClient({
  protocolVersion: 2,
  capabilities: ["assets-v1", "session-v1", "purchases-v1"],
});
یادداشت‌های فنی بستر

اینجا راهنمای ساخت بازی روی ژوکا است. پنل توسعه‌دهنده کلید توسعه‌دهنده، آپلود draft و پیش‌نمایش Sandbox دارد. بسته‌های واقعی SDK و Studio نسخهٔ 1.0.0 با tarball آزمایش شده‌اند؛ بسته‌های فعلی npm فقط برای رزرو نام هستند. پرتال عمومی مستقل و بستهٔ کامل حقوقی هنوز عرضه نشده‌اند.

واقعیت‌های فعلی بستر

  • بازی داخل iframe قرنطینه‌شده و روی مبدأ جدا اجرا می‌شود و فقط از راه کیت نسخه‌دار با شِل حرف می‌زند.
  • بازی هرگز توکن ورود، API تغییر کیف پول، یا دسترسی مستقیم به ACoreX را نمی‌گیرد.
  • بازی‌های کاتالوگ به‌صورت ایستا سمت سرور ثبت می‌شوند. پوشهٔ games/ خودش اسکن یا اجرا نمی‌شود.
  • بازی قابل اجرا client/، server/، در صورت نیاز shared/، assets/ و manifest.json را خودش دارد. API ماژول سرور را صریح ثبت می‌کند.
  • جورچین، واژه‌چین، مین‌روب و جزیره‌های خاطره بازی‌های قابل اجرای ثبت‌شده‌اند. قابلیت‌های پروتکل ۲ جورچین assets-v1، session-v1 و purchases-v1 است. واژه‌چین و مین‌روب assets-v1، session-v1، presentation-v1 و audio-settings-v1 را اعلام می‌کنند. جزیره‌های خاطره همان‌ها را به‌علاوهٔ session-navigation-v1 اعلام می‌کند.
  • اجرای محلی همان راهنمای ریشه است. پورت‌ها: شِل 5173، API 5510، میزبان بازی 5501.
  • بسته‌های دارایی عمومی در دارایی‌ها هستند. فقط آخرین نسخهٔ قابل‌نمایش برای توسعه‌دهنده، فایل‌های مالک بسته، بند انگشتی WebP، و رنگ‌های تم صحنه. بسته‌های فقط‌بازیکن در این گالری نیستند. بازی همچنان مسیر فایل را نمی‌بیند.

بعداً

انتشار گزینه‌شده، بررسی و آموزش بازی شروع در نقشهٔ راه آمده‌اند و هنوز در دسترس نیستند. این صفحه درگاه ارسال بازی نیست. گالری عناصر رابط و بخش‌های کتاب طراحی بعداً همین‌جا اضافه می‌شوند؛ هنوز ساخته نشده‌اند.