9.5 KiB
| uid |
|---|
| addressables-groups-window |
Groups window
Use the Groups window to manage your groups and Addressable assets.
The Groups window also serves as a central location for starting content builds and accessing the tools and settings of the Addressables system.
A group is the main organizational unit of the Addressables system. Use this window to create and manage your groups and the assets they contain.
The Addressables Groups window showing the toolbar and list of groups and assets.
Group list
The Group list displays the Addressable groups in your Project. Expand a group in the list to show the assets it contains. You can also expand composite assets, such as Sprite sheets, to show the subobjects they contain.
When you first install the Addressables package, the Groups window displays two groups of assets:
-
Built In Data: contains assets in any Project Resource folders and any Scenes included in the Build Settings list. (None of these assets can be Addressable unless removed from Resources or the Scene list.)
-
Default Local Group (Default): Initially empty, any assets you make Addressable are added to this group. The group is set up so that its assets are built to your local build path and included in your Project builds. You can change the name, settings, and make another group the default group, if desired. Note that the settings of the default group are also used to create shared AssetBundles.
The list columns contain the following information:
| Column | Purpose |
|---|---|
| Notifications | Any notifications regarding a Group, or asset, that is flagged during the build. |
| Group Name \ Addressable Name | The name of the item. For groups, this is an arbitrary name that you can assign. For assets, this is the Addressable address. You can edit the name or address using the context menu. |
| Icon | The Unity asset icon based on asset type. |
| Path | The path to the source asset in your Project. |
| Labels | Shows any labels assigned to the asset. Click on a Label entry to change the assigned labels or to manage your label definitions. |
You can sort the assets shown in the Group list by clicking one of the column headers. This sorts the assets within each group, but does not reorder the groups themselves. You can change the order in which your groups are displayed by dragging them into the desired position.
Groups window toolbar
The toolbar at the top of the Addressables Group window provides access to the following commands and tools:
Create
Create a group.
Choose a template for the group or Blank for no schema.
See Group templates for information about creating your own templates.
Profile
Set the active Profile to determine the paths used for building and loading Addressables.
Select an existing profile or choose Manage Profiles to open the Profiles window.
See Profiles for more information.
Tools
Choose from a menu of settings windows and tools.
- Inspect System Settings: open the Addressables Settings Inspector.
- Check for Content Update Restrictions: run a pre-update content check. See Content Workflow: Update Restrictions for more information.
- Window: open other Addressables system windows:
- Profiles: open the Profiles window.
- Labels: open the Labels window.
- Analyze: open the Analyze tool
- Hosting Services: open the Hosting window.
- Event Viewer: open the Event Viewer window.
- Groups View: set Group window display options:
- Show Sprite and Subobject Addresses: whether to show Sprite and subobjects in the Group list or just the parent object.
- Group Hierarchy with Dashes: when enabled, the Groups window displays groups that contain dashes '-' in their names as if the dashes represented a group hierarchy. For example, if you name two groups "x-y-z" and "x-y-w", the the window shows an entry called "x" with a child called "y", which contains two groups, called "x-y-z" and "x-y-w". Enabling this option affects the group display only.
- Convert Legacy AssetBundles: Assigns non-Addressable assets to Addressable groups based on their current AssetBundle settings.
Play Mode Script
Set the active Play Mode Script.
The active Play Mode Script determines how Addressables are loaded in the Editor Play mode. See Play Mode Scripts for more information.
Build Script
Select a content build command.
- New Build: choose a build script to run a full content build.
- Update a Previous Build: run a differential update based on an earlier build.
- Clean Build: choose a command to clean existing build artifacts.
See Builds for more information.
Filter list
Find items in the group list matching the specified string.
An item is shown if the specified string matches any part of the text in any column in the list.
Tip
Click the magnifying glass icon to enable or disable Hierarchical Search, which shows results within their assigned group rather than as a flat list.
Play Mode Scripts
The active Play Mode Script determines how the Addressable system accesses Addressable assets when you run your game in the Editor Play mode. When you select a Play Mode Script, it remains the active script until you choose a different one. The Play Mode Script has no effect on asset loading when you build and run your application outside the Editor.
The Play Mode Scripts include:
- Use Asset Database: loads assets directly from the Editor asset database (which is also used for all non-Addressable assets). You do not have to build your Addressable content when using this option.
- Simulate Groups: analyzes content for layout and dependencies without creating AssetBundles. Loads assets from the asset database through the ResourceManager as if they were loaded through bundles. Simulates download speeds for remote AssetBundles and file loading speeds for local bundles by introducing a time delay. You can use the Event Viewer with this Play Mode script. See ProjectConfigData for configuration options.
- Use Existing Build: loads Assets from bundles created by an earlier content build. You must run a full build using a Build Script such as Default Build Script before using this option. Remote content must be hosted at the RemoteLoadPath of the Profile used to build the content.
To find an asset
To locate an Addressable Asset in the Groups window, type all or part of its address, path, or a label into the filter control on the Groups window toolbar.
Filtering the group list by the string "NP" to find all assets labeled NPC
To locate the asset in your project, select it in the Groups window. Unity then selects the asset in the Project window and displays the asset's details in the Inspector window.
Tip
- To view the groups of the assets found, enable Hierarchical Search; disable this option to only show groups if they match the search string. Click the magnifying glass icon in the search box to enable or disable Hierarchical Search.
- To view subobject addresses, such as the Sprites in a Sprite Atlas, enable the Show Sprite and Subobject Addresses option using the Tools menu on the Groups window toolbar.