Skip to content

status+me.virmesh.success.worldInstancesListed

world instance 一覧が正常に取得されたことを示します。

successdraft

Description

me.virmesh.worldInstance.listInstance が正常終了し、WorldServer が管理する instance 一覧を返したことを示します。

When this happens

  • 指定された world の instance 一覧が取得された

Payload

payload.instancesworldInstance[]Required

instance 一覧です。

References obj+me.virmesh.worldInstance.instance : WorldServer 上で稼働している world instance を表す object です。

idstringRequired

WorldServer が割り当てる instance identifier です。不透明な文字列として扱います。

worldIdstringRequired

この instance が属する world identifier です。形式は medi:world:<scheme>:<publicKey> です。

endpointstringRequired

この instance を管理する WorldServer の absolute URL です。

namestringOptional

表示用の instance 名です。

statestringRequired

open, full, closed のいずれかです。

playerCountintegerRequired

現在参加している player 数です。

capacityintegerRequired

参加可能な最大 player 数です。

joinPolicystringRequired

public, invite, private のいずれかです。

createdAtintegerRequired

instance を作成した epoch second です。

updated_atintegerRequired

instance metadata を更新した epoch second です。

worldProtocolsobject[]Required

この instance に接続するための protocol 一覧です。各要素は name, version, information を持ちます。

worldProtocols[].namestringRequired

protocol identifier です。例: me.virmesh.world.websocket

worldProtocols[].versionstringRequired

protocol version です。

worldProtocols[].informationobjectRequired

当該プロトコルがこの instance への接続に必要とするパラメータです。キー・型・意味は worldProtocols[].name で識別されるプロトコル仕様が定義します。

Client handling

  • state: open で capacity に余裕がある instance を接続候補として表示する
  • 空配列の場合、必要に応じて createInstance の利用可否を確認する

Referenced by

HTTPAPIAction
200me.virmesh.worldInstance.listInstanceme.virmesh.worldInstance.listInstance