Remoteadmin:admin get agents
From OpenSimulator
admin_get_agents get information about agents in a given region
Contents |
Enabling admin_get_agents
If not all functions are enabled, use admin_get_agents to enable the function in the [RemoteAdmin] section
enabled_methods = admin_get_agents,...
Parameters
Required Parameters
These parameters are required
| parameter | Description | Values |
|---|---|---|
| region_name | Name of the region to look for agents (or region_id below) | |
| region_id | UUID of the region to look for agents (or region_name above) |
Optional Parameters
These parameters are optional and do not need to be set
| parameter | Description | Values |
|---|---|---|
| include_children | If true, then return information about child agents as well as root agents. |
Returned Parameters
These parameters are returned by Remote Admin
Root
| parameter | Description | Values |
|---|---|---|
| success | true | |
| regions | Regions for which information is returned. | See regions |
Regions
| parameter | Description | Values |
|---|---|---|
| name | Name of region | |
| id | UUID of region | |
| agents | Agents found in the region requested. | See agents |
Agents
| parameter | Description | Values |
|---|---|---|
| name | Name of agent | |
| type | Type of agent | Npc or User |
| id | UUID of agent | |
| current_parcel_id | UUID of parcel the agent is currently over | |
| pos_x | X position of the agent | |
| pos_y | Y position of the agent | |
| pos_z | Z position of the agent | |
| vel_x | X velocity of the agent | |
| vel_y | Y velocity of the agent | |
| vel_z | Z velocity of the agent | |
| lookat_x | X gaze direction of the agent | |
| lookat_y | X gaze direction of the agent | |
| lookat_z | X gaze direction of the agent | |
| is_sat_on_ground | true if the agent is sat on the ground | |
| is_sat_on_object | true if the agent is sat on an object | |
| is_flying | true if the agent is flying |
Error messages
No error messages
Notes
- This was introduced in git master commit 3072f25 (OpenSimulator 0.7.6 development).
Examples
Output
(
[regions] => Array
(
[0] => Array
(
[agents] => Array
(
[0] => Array
(
[lookat_y] => 0.04238708
[lookat_z] => 0
[is_sat_on_ground] => False
[type] => User
[current_parcel_uuid] => fc2f2820-7181-4a9f-8cba-f73d3e14f72e
[name] => John Joe
[uuid] => bb293b8c-4986-4ab4-844a-5d22639f2d75
[vel_y] => 0
[vel_z] => 0
[is_flying] => False
[is_sat_on_object] => False
[pos_x] => 134.6547
[pos_y] => 122.7092
[pos_z] => 25.27129
[vel_x] => 0
[lookat_x] => 0.9991013
)
)
[uuid] => 11111111-bf88-45ac-aace-35bd76426c81
[name] => test one
)
)
[success] => 1
)
Code
PHP
'Note: the example below appears to fail on every second call because PHP's stream functions do not close the stream after use. This change occurred at git master 1dc09d8e8f4a6caa321d0227722af97ee4aeed6a (Tue Feb 5 18:02:25 2013, post OpenSimulator 0.7.5). This requires more investigation, but using CURL should work as I believe it does close the stream -- Justincc 00:53, 3 April 2013 (UTC)
$request = xmlrpc_encode_request("admin_get_agents", array("password" => "plop", "region_name" => "test one", "include_children" => "false")); $context = stream_context_create(array('http' => array( 'method' => "POST", 'header' => "Content-Type: text/xml\r\nConnection: close\r\n", 'content' => $request ))); $fp = fopen("http://localhost:5000", 'rb', false, $context); $file = stream_get_contents($fp); fclose($fp); $response = xmlrpc_decode($file); if ($response && xmlrpc_is_fault($response)) { trigger_error("xmlrpc: $response[faultString] ($response[faultCode])"); } else { print_r($response); } ?>
