search

secondlife / jira-archive

2 stars 0 forks source link

[BUG-232312] [Feature Request] Repurpose the currently unused "options" list input parameter for llGetAgentList(). #9613

Open sl-service-account opened 2 years ago

sl-service-account commented 2 years ago

Information

Currently, the "options" list input parameter for llGetAgentList() has no available constants nor functionality.

https://wiki.secondlife.com/wiki/LlGetAgentList

During some of SL19B's events, I was reminded of llGetAgentList()'s current cap of 100 agents as not all users were being reported.

There are also feature requests filed for inputs to limit the function's key count return.

https://jira.secondlife.com/browse/BUG-40680

I believe to make the function more efficient, we need the ability to return only the agents that entered the region in a given time instead of having to loop through the entire list and compare entries to, yet, another stored/maintained list, essentially using double the memory.

This feature request is for the following integer constants and the behavior of the input values that follow:

AGENT_LIST_LIMIT - The integer input following this constant is a value limiting the returned key count.

This also overrides the function's current default limit of 100, allowing more or less than 100 if needed.

AGENT_LIST_REGION_ENTRY_START_TIME - The integer input following this constant is a value used to filter agents based on the unix time they entered the region.

Agents that entered the region before this time are excluded from the returned list.

AGENT_LIST_REGION_ENTRY_END_TIME - The integer input following this constant is a value used to filter agents based on the unix time they entered the region.

Agents that entered the region after this time are excluded from the returned list.

So, for example, if you needed to get 10 agents that entered the region in the last minute, you'd use llGetAgentList(AGENT_LIST_REGION, [AGENT_LIST_LIMIT, 10, AGENT_LIST_REGION_ENTRY_START_TIME, llGetUnixTime() - 60, AGENT_LIST_REGION_ENTRY_END_TIME, 0x7fffffff]);

If more than 10 agents entered during that time and you wanted to return the full list, you would omit using AGENT_LIST_LIMIT, but at least you now have that option.

 

Links

Related

Original Jira Fields | Field | Value | | ------------- | ------------- | | Issue | BUG-232312 | | Summary | [Feature Request] Repurpose the currently unused "options" list input parameter for llGetAgentList(). | | Type | New Feature Request | | Priority | Unset | | Status | Accepted | | Resolution | Accepted | | Reporter | Lucia Nightfire (lucia.nightfire) | | Created at | 2022-06-29T00:33:12Z | | Updated at | 2022-11-08T20:54:37Z | ``` { 'Build Id': 'unset', 'Business Unit': ['Platform'], 'Date of First Response': '2022-06-29T13:06:47.472-0500', 'How would you like the feature to work?': 'Currently, the "options" list input parameter for llGetAgentList() has no available constants nor functionality.\r\n\r\nDuring some of SL19B\'s events, I was reminded of llGetAgentList()\'s current cap of 100 agents as not all users were being reported.\r\n\r\nThere are also feature requests filed for the function to be limited to less than 100 agents as well to give control over memory usage.\r\n\r\nI believe to make the function even more efficient, we also need the ability to return only the agents that entered the region since the last time the function was called instead of having to loop through the entire list and compare entries to, yet, another stored/maintained list, essentially using double the memory.\r\n\r\nThis feature request is for the following integer constants and the behavior of the input values that follow:\r\n\r\nAGENT_LIST_LIMIT - The integer input following this constant is a value limiting the return key count. This also overrides the functions current default limit of 100.\r\n\r\nAGENT_LIST_REGION_ENTRY_START_TIME - The integer input following this constant is a value used to filter agents based on the unix time they entered the region. Agents that entered the region before this time are excluded from the return list.\r\n\r\nAGENT_LIST_REGION_ENTRY_END_TIME - The integer input following this constant is a value used to filter agents based on the unix time they entered the region. Agents that entered the region after this time are excluded from the return list.\r\n\r\nSo, for example, if you wanted to know the last 10 out of 135 agents that last entered the region, you\'d use llGetAgentList(AGENT_LIST_REGION,[AGENT_LIST_LIMIT,10,AGENT_LIST_REGION_ENTRY_START_TIME,llGetUnixtime(),AGENT_LIST_REGION_ENTRY_END_TIME,0x7fffffff]);\r\n\r\nhttps://wiki.secondlife.com/wiki/LlGetAgentList', 'ReOpened Count': 0.0, 'Severity': 'Unset', 'Target Viewer Version': 'viewer-development', 'Why is this feature important to you? How would it benefit the community?': '?', } ```
sl-service-account commented 2 years ago

Spidey Linden commented at 2022-06-29T18:06:47Z

Issue accepted. We have no estimate when it may be implemented. Please see future release notes for this fix.