Get Data for Multiple Avatars

14 May 2015

Release 8.11 - added the required entity parameter and scoping based on entity.

10 May 2015

Release 8.6 - added.

getavatarsdata (Commands)
Type	Corrade progressive command
Command	`getavatarsdata`
Description	The `getavatarsdata` returns fields or properties specified in `data` of all avatars on the current simulator or specified parcel.
Permissions	`interact`
Parameters	`group`, `password`, `entity`, `data`
Last Changes	Release 8.11 - added the required `entity` parameter and scoping based on `entity`.

The getavatarsdata returns fields or properties specified in data of all avatars on the current simulator or specified parcel.

Command Required Parameters Required Corrade Permissions Example

getavatarsdata

group, password, entity, data

interact

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // retrieves the visual parameters
            // of all the avatars in a 10m
            // range from Corrade.
            "command", "getavatarsdata",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "entity", "range",
            "range", 10,
            "data", "VisualParameters",
            "callback", wasURLEscape(URL)
        ]
    )
);

The data parameter can be supplied a CSV list of fields or properties from the libopenmetaverse Avatar structure and the libopenmetaverse Primitive structure.

Parameter	Possible Value	Sub-Parameter	Possible Value	Description
`entity`	`range`	`range`	A range in meters.	Retrieves avatar data for all avatars in the specified range where the range is the length of a versor from Corrade's current position describing a sphere.
	`parcel`	`position`	An LSL 3D Vector.	Retrieves avatar data for all avatars on the parcel pin-pointed by `position`.
	`region`			Retrieves avatar data for all avatars on the current region.
	`avatar`	`agent`	Either an avatar UUID passed to `agent` or the firstname passed to `firstname` and lastname passed to `lastname`	Retrieves avatar data for the specified avatar.
		`firstname`
		`lastname`

Notes

As the plural of the getavatardata command, the getavatarsdata command will retrieve the fields specified in the data parameter for all avatars that Corrade finds - based on the entity specified and its sub-parameters.
This command is radar-bound.