Unity 资源管理器提供新的方式来发现、管理和共享组织内的资源。本节介绍一些基本概念,将有助于更好地理解 Unity 资源管理器的世界。
实体
实体可以是
- 一个文件,例如从您的计算机上传的文件。
- 一个数据集,其中包含文件。
- 一个资源,其中包含数据集。
每个实体都有内容和元数据。它们按照资源结构进行连接。
Unity 云资源
Unity 云资源是包含两个或更多数据集和元数据的最高级别分组实体。可以通过搜索和主库视图发现资源。
一个资源可以链接到多个项目和/或集合。
系统元数据属性
系统元数据属性是由资源管理器生成的元数据。
属性 | 描述 | 值 | 在 UI 中可见 |
---|---|---|---|
AssetId | 资源的 ID(用于 API 使用)。 | 字符串 | 是 |
集合 | 资源所属的集合列表。 | 字符串 | 是 |
创建 | 资源创建的日期和时间。 | 字符串 | 是 |
CreatedBy | 创建资源的用户 ID。 | 字符串 | 是 |
数据集 | 此资源中包含的数据集列表(具有与资源类似的元数据)。 | 数组 | 是 |
文件 | 此资源中包含的文件列表(具有与资源类似的元数据)。 | 数组 | 是 |
ProjectUri | 此资源所属的项目列表。 | 是 | |
SourceProject | 资源的源项目。 | 字符串 | 否 |
SystemTags | 系统所需的标签。 | 字符串 | 否 |
更新 | 上次资源更新的日期和时间。 | 字符串 | 是 |
UpdatedBy | 上次更新资源的用户 ID。 | 字符串 | 是 |
用户元数据属性
用户元数据属性是用户添加的元数据。
属性 | 描述 | 值 | 在 UI 中可见 |
---|---|---|---|
描述 | 资源的描述。 | 字符串 | 是 |
元数据 | 可搜索的资源自定义元数据。 | 对象 | 是 |
名称 | 资源的名称。 | 字符串 | 是 |
PreviewFilePath | 用作封面图片的文件 ID。 | 字符串 | 否 |
PrimaryType | 资源的主要类型。可能的值有:2D 资源、音频、材质、3D 模型、脚本、视频、其他。 | 字符串 | 是 |
状态 | 资源的状态。可能的值有:草稿或已发布。 | 字符串 | 是 |
SystemMetadata | 资源的自定义元数据。这些元数据不可搜索。 | 对象 | 否 |
标签 | 资源的标签 | 数组 | 是 |
进一步了解
资源结构
资源结构是指实体结构以及它们如何相互连接。资源管理器中的资源使用三级实体结构:数据集、文件和元数据
- 一个资源至少包含两个数据集:源数据集和预览数据集。
- 一个数据集至少包含一个文件。一个文件可以在多个数据集中引用,以避免在同一资源中重复数据。
- 每个实体都包含元数据。元数据可以是主元数据和/或自定义元数据。
数据集
数据集是在 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
日期和时间
用户
选择
多选
只有具有项目经理角色的用户可以创建元数据字段定义。
集合
在一个项目中,资源可以链接到一个或多个集合。集合可以嵌套。
进一步了解
有关创建集合的信息,请参见创建集合。
项目
资源管理器构建在项目的概念之上。项目是组织可以上传资源、添加用户以及为用户分配角色的地方。
进一步了解
- 有关创建项目的信息,请参见创建新项目。
- 有关管理项目中用户的更多信息,请参见管理对项目的访问权限。