asset-transformer-toolkit

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Before you start: check the package version

开始之前:检查包版本

This skill needs Asset Transformer Toolkit 4.0.0 or later (
com.unity.industry.toolkit
). Earlier versions don't have the
ATTAssistantUtilities
API every workflow below relies on.
  1. Read the resolved version of
    com.unity.industry.toolkit
    from
    Packages/packages-lock.json
    (fall back to
    Packages/manifest.json
    ).
  2. Not installed: tell the user this workflow needs Asset Transformer Toolkit 4.0 or later, which is an entitled Unity package they may need access to through their Unity plan, and stop. Don't add it to the manifest yourself.
  3. Installed below 4.0.0: tell the user which version you found and that 4.0 or later is required, and ask before upgrading. Don't fall back to older APIs, raw C# against internal types, or reflection.
  4. 4.0.0 or later: continue.
此skill需要Asset Transformer Toolkit 4.0.0或更高版本(
com.unity.industry.toolkit
)。更早版本没有下方所有工作流所依赖的
ATTAssistantUtilities
API。
  1. 从
    Packages/packages-lock.json
    读取
    com.unity.industry.toolkit
    的已解析版本(若不存在则回退到
    Packages/manifest.json
    )。
  2. 未安装: 告知用户此工作流需要Asset Transformer Toolkit 4.0或更高版本,这是一个受权利的Unity包,可能需要通过其Unity计划获得访问权限,然后停止。不要自己将其添加到manifest。
  3. 已安装但低于4.0.0: 告知用户你找到的版本,并说明需要4.0或更高版本,在升级前征询用户意见。不要回退到旧API、针对内部类型的原始C#或反射。
  4. 4.0.0或更高版本: 继续。

API Reference

API参考

Tool functions are provided by
Unity.Pixyz.Plugin4Unity.Editor.AI.ATTAssistantUtilities
. They are documented inline in each reference file below alongside the classes they operate on.
工具函数由
Unity.Pixyz.Plugin4Unity.Editor.AI.ATTAssistantUtilities
提供。每个参考文件都内联记录了这些函数及其操作的类。

Technical Notes

技术说明

Pixyz Plugin is the former name of Asset Transformer Toolkit. Prefer using the term 'Asset Transformer Toolkit' when addressing the user, unless the user is using the term 'Pixyz' Most classes and code are in the Unity.Pixyz.Plugin4Unity.Editor assembly. Asset Transformer Toolkit is NOT the same thing as Asset Transformer Studio/Pixyz Studio. NEVER rely on information about Asset Transformer Studio.
Pixyz Plugin是Asset Transformer Toolkit的旧名称。与用户交流时,优先使用术语'Asset Transformer Toolkit',除非用户正在使用'Pixyz'这个术语。 大多数类和代码位于Unity.Pixyz.Plugin4Unity.Editor程序集中。 Asset Transformer Toolkit与Asset Transformer Studio/Pixyz Studio不是同一产品。切勿依赖有关Asset Transformer Studio的信息。

Importers

导入器(Importers)

Asset Transformer Toolkit can import 3D file from outside the project. When modifying Importers, NEVER assume it should be immediately followed by a reimport. The import process can be very long, so it must only be launched when the user requests it. Modify fields in Importers using the ScriptableObject API. NEVER use reflection to access or modify Importer fields — reflection is not available. To create a Pixyz/Asset Transformer Toolkit Importer for importing a file, or to reimport a model using an existing ImporterScriptableObject, read references/create-importer
Asset Transformer Toolkit可以从项目外部导入3D文件。 修改Importers时,绝不要假设紧接着就需要重新导入。导入过程可能非常耗时,因此只有在用户要求时才启动。 使用ScriptableObject API修改Importers中的字段。切勿使用反射访问或修改Importer字段——反射不可用。 要创建用于导入文件的Pixyz/Asset Transformer Toolkit Importer,或使用现有ImporterScriptableObject重新导入模型,请阅读references/create-importer

RuleSets and Actions

RuleSets和Actions

Read references/rulesets-and-actions Read api-docs/ruleset-api when the RuleSet API is needed. Read api-docs/rule-api when the Rule API is needed. Read api-docs/ruleblock-api when the RuleBlock API is needed, including
ActionBase.Id
for constructing
RuleBlock
instances.
阅读references/rulesets-and-actions 当需要RuleSet API时,阅读api-docs/ruleset-api。 当需要Rule API时,阅读api-docs/rule-api。 当需要RuleBlock API(包括用于构造
RuleBlock
实例的
ActionBase.Id
)时,阅读api-docs/ruleblock-api。

Levels of Detail

细节级别(Levels of Detail)

Read references/lods
阅读references/lods