registry.list / onList¶
Requests the current list of registered game hosts from the registry server.
Request¶
| Field | Value |
|---|---|
| Method | registry.list |
| Return Method | onList |
| Arguments | 0 |
The controller sends this call immediately after a successful registry.register. No arguments are required.
Response: onList¶
The server responds by invoking onList on the caller:
| # | Type | Description |
|---|---|---|
| 1 | BMArray |
An array of BMRegistryInfo objects, one per registered game host. |
Each BMRegistryInfo in the array contains the host's device identity, network address, app ID, slot ID, and player counts. See BMRegistryInfo.
Behavior¶
Controllers¶
The controller populates its host list from the received array. This is the initial discovery mechanism; subsequent changes are delivered via onHostConnected, onHostDisconnected, and onHostUpdate push notifications.
Game Hosts¶
Game hosts can receive onList. They scan the array for their own deviceId to confirm the server-assigned slotId.