Attribute
Overview
The Active Worlds SDK uses attributes for communicating data back and forth between the application and the SDK. Attributes are similar to variables in that they store values that can be queried and changed. Many attributes, are read only, meaning that they cannot be changed by the application and exist only for communicating information to the application from the SDK.
Attributes are stored per-instance. This means that in a multi-instance application setting an attribute sets it for the current instance only.
Typically, in order to pass data into the SDK, an SDK application sets one or more attributes before calling an SDK method. Once the method completes, the application then queries one or more attributes to retrieve the results of the operation or event.
Attributes can be one of five data types:
- Integer
- A 32-bit integer value. Use aw_int to query the value of integer attributes and aw_int_set to set them.
- String
- A multi-character string of 0 to 255 (in same cases up to 1000) characters. Use aw_string to query the value of string attributes and aw_string_set to set them.
- Boolean
- A boolean flag indicating either true (1) or false (0). Use aw_bool to query the value of boolean attributes and aw_bool_set to set them.
- Floating point
- A 32-bit floating point (i.e. non-integer) numeric value. Use aw_float to query the value of floating point attributes and aw_float_set to set them.
- Data
- A char* pointer to a data buffer (binary data). Use aw_data to query binary data attributes and aw_data_set to set them.
Miscellaneous attributes
Universe attributes
| Attribute | Type | Read only |
|---|---|---|
| AW_UNIVERSE_ALLOW_BOTS_CAV | Boolean | |
| AW_UNIVERSE_ALLOW_TOURISTS | Boolean | |
| AW_UNIVERSE_ALLOW_TOURISTS_CAV | Boolean | |
| AW_UNIVERSE_ANNUAL_CHARGE | String | X |
| AW_UNIVERSE_BROWSER_BETA | Integer | |
| AW_UNIVERSE_BROWSER_MINIMUM | Integer | |
| AW_UNIVERSE_BROWSER_RELEASE | Integer | |
| AW_UNIVERSE_BROWSER_RELEASE_22 | Integer | |
| AW_UNIVERSE_BUILD_NUMBER | Integer | X |
| AW_UNIVERSE_CAV_PATH | String | |
| AW_UNIVERSE_CAV_PATH2 | String | |
| AW_UNIVERSE_CITIZEN_CHANGES_ALLOWED | Boolean | X |
| AW_UNIVERSE_MONTHLY_CHARGE | String | X |
| AW_UNIVERSE_NAME | String | |
| AW_UNIVERSE_NOTEPAD_URL | String | |
| AW_UNIVERSE_OBJECT_REFRESH | Integer | |
| AW_UNIVERSE_OBJECT_PASSWORD | Data | |
| AW_UNIVERSE_REGISTER_METHOD | Integer | X |
| AW_UNIVERSE_REGISTRATION_REQUIRED | Boolean | X |
| AW_UNIVERSE_SEARCH_URL | String | |
| AW_UNIVERSE_TIME | Integer | X |
| AW_UNIVERSE_USER_LIST_ENABLED | Boolean | X |
| AW_UNIVERSE_WELCOME_MESSAGE | String | |
| AW_UNIVERSE_WORLD_BETA | Integer | |
| AW_UNIVERSE_WORLD_MINIMUM | Integer | |
| AW_UNIVERSE_WORLD_RELEASE | Integer | |
| AW_UNIVERSE_WORLD_START | String |
World attributes
Not used by the SDK
| Attribute | Type | Read only |
|---|---|---|
| AW_CONTACT_MORE | Boolean | X |
| AW_CONTACT_NAME | String | X |
| AW_CONTACT_NUMBER | Integer | |
| AW_CONTACT_OPTIONS | Integer | |
| AW_CONTACT_STATUS | Integer | X |
| AW_CONTACT_WORLD | String | X |
| AW_FILE_ADDRESS | Integer | |
| AW_FILE_PORT | Integer | |
| AW_FILE_RECIPIENT | Integer | |
| AW_FILE_SENDER | Integer | X |
| AW_FILE_SENDER_NAME | String | X |
| AW_FILE_SESSION | Integer | X |
| AW_JOIN_CITIZEN | Integer | X |
| AW_JOIN_NAME | String | X |
| AW_JOIN_WORLD | String | |
| AW_JOIN_X | Integer | |
| AW_JOIN_Y | Integer | |
| AW_JOIN_YAW | Integer | |
| AW_JOIN_Z | Integer | |
| AW_LOGIN_EMAIL | String | |
| AW_LOGIN_PRIVILEGE_NUMBER | Integer | |
| AW_REGISTER_ADDRESS | String | |
| AW_REGISTER_BUSINESS_NAME | String | |
| AW_REGISTER_CC_MONTH | String | |
| AW_REGISTER_CC_NAME | String | |
| AW_REGISTER_CC_NUMBER | String | |
| AW_REGISTER_CC_YEAR | String | |
| AW_REGISTER_CITY | String | |
| AW_REGISTER_METHOD | Integer | |
| AW_REGISTER_PHONE_NUMBER | String | |
| AW_REGISTER_RESULT | String | X |
| AW_REGISTER_STATE | String | |
| AW_REGISTER_VENDOR | String | |
| AW_REGISTER_ZIP | String | |
| AW_TELEGRAM_FROM | String | X |
| AW_TELEGRAM_MORE | Boolean | X |
| AW_TELEGRAM_SENT | Integer | X |
| AW_TELEGRAM_TEXT | String (long) | |
| AW_TELEGRAM_TO | Integer | |
| AW_VOIP_DATA | Data (long) | X |