子系统向导 - MRTK3

欢迎使用 混合现实 工具包子系统向导。 此工具用于通过自定义Unity XR 子系统扩展 MRTK3 的功能。 本文档介绍子系统向导、其 UI 以及如何将自定义功能添加到 MRTK3。

注意

一般情况下,建议使用子系统来实现平台或提供程序抽象。

若要使用子系统向导,必须先使用 混合现实 功能工具导入 MRTK3 工具包。

开始使用

若要开始创建新子系统,请从“MRTK3>实用工具Subsystem Wizard菜单中选择项。

启动子系统向导

启动后,子系统向导将要求你提供一些信息;即组织名称、子系统的基名称以及子系统是否需要配置数据。

提供子系统名称

组织名称

默认情况下,子系统向导将读取Unity Player 设置,并确保组织名称与项目的公司名称匹配。 此值可以覆盖为任何有效的 C# 标识符。

设置组织名称

基类名称

所有子系统都将使用基类生成。 此结构是当前体系结构所必需的,因此可以轻松实现特定于平台或提供程序的子系统版本。 建议使用子系统的名称 (例如:“ScentSubsystem”) 基类名称。

设置基类名称

添加子系统配置

如果子系统是可配置的,请选中该 Add subsystem configuration 框。

添加配置

生成的名称

向导会自动创建特定元素的名称。 在向导完成后,可以使用你喜欢的文本编辑器重写这些名称。

生成的名称

准备生成

准备好生成子系统

跳过文件生成子系统类

虽然通常不建议跳过生成一个或多个子系统文件,但在某些情况下,它可能很有用 (例如:希望重新生成单个文件) 。

注意

子系统向导不会覆盖现有文件。 若要重新生成文件,必须先将其删除。

Skip使用所需文件旁边的 选项 () 指示向导禁止生成。

完成子系统

生成完成

完成后,子系统向导将列出完成子系统实现所需的一组步骤。 列出的步骤集可能因向导设置而异。

后续步骤列表

添加代码

生成的代码包含应添加所需 (和可选) 代码的位置的指示。 这些指示器采用注释的形式,以单词 TODO 开头,包含要添加的代码的说明。 例如:

// TODO: Apply the configuration to the provider.

启用子系统

子系统准备就绪后,可以通过访问编辑>项目设置> MRTK3 在MRTK3 配置文件中启用它。

启用新的子系统