Ralyoo dokumentasi developerSDK 1.1.0ralyoo.com

Ralystudioo

Lingkungan pengembangan lokal untuk game Ralyoo: simulator, pemeriksaan, dan pembungkus. Paketnya @ralyoo/studio, sudah terpasang di game dari template.

npx ralystudioo dev        # simulator
npx ralystudioo lint       # periksa manifest dan bundel
npx ralystudioo pack       # build, periksa, tulis <id>-<versi>.ralyoo
npx ralystudioo publish --to https://staging.ralyoo.com

Saat ini Ralystudioo berfokus pada game 2D (DOM dan PixiJS + Rapier2D).

Simulator

npm run dev

Buka http://localhost:5180/__studio/.

Yang berjalan di sana bukan tiruan. Layar host dan controller adalah aplikasi yang sama dengan ralyoo.com, game dipasang di sandbox yang sama, dan bundelnya lewat pemeriksaan yang sama dengan saat diunggah. Yang lokal hanya relay-nya. Game yang jalan di simulator jalan sama di Ralyoo.

Setiap kali sebuah file disimpan, game dibangun ulang dan layar host dimuat lagi; room dan HP tetap tersambung.

Kontrol Guna
Players 1–4 HP virtual. Game mulai begitu semuanya masuk
Disconnect / Reconnect Memutus satu HP. Slotnya ditahan, lalu ia kembali ke slot yang sama
Phones HP tegak atau miring
Latency Menambah jeda di relay lokal, sampai 300 ms ± 60
Reduced motion Game menerima ctx.reducedMotion = true
Start in lobby Lobi dan QR sungguhan, tanpa mulai otomatis
Restart Memulai ulang game

Di layar host:

  • Esc membuka menu host (jeda).
  • Baris GAME di pojok kiri atas adalah HUD performa: fps, waktu frame rata-rata/p95/maks, jumlah frame di atas 50 ms, dan ukuran bundel. Shift+D menyembunyikannya.
  • Klik sekali untuk menyalakan suara.

Panel Checks menampilkan hasil lint untuk build terakhir. Build yang bukan bundel valid tidak dijalankan; alasannya tampil di sana.

HP sungguhan

npx ralystudioo dev --lan

Simulator lalu mendengarkan di jaringan. Buka alamat Wi-Fi yang dicetak di terminal, lalu scan QR di panel Real phones dari HP yang berada di Wi-Fi yang sama. Tanpa --lan, simulator hanya menjawab komputer ini.

Opsi

Opsi
--port <n> Port simulator (bawaan 5180)
--lan Izinkan HP di jaringan yang sama

lint

Memeriksa ralyoo.json dan, kalau game sudah dibangun, bundelnya:

  • manifest terhadap skema, rentang sdk, dan kontras warna;
  • file wajib: main.js, ikon, cover;
  • tipe file, path, dan batas ukuran;
  • impor di main.js yang tidak disediakan platform;
  • hal yang akan diblokir sandbox (eval, alamat di luar bundel).

Error membuat bundel ditolak. Peringatan (budget muat, bentuk cover, tema menu yang kontrasnya kurang) tidak, tetapi layak dilihat. Keluar dengan kode bukan nol kalau ada error, jadi bisa dipakai di CI.

pack

Menjalankan build, lalu lint, lalu menulis <id>-<versi>.ralyoo di folder game. Berkas itu zip berisi dist/ tanpa source map.

Opsi
--out <berkas> Tempat menulis bundel
--no-build Bungkus dist/ yang sudah ada

publish

Mengunggah bundel ke registry Ralyoo. Lihat Publikasi.

Batas

  • Relay lokal hanya untuk pengembangan. Latensi sungguhan dan WebTransport hanya ada di Ralyoo.
  • Pustaka 3D (three, rapier3d) tersedia di platform tetapi belum dibawa simulator. lint memperingatkan kalau game mengimpornya.

Halaman ini sebagai Markdown: ralystudioo.md · semua halaman: llms.txt