@usions/devkit (Монгол)

English version: README.md

Usion mini-app болон тоглоомоо өөрийн компьютер дээрээ бүтээж, шалгаарай — Usion бүртгэл, байршуулсан сервис, хоёр дахь утас шаардлагагүй.

npx @usions/devkit create turn-based-duel my-game
cd my-game
npx @usions/devkit dev .

Дараа нь нээгээрэй:

• http://localhost:4747/ — Тоглогч 1
• http://localhost:4747/?player=2 — Тоглогч 2

Хоёр таб, хоёр тоглогч, нэг өрөө. Аппыг тойрсон harness жинхэнэ Usion host протоколоор ярьдаг (INIT, хэтэвч, storage, cloud KV, leaderboard, тоглоомын релей), релей нь жинхэнэ платформын семантикийг хэрэгжүүлдэг — дараалалтай action илгээгчид нь echo-логдоно, realtime илгээгчийг алгасна, sync replay, зөвхөн authority-гийн setState, дахин холболтын хүлээлгийн цонх. Энд ажиллавал Usion дээр ажиллана.

Chaos самбар

Найдвартай байдал бол платформын давуу тал — илгээхээсээ өмнө өөрийнхөө найдвартай байдлыг шалга:

• Latency / drop слайдер — тоглоомын траффик дээр муу сүлжээ дуурайх.
• ⚡ Blip connection — релейг унагаагаад жинхэнэ blip шиг автоматаар сэргээнэ: тоглоом GAME_DISCONNECTED авч, host дахин нэгдэж синк хийгээд GAME_RECONNECTED ирнэ. "Дахин холбогдож байна…" UX-ээ хар.
• 💀 Drop without reconnect — нөгөө таб player_connection: reconnecting, дараа нь хүлээлгийн цонхны эцэст gone харна.
• 📸 Simulate screenshot — host-ийн SCREEN_CAPTURE мессежийг илгээнэ. Компьютер дээр Usion.screen.onCapture-ыг шалгах цорын ганц арга. Harness нь screenCapture: { block: false, detect: true } (iOS-ийн хэлбэр) гэж зарлаад, апп Usion.screen.protect(true) дуудвал pill харуулна — буцаад normal болж байгаа эсэхийг хар: true үлдвэл Android дээр бүх апп даяар зураг авах боломжгүй болно.

Аудит

npx @usions/devkit audit .

Илгээхийн өмнөх статик шалгалт: хэмжээ (2MB анхааруулга / 5MB алдаа), viewport/lang/title (a11y), SDK хэрэглээ, мультиплеер бол найдвартай байдлын гэрээний handler-ууд (onAction, onDisconnect, onPlayerConnection, nextTurn). Chaos самбар нь аудитын зан төлвийн тал нь.

Загварууд

| Загвар | Юу заадаг | |--------|-----------| | turn-based-duel | Найдвартай байдлын бүрэн гэрээ: echo дээр хэрэгжүүлэх, { nextTurn }, authority setState checkpoint, дахин холболт + presence | | realtime-duel | Authoritative-peer хэв маяг: host симуляц хийж цацна, клиент оролт илгээнэ, үр дүн дараалалтай action-оор | | solo-cloud | Cloud хадгалалт, хуваалцсан тоолуур, leaderboard |

Загварууд бол хөгжүүлэгчдийн үнэхээр уншдаг баримтжуулалт — chaos самбарыг анхнаасаа давдаг; засахдаа давсан хэвээр нь байлга.

Юу эмулятор, юу жинхэнэ

Локалаар эмулятор: хэрэглэгч/хэтэвч (хуурамч үлдэгдэл, төлбөрийг авто-баталгаажуулна), төхөөрөмжийн storage (localStorage), cloud KV + leaderboard (санах ойд), тоглоомын релей (бүрэн платформ семантик, богиносгосон 5 сек хүлээлгийн цонх).

Эмулятор биш: matchmaking/урилга (платформ таныг шууд өрөөнд оруулдаг — локалаар та үргэлж dev-room-д), дуу хоолой, жинхэнэ төлбөр, модераци.

Нийтлэх

Апп тань harness дотор ажилладаг бол Usion Mini App Creator-оор илгээ, эсвэл сервис болгон бүртгүүл — платформ devkit-ийн өгдөг яг тэр usion-sdk.js-ийг суулгадаг тул кодын өөрчлөлт хэрэггүй.