docs.unity3d.com
    Show / Hide Table of Contents

    Search assets

    You can use the Unity Asset Manager SDK package to filter assets in a project based on a set of search criteria.

    There are two workflows when searching for assets. In Asset Discovery, the CloudAssetDiscovery implementation of the IAssetProvider interface will fetch and search among published assets only, while in AssetManagement, the CloudAssetManager implementation of the IAssetProvider interface will fetch and search among all assets regardless of status.

    The implementation you choose will depend on the project roles of your users.

    Note: The Asset Discovery pathway requires users have the minimum role of Asset Management Viewer, while the Asset Management requires higher permissions with a minimum role of Asset Management Contributor.

    How do I...?

    Built-in Search Filter

    The Unity Asset Manager SDK package provides a built-in search filter that you can use to search for assets: the AssetSearchFilter class. The AssetSearchFilter class provides the set of properties that can be used to filter assets.

    Create a new search filter

    You can create a new search filter by instantiating the AssetSearchFilter class, like so:

    
    var assetSearchFilter = new AssetSearchFilter(organization, project);
    
    

    Searches are scoped to a specific organization and project. However, the instance can be reused to search for assets in different projects and organizations by updating the properties.

    • To update the search to another organization, you can use the Organization property, like so:
    
    assetSearchFilter.Organization.Include(newOrganization);
    
    
    • To update the search to another project, you can use the Project property, like so:
    
    assetSearchFilter.Project.Include(newProject);
    
    

    Each searchable property provides 3 avenues for searching:

    • Include - The property must match the value exactly.
    • Exclude - The property must not match the value.
    • Any - The property may contain the value. This represents an OR operation to be applied on all properties that include the Any value.

    To compute the search results, you can use the Search method of an IAssetProvider, like so:

    
    Pagination pagination = new Pagination(nameof(IAsset.Name), 10);
    IAssetPage results = await assetProvider.SearchAsync(assetSearchFilter, pagination, CancellationToken.None);
    
    

    The Pagination struct is used to control the number of results returned and the page of results to return. It is also used to define how the results should be sorted. In this example, the first 10 results displayed are sorted by the asset name in ascending order. The Search method returns a Task that can be awaited to get an IAssetPage containing the search results.

    Search by Name

    • You can search for assets by name using the Name property of the AssetSearchFilter class, like so:
    
    assetSearchFilter.Name.Include("my cool asset");
    
    

    Note: This type of search checks for assets whose entire name exactly matches the parameter.

    • You can also exclude assets by name, like so:
    
    assetSearchFilter.Name.Exclude("my mediocre asset");
    
    
    • You can also search for assets whose name contains a specific string, like so:
    
    assetSearchFilter.Name.ForAny("cool");
    
    

    Search by Tags

    You can search for assets by tag using the Tags property of the AssetSearchFilter class, like so:

    
    assetSearchFilter.Tags.Include("tag1", "tag2", "tag3");
    
    

    Note: This type of search checks for assets whose tag list contains all the included parameters.

    Custom Search Filter

    You can also create a custom search filter by implementing the IAssetSearchFilter interface.

    Back to top
    Terms of use
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023