助けて
開発FAQ

MATCHMAKE_UNHANDLED エラーが発生しました

5min

QRテスト中にMATCHMAKE_UNHANDLEDエラーが発生した場合は、以下の方法を試して解決してください。

Document image




マルチプレイサーバースクリプト(index.ts)を確認してください。

  • このエラーコードは、クライアントがマルチプレイサーバーに接続した後、サーバーからマルチプレイルームの状態データをスムーズに受信できない場合に発生する可能性があります。
  • 以下のチュートリアルを参照し、サーバースクリプト(index.ts)のonCreate/onJoin部分のコードを確認してください。

📘 以下のガイドを参照してください。ZEPETOマルチプレイチュートリアル



ZEPETO WORLD SDKのバージョンを最新のものに更新してください。

  • 以下のガイドを参照して、ZEPETO WORLD SDKのバージョンが最新であるか確認し、最新バージョンに更新してください。

📘 以下のガイドを参照してください。パッケージの更新



Zepeto World Multiplayコンポーネントを確認してください。

  • Zepeto World Multiplayコンポーネントが異なるシーンに存在する場合、このエラーが発生する可能性があります。
  • Zepeto World Multiplayコンポーネントを1つのシーンにのみ追加し、以下のサンプルコードに従ってシングルトンとして実装してください。
TypeScript