基本概念

了解 Unity 资源管理器用来根据工作上下文对资源进行分类的概念术语。

阅读时间25分钟
上次更新5 个月前

Unity 资源管理器提供新的方式来发现、管理和共享组织内的资源。本节介绍一些基本概念,将有助于更好地理解 Unity 资源管理器的世界。

实体

实体可以是

  • 一个文件,例如从您的计算机上传的文件。
  • 一个数据集,其中包含文件。
  • 一个资源,其中包含数据集。

每个实体都有内容和元数据。它们按照资源结构进行连接。

Unity 云资源

Unity 云资源是包含两个或更多数据集和元数据的最高级别分组实体。可以通过搜索和主库视图发现资源。

一个资源可以链接到多个项目和/或集合。

系统元数据属性

系统元数据属性是由资源管理器生成的元数据。

属性描述在 UI 中可见
AssetId资源的 ID(用于 API 使用)。字符串
集合资源所属的集合列表。字符串
创建资源创建的日期和时间。字符串
CreatedBy创建资源的用户 ID。字符串
数据集此资源中包含的数据集列表(具有与资源类似的元数据)。数组
文件此资源中包含的文件列表(具有与资源类似的元数据)。数组
ProjectUri此资源所属的项目列表。
SourceProject资源的源项目。字符串
SystemTags系统所需的标签。字符串
更新上次资源更新的日期和时间。字符串
UpdatedBy上次更新资源的用户 ID。字符串

用户元数据属性

用户元数据属性是用户添加的元数据。

属性描述在 UI 中可见
描述资源的描述。字符串
元数据可搜索的资源自定义元数据。对象
名称资源的名称。字符串
PreviewFilePath用作封面图片的文件 ID。字符串
PrimaryType资源的主要类型。可能的值有:2D 资源、音频、材质、3D 模型、脚本、视频、其他。字符串
状态资源的状态。可能的值有:草稿或已发布。字符串
SystemMetadata资源的自定义元数据。这些元数据不可搜索。对象
标签资源的标签数组

进一步了解

  • 有关创建资源的更多信息,请参见添加资源
  • 有关在项目中查找资源的更多信息,请参见发现资源

资源结构

资源结构是指实体结构以及它们如何相互连接。资源管理器中的资源使用三级实体结构:数据集、文件和元数据

  1. 一个资源至少包含两个数据集:源数据集和预览数据集。
  2. 一个数据集至少包含一个文件。一个文件可以在多个数据集中引用,以避免在同一资源中重复数据。
  3. 每个实体都包含元数据。元数据可以是主元数据和/或自定义元数据。
A dataset contains files. Each file within a dataset can include metadata. Each asset can include metadata.

数据集

数据集是在 Unity 资源管理器中附加到资源的版本化文件集。默认情况下,资源包含两个数据集:源数据集和预览数据集。

您可以使用 API 调用和资源 ID 创建自定义数据集。创建的数据集可用作添加您希望下载、预览或流式传输的文件的输入工作流。工作流可以输出数据集。

当数据集从所有资源中删除时,它将自动删除。

系统生成的属性

属性描述在 UI 中可见
创建数据集创建的日期和时间。字符串
CreatedBy创建数据集的用户 ID。字符串
DatasetID数据集的 ID(用于 API 使用)。字符串
FilesOrder通过一组 FilePaths 对文件进行排序。此属性使预览在 UI 中保持排序。数组
SystemTags系统所需的标签。字符串
更新上次数据集更新的日期和时间。字符串
UpdatedBy上次更新数据集的用户 ID。字符串
WorkflowName用于创建数据集的工作流名称。字符串

用户生成的属性

属性描述在 UI 中可见
描述数据集的描述。字符串
IsVisible数据集是否应该在 UI 上可见布尔值
元数据可搜索的数据集自定义元数据对象
名称数据集的名称。字符串
PreviewFilePath资源封面图片的文件路径。字符串
SystemMetadata数据集的自定义元数据。这些元数据不可搜索。对象
标签数据集的标签。数组

文件

文件是资源管理器中的最低实体级别。文件上传到数据集,该数据集附加到一个或多个资源。文件的唯一标识符是它在资源中的文件路径。

名称由以下生成在 UI 中可见描述
FilePath系统文件的文件名和路径。用作唯一标识符
描述用户(可选)
标签用户(可选)
SystemTags系统系统所需的标签
CreatedBy系统创建文件的用户 ID
创建系统文件创建的日期和时间
UpdatedBy系统上次更新文件的用户 ID
更新系统文件的上次更新日期和时间
元数据用户可搜索的文件自定义元数据
SystemMetadata用户不可搜索的文件自定义元数据
FileSize用户(API)文件大小
UserChecksum系统可用于校验和用例的可用字段
PortalMetadata系统由前端使用以存储额外数据

元数据

元数据包含所有用于帮助识别、描述和发现实体的原始信息。元数据有两种类型:主元数据和自定义元数据。元数据存在于三个不同的级别

  • 文件级别
  • 数据集级别
  • 资源级别

主元数据

每个实体都有主元数据,这是资源的基本信息,或者系统工作所需的必要信息。

自定义元数据

资源可以具有自定义元数据,以进一步帮助识别、描述和发现它们。您可以使用组织库中的元数据字段向资源添加自定义元数据字段。自定义元数据由其名称、值和定义定义。

元数据字段定义

每个组织都有一个元数据字段库。每个元数据字段包含以下信息

  • name:元数据的唯一标识符。
  • displayName:元数据的显示名称,用于资源管理器 UI 中。
  • type:元数据的类型,可以是
    • 文本
    • 数字
    • 布尔值
    • URL
    • 日期和时间
    • 用户
    • 选择
    • 多选

只有具有项目经理角色的用户可以创建元数据字段定义。

集合

在一个项目中,资源可以链接到一个或多个集合。集合可以嵌套。

进一步了解

有关创建集合的信息,请参见创建集合

项目

资源管理器构建在项目的概念之上。项目是组织可以上传资源、添加用户以及为用户分配角色的地方。

进一步了解