WoW:API NotifyInspect: Difference between revisions
Jump to navigation
Jump to search
(Created page with 'Requests a unit's inventory and talent information from the server, allowing you to inspect the unit. NotifyInspect("unit") == Arguments == ; unit : String (unitId) - Unit …') |
m (Move page script moved page API NotifyInspect to API NotifyInspect without leaving a redirect) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 4: | Line 4: | ||
== Arguments == | == Arguments == | ||
; unit : String ([[unitId]]) - Unit to request inventory contents of. | ; unit | ||
: String ([[unitId]]) - Unit to request inventory contents of. | |||
== Fires events == | == Fires events == | ||
* {{api|t=e|UNIT_INVENTORY_CHANGED}}(unit) when inventory information is updated for the inspected unit. | * {{api|t=e|UNIT_INVENTORY_CHANGED}}(unit) when inventory information is updated for the inspected unit. | ||
* {{api|t=e| | * {{api|t=e|INSPECT_READY}} when talents are available for inspection. | ||
== Details == | == Details == | ||
* You must be in inspection range of the unit (use {{api|CheckInteractDistance}} to check), and must be able to inspect the unit (use {{api|CanInspect}} to check) to request inventory information. | * You must be in inspection range of the unit (use {{api|CheckInteractDistance}} to check), and must be able to inspect the unit (use {{api|CanInspect}} to check) to request inventory information. | ||
* Information about which items the inspected unit has equipped is available immediately after calling NotifyInspect; however, information about socketed gems is available until UNIT_INVENTORY_CHANGED. | * Information about which items the inspected unit has equipped is available immediately after calling NotifyInspect; however, information about socketed gems is available until UNIT_INVENTORY_CHANGED. | ||
* Since [[Patch 3.3.5]], it is no longer guaranteed that the server will provide inventory information for every request; should the server choose to throttle a particular request, events indicating availability of inspection data will not fire. | * Since [[Patch 3.3.5]], it is no longer guaranteed that the server will provide inventory information for every request; should the server choose to throttle a particular request, events indicating availability of inspection data will not fire. Tested to be throttled after ~6 requests per 10 seconds (09.03.2019). | ||
* You should call {{api|ClearInspectPlayer}} once you're no longer interested in the inspected unit's inventory; this will stop WoW from receiving additional inventory/talent change notifications for the unit. | * You should call {{api|ClearInspectPlayer}} once you're no longer interested in the inspected unit's inventory; this will stop WoW from receiving additional inventory/talent change notifications for the unit. | ||
Latest revision as of 04:46, 15 August 2023
← WoW API < NotifyInspect
Requests a unit's inventory and talent information from the server, allowing you to inspect the unit.
NotifyInspect("unit")
Arguments
- unit
- String (unitId) - Unit to request inventory contents of.
Fires events
- UNIT_INVENTORY_CHANGED(unit) when inventory information is updated for the inspected unit.
- INSPECT_READY when talents are available for inspection.
Details
- You must be in inspection range of the unit (use CheckInteractDistance to check), and must be able to inspect the unit (use CanInspect to check) to request inventory information.
- Information about which items the inspected unit has equipped is available immediately after calling NotifyInspect; however, information about socketed gems is available until UNIT_INVENTORY_CHANGED.
- Since Patch 3.3.5, it is no longer guaranteed that the server will provide inventory information for every request; should the server choose to throttle a particular request, events indicating availability of inspection data will not fire. Tested to be throttled after ~6 requests per 10 seconds (09.03.2019).
- You should call ClearInspectPlayer once you're no longer interested in the inspected unit's inventory; this will stop WoW from receiving additional inventory/talent change notifications for the unit.