Appearance
status+me.virmesh.success.worldInstancesListed
world instance 一覧が正常に取得されたことを示します。
Description
me.virmesh.worldInstance.listInstance が正常終了し、WorldServer が管理する instance 一覧を返したことを示します。
When this happens
- 指定された world の instance 一覧が取得された
Payload
instance 一覧です。
References obj+me.virmesh.worldInstance.instance : WorldServer 上で稼働している world instance を表す object です。
idstringRequiredWorldServer が割り当てる instance identifier です。不透明な文字列として扱います。
worldIdstringRequiredこの instance が属する world identifier です。形式は medi:world:<scheme>:<publicKey> です。
endpointstringRequiredこの instance を管理する WorldServer の absolute URL です。
namestringOptional表示用の instance 名です。
statestringRequiredopen, full, closed のいずれかです。
playerCountintegerRequired現在参加している player 数です。
capacityintegerRequired参加可能な最大 player 数です。
joinPolicystringRequiredpublic, invite, private のいずれかです。
createdAtintegerRequiredinstance を作成した epoch second です。
updated_atintegerRequiredinstance metadata を更新した epoch second です。
worldProtocolsobject[]Requiredこの instance に接続するための protocol 一覧です。各要素は name, version, information を持ちます。
worldProtocols[].namestringRequiredprotocol identifier です。例: me.virmesh.world.websocket。
worldProtocols[].versionstringRequiredprotocol version です。
worldProtocols[].informationobjectRequired当該プロトコルがこの instance への接続に必要とするパラメータです。キー・型・意味は worldProtocols[].name で識別されるプロトコル仕様が定義します。
Client handling
state: openで capacity に余裕がある instance を接続候補として表示する- 空配列の場合、必要に応じて
createInstanceの利用可否を確認する
Referenced by
| HTTP | API | Action |
|---|---|---|
200 | me.virmesh.worldInstance.listInstance | me.virmesh.worldInstance.listInstance |