从Unity迁移到UNIGINE

You may find the Scene View and the Editor Viewport controls looking very much alike.您可能会发现Scene View和Editor Viewport控件看起来非常相似。

Unity Scene View	UNIGINE Editor Viewport

You can use:您可以使用：

• Camera panel to switch between cameras and configure the current one.Camera panel可以在摄像机之间切换并配置当前摄像机。
• Rendering Debug to display the contents of rendering buffers the same way as using the Draw Mode in Unity Editor.Rendering Debug显示渲染缓冲区的内容，与在Unity Editor中使用Draw Mode相同。
• Navigation panel to quickly set up and switch between camera speed presets and change the camera position.Navigation panel可快速设置并在摄像机速度预设之间切换并更改摄像机位置。

Navigation inside the Editor Viewport is pretty much the same as in Unity Scene View. However, get familiar with Scene Navigation so as not to miss details.Editor Viewport中的导航与Unity Scene View中的几乎相同。但是，请熟悉场景导航，以免丢失细节。

Also, a set of global switchers is available in the top toolbar:另外，顶部的工具栏提供了一组全局切换器：

• Helpers panel provides quick access to auxiliary visualizers, such as icons, gizmos and wireframes. Helpers面板可快速访问辅助可视化工具，例如图标， gizmos 和线框。
• Precompile All Shaders toggle is used for Forced Shaders Compilation Precompile All Shaders切换用于强制着色器编译
• Animation toggle 动画 切换
• Physics toggle 物理 切换
• Audio toggle 音频 切换
• Play controls 播放控件

You can use as many Editor Viewports as you need.您可以根据需要将许多编辑器视口用作。

You are accustomed that Unity Editor has the Play mode inside the Game View which is rendered from the camera(s) in your scene, being representative of your final build.您习惯于Unity编辑器在Game View内部具有Play模式，该模式是从场景中的摄像机渲染的，表示您的最终构建。

In UNIGINE, the Play button is used to run an instance of the application in a separate window. You can switch between Play presets to change essential parameters of the play mode, such as VR Mode to enable compatibility with one of supported VR headsets, as an example.在UNIGINE中，Play按钮用于在单独的窗口中运行应用程序的实例。例如，您可以在Play预设之间切换以更改播放模式的基本参数，例如VR Mode以启用与受支持的VR耳机之一的兼容性。

By default, the mouse cursor is grabbed when clicked in the Play mode. There are two ways to setup default Input Bindings (key states and the mouse behaviour):默认情况下，在Play模式下单击时，鼠标光标将被抓住。有两种方法可以设置默认的输入绑定（键状态和鼠标行为）：

• In the Controls settings of the Editor.在编辑器的控件设置中。
• Via code.通过代码。

注意

The Engine Viewport, the Game View's counterpart in UNIGINE used for debugging and profiling, is considered excessive for projects using C# .NET 5 programming workflow (however, it is still available for other workflows).对于使用C＃.NET 5编程工作流程的项目，Engine Viewport（UNIGINE中用于调试和分析的Game View's副本）被认为过多（但是，其他工作流程仍可使用）。

As well as Unity software, UNIGINE has the Console used for standard input, output and error logging. A set of console commands is provided.除Unity软件外，UNIGINE还具有用于标准输入，输出和错误记录的控制台。提供了一组控制台命令。

It is available both in UnigineEditor and a running application. To open the Console window in the Editor, go to Windows -> Console menu:它在UnigineEditor和正在运行的应用程序中均可用。要在编辑器中打开控制台窗口，请转到Windows -> Console菜单：

A built-in console is called by pressing the grave accent (`) key:按下grave accent (`)键可以调用内置控制台：

You can use it to print user messages from code.您可以使用它从代码中打印用户消息。

You got used to building your projects via Unity Editor. In UNIGINE, packing a final build is also done via UnigineEditor.您习惯于通过Unity编辑器来构建项目。在UNIGINE中，打包最终版本也通过UnigineEditor完成。

A project in UNIGINE, just like a Unity project, is stored in its own folder, project settings are stored in the *.project file. There are various subfolders inside the project's folder, where your content and source files as well as various configuration files and binaries are stored. The most important are the data and source sub-folders.就像Unity项目一样，UNIGINE中的项目存储在其自己的文件夹中，项目设置存储在*.project文件中。项目文件夹中有多个子文件夹，其中存储了内容和源文件以及各种配置文件和二进制文件。最重要的是数据和来源子文件夹。

In UNIGINE, each project has a data folder. Similar to a Unity project's Assets folder, this is where your project's assets are stored. To import assets into your project, simply drop files into your project's data directory and they will be automatically imported and appear in the Asset Browser. The assets in the editor will update automatically as you make changes to the files using an external program.在UNIGINE中，每个项目都有一个data文件夹。类似于Unity项目的Assets文件夹，这是项目资产的存储位置。要将资产导入项目，只需将文件拖放到项目的data目录中，它们就会被自动导入并显示在资产浏览器中。当您使用外部程序对文件进行更改时，编辑器中的资产将自动更新。

Relationship between the contents of the data folder in your project's root on your computer, and the Project folder in the Asset Browser window计算机上项目根目录中的data文件夹的内容与Asset Browser窗口中的Project文件夹之间的关系

Unity software supports a wide range of file formats, while UNIGINE supports the most commonly used and some specific ones:Unity软件支持多种文件格式，而UNIGINE支持最常用的和某些特定的：

注意

If you import a group of assets containing .meta description files (for example, from a Unity project), there mights be warnings in the Console due to unsupported file format. Upon import completion, all contents in .meta files in the UNIGINE project folder will be replaced with UNIGINE native asset metadata. Source files will not be affected.如果您导入包含.meta描述文件的资产组（例如，从Unity项目中），则由于不支持的文件格式，在控制台中可能会出现警告。导入完成后，UNIGINE项目文件夹中.meta文件中的所有内容将被UNIGINE本机资产元数据替换。源文件不会受到影响。

Meshes网格

You can import an asset you used in Unity software to UNIGINE if you have it as an FBX model. While importing the FBX model to UNIGINE, check the required import options depending on the model.如果将其用作FBX模型，则可以将在Unity软件中使用的资产导入UNIGINE。将 FBX模型导入UNIGINE时，请根据模型检查所需的导入选项。

UNIGINE uses the same units (meters) as Unity software, so you don't need to rescale meshes.UNIGINE使用与Unity软件相同的单位（米），因此您无需重新缩放网格。

Materials材料

Similar to Unity software, UNIGINE works with PBR materials and supports both Metalness and Specular workflows (similar to Unity materials based on the Standard and Standard (Specular Setup) shaders), a rich out-of-the-box library of materials enables to create almost any material. So, materials created for the model in Unity software can be re-created in UNIGINE using mesh_base material, the base material in UNIGINE used for physically based materials.与Unity软件类似，UNIGINE可与 PBR材质一起使用，并支持 Metalness和Specular工作流程（类似于基于Standard和Standard (Specular Setup)着色器的Unity材质），盒式材料库可创建几乎所有材料。因此，可以使用mesh_base材料在UNIGINE中重新创建在Unity软件中为模型创建的材料，这是UNIGINE中用于基于物理的材料的基础材料。

Textures纹理

Textures can be imported as a part of a model or separately and then applied to a mesh. To import textures, you might have to do some adjustments in advance. For example, the Shading texture in UNIGINE stores the metalness, roughness, specular, and microfiber maps in its corresponding channels, so you need to modify the texture using third-party software, such as GIMP or Photoshop, and then import it to UNIGINE.可以将纹理作为模型的一部分或单独导入，然后将其应用于网格。要导入纹理，您可能需要事先进行一些调整。例如，UNIGINE中的Shading纹理将金属性，粗糙度，镜面和微纤维贴图存储在其对应的通道中，因此您需要使用第三方软件（例如GIMP或Photoshop）修改纹理，然后将其导入UNIGINE。

To import the Normal texture, you should invert the G channel. This can be done while importing the texture (or even later) by using the Invert G Channel setting.要导入Normal纹理，应反转G通道。这可以在使用Invert G Channel设置导入纹理（或什至以后）的同时完成。

Animations动画

You can import a bone-animated model you used in Unity software to UNIGINE if you have it as an FBX model. While importing the FBX model, enable the Import Animations option and fine-tune the import using additional options.如果将Unity软件中使用的骨骼动画模型用作FBX模型，则可以将其导入UNIGINE。导入FBX模型时，启用导入动画选项，并使用其他选项对导入进行微调。

For more details, see import recommendations.有关更多详细信息，请参见导入建议。

This section gives a brief description of basic scene objects in both engines as well as their basic similarities and differences.本节简要介绍了两个引擎中的基本场景对象，以及它们的基本异同。

Unity software

UNIGINE

Hierarchy window层次结构窗口 Basic scene object — GameObject. 基本场景对象-GameObject。 GameObjects are containers for all other Components. Components add functionality to the GameObject. GameObject是所有其他组件的容器。组件为GameObject添加功能。 Every GameObject has the Transform component by default. 每个GameObject默认都有Transform组件。 GameObjects can be organized into a hierarchy (parent-child relation).GameObjects可以组织成一个层次结构（父子关系）。

World Nodes Hierarchy window世界节点层次结构窗口 Node is a basic type from which all types of scene objects are inherited. Some of them appear visually: Objects, Decals, and Effects — they all have surfaces to represent their geometry (mesh), while others (Light Sources, Players, etc.) are invisible. Node是一种基本类型，从该基本类型可以继承所有类型的场景对象。其中一些可视化显示：对象，贴图和效果-它们都具有表面来表示其几何形状（网格），而其他（光源，播放器等）不可见。 Basic functionality of a node is determined by its type. Additional functionality can be added using properties and a component system.节点的基本功能由其类型决定。可以使用属性和组件系统添加其他功能。 Each node has a transformation matrix, which encodes its position, rotation, and scale in the world.每个节点都有一个转换矩阵，该矩阵对其在世界上的位置，旋转和比例进行编码。 Nodes can be organized into a hierarchy (parent-child relation).节点可以组织成一个层次结构（父子关系）。 注意 All scene objects added to the scene regardless of their type are called nodes.不论类型如何，添加到场景中的所有场景对象都称为节点。

Prefabs预制件#

The workflow in Unity software is based on prefabs. It is usual for you to assemble a complex object from GameObjects with certain components and properties and create a prefab from such object. Prefabs can then be placed in your world via Editor, or instantiated at run time.Unity软件中的工作流程基于预制件。通常，您是从 GameObjects 中组装具有某些组件和属性的复杂对象，然后从此类对象创建预制件。然后可以通过编辑器将预制件放置在您的世界中，或在运行时实例化。

UNIGINE's workflow is based on Node References that are very similar to prefabs. In order to make a complex object to be instanced in your world, you just build the desired hierarchy from nodes, assign materials and properties to them, and save it as a Node Reference. Then you can use this node reference as many times as necessary and, just like with the prefabs, modify the node reference by changing any of its instances.UNIGINE的工作流程基于与预制件非常相似的节点引用。为了使复杂的对象在您的世界中成为实例化，您只需从节点构建所需的层次结构，为其分配材质和属性，然后将其另存为Node Reference。然后，您可以根据需要多次使用此node reference，并且与预制件一样，通过更改其任何实例来修改node reference。

注意

Node References support nesting as well, so you can build complex hierarchies easily.节点引用也支持嵌套，因此您可以轻松构建复杂的层次结构。

To learn more about creating Node References and managing them, please follow the link below:要了解有关创建节点引用和管理它们的更多信息，请点击以下链接：

• Instancing Nodes实例节点
• Video tutorial: Instancing Nodes视频教程：实例化节点

How to Collaborate?如何合作？#

Cameras, the entities essential for rendering, are treated slightly differently in both engines.渲染必需的实体相机在两个引擎中的处理方式略有不同。

In Unity software, Camera component is responsible for capturing a view and sending it to render. All enabled cameras present in the scene are rendered in the viewport (Game View) and may overlap each other. To switch between cameras, one usually needs to toggle off the current camera and enable the other one.在Unity软件中， Camera 组件负责捕获视图并将其发送给渲染。场景中存在的所有启用的摄影机都在视口（游戏视图）中渲染，并且可能彼此重叠。要在摄像机之间切换，通常需要关闭一个摄像机并启用另一个摄像机。

In UNIGINE, the Camera is a rendering-related object and implemented by the Player nodes in the world. There are several player types with different behaviour provided in order to simplify creation of the most commonly used cameras controlled via the input devices (keyboard, mouse, joystick):在UNIGINE中， Camera 是与渲染相关的对象，由世界上的 Player 节点实现。为了简化通过输入设备（键盘，鼠标，操纵杆）控制的最常用摄像机的创建，提供了几种具有不同行为的播放器类型：

• Dummy is a simple camera wrapper. You can use it for static cameras or enhance with custom logic. _ Dummy是一个简单的相机包装器。您可以将其用于静态摄像机或通过自定义逻辑进行增强。
• Spectator is a free flying camera. _ Spectator是一款自由飞行的相机。
• Persecutor is a flying camera that has the target and orbits it at the specified distance. It is a ready-to-use simple solution for a third-person camera. Persecutor是具有目标并围绕指定距离运行的飞行相机。它是适用于第三人称相机的简单易用的解决方案。
• Actor is a player that is capable of providing physical interaction with scenery. It has a rigid physical body, which is approximated with a capsule shape. It is a ready-to-use simple solution for a first-person character similar to Unity Character Controller. _ ^ Actor能够为物理互动提供风景。它具有坚固的物理体，近似于胶囊形状。对于类似于Unity Character Controller的第一人称角色，它是一种易于使用的简单解决方案。

Only one player can be rendered into the viewport at a moment. To switch between cameras in the Editor Viewport of the UnigineEditor, use the Camera panel:一次只能将一个玩家渲染到视口中。要在UnigineEditor的Editor视口中切换相机，请使用Camera面板：

By checking the Main Player flag of a player you set the default player, which will be rendered when the scene is loaded in the Play mode.通过检查播放器的 主播放器 标志，您可以设置默认播放器，该默认播放器将在以Play模式加载场景时呈现。

In Unity Editor, Asynchronous Shader compilation is toggled on and off in the Editor settings (menu: Edit > Project Settings > Editor > Shader Compilation).在Unity编辑器中，在编辑器设置（菜单：Edit > Project Settings > Editor > Shader Compilation）中打开和关闭Asynchronous Shader compilation。

In UNIGINE, a similar editor feature, Forced Shader Compilation, is available via both the toolbar and the Editor section of the Settings window.在UNIGINE中，可通过工具栏和Settings窗口的Editor部分使用类似的编辑器功能Forced Shader Compilation。

You use Presets in Unity Editor when you need to reuse property settings that have bearing to different tasks, be it component settings, import settings or especially Project Settings. You can save the settings preset for a certain section of the Project Settings as a .preset asset and reuse in development later.需要重新使用与不同任务相关的属性设置时，可以在Unity编辑器中使用“预设”，无论是组件设置，导入设置还是特别是项目设置。您可以将项目设置的某个部分的预设设置保存为.preset资产，并在以后的开发中重复使用。

Presets are an Editor-only feature in Unity software.预设是Unity软件中的仅编辑器功能。

In UNIGINE, you can save and load presets for general physics, sound and render settings. The presets are stored as assets with the *.physics, *.sound and *.render extensions respectively. Use Load and Save .* asset buttons of the Settings window to work with presets of the corresponding settings section.在UNIGINE中，您可以保存和加载预设以进行常规的物理，声音和渲染设置。预设分别存储为资产，扩展名为*.physics，*.sound和*.render。使用Settings窗口的Load和Save .* asset按钮可使用相应设置部分的预设。

Saved assets appear in the Asset Browser. You can load the render settings by double-clicking the required .render asset.已保存的资产将显示在资产浏览器中。您可以通过双击所需的.render资产来加载渲染设置。

注意

By default, a UNIGINE project provides settings for low, medium, high, ultra and virtual reality quality presets stored in the data/template_render_settings folder.默认情况下，UNIGINE项目为存储在data/template_render_settings文件夹中的low, medium, high, ultra和virtual reality质量预设提供设置。

Presets are not an Editor-only feature in UNIGINE. You can use Physics, Sound and Render classes to manage presets for corresponding settings, for example, to switch between quality levels at run time.预设不是UNIGINE中的仅编辑器功能。您可以使用Physics，Sound和Render类管理相应设置的预设，例如，在运行时在质量级别之间切换。

In Unity Editor, settings for graphics quality are mostly gathered in the following sections:在Unity编辑器中，以下部分主要收集图形质量的设置：

• The Graphics section contains global settings for graphics. The Tier Settings provide platform-specific adjustments to rendering and shader compilation. One of the three Tier levels to be applied is defined automatically based on the platform used. Graphics部分包含图形的全局设置。 Tier Settings为渲染和着色器编译提供特定于平台的调整。将根据所使用的平台自动定义要应用的三个层级之一。
• The Quality section handles levels of graphical quality defined for each platform. Quality部分处理为每个平台定义的图形质量级别。

In UNIGINE, the rendering settings of the world can be found in the Render section of the Settings window. You can also toggle on and off the most common render features by using the Rendering menu:在UNIGINE中，可以在Settings窗口的Render部分中找到世界的渲染设置。您还可以使用Rendering菜单打开和关闭最常见的渲染功能：

There is no platform-dependent quiality adjustments in UNIGINE, you should write your own logic to control the quality levels. You can use Render Presets for this purpose.UNIGINE中没有依赖平台的质量调整，您应该编写自己的逻辑来控制质量水平。为此，您可以使用渲染预设。

Let's consider the most commonly used rendering settings in Unity software and their corresponding analogs in UNIGINE:让我们考虑一下Unity软件中最常用的渲染设置及其在UNIGINE中对应的类似物：

Rendering Paths渲染路径#

Post-Processing后期处理#

In Unity software, availability of post-processing effects is determined by the render pipeline used. In UNIGINE, similar effects are not a part of Post-processing but are integrated into the Rendering Sequence. Thus, Unity High Definition Render Pipeline (HDRP) is much closer to the rendering workflow in UNIGINE, than other render pipelines.在Unity软件中，后处理效果的可用性取决于所使用的渲染管道。在UNIGINE中，类似的效果不是后期处理的一部分，而是集成到渲染序列中。因此，与其他渲染管线相比，Unity High Definition Render Pipeline (HDRP)更接近UNIGINE中的渲染工作流程。

In Unity software the Volume framework is used to define the volumes where post-processing parameters and effects are locally (or globally) overridden. In UNIGINE you will have to write your own logic to smoothly interpolate between settings at different spaces (if such a requirement appears).在Unity软件中，Volume框架用于定义在局部（或全局）覆盖后处理参数和效果的体积。在UNIGINE中，您将必须编写自己的逻辑以在不同空间的设置之间进行平滑插值（如果出现此要求）。

注意

UNIGINE offers a number of materials to create image postprocessing effects out of the box. They can be applied both globally and per camera.UNIGINE提供了许多开箱即用的材质来创建图像后处理效果。 它们可以在全局和每个摄像机上应用。

This section lists all common Unity post-processing techniques that can be achieved in UNIGINE as well regardless of render pipeline.本节列出了所有通用的Unity后处理技术，无论渲染管线如何，都可以在UNIGINE中实现。

Post-Processing Effects后处理效果#

Unity software	UNIGINE
Anti-aliasing methods: FXAA TAA SMAA MSAA	Anti-aliasing methods: Fast approximate anti-aliasing (FXAA) Temporal anti-aliasing (TAA). Subpixel Reconstruction Anti-Aliasing (SRAA). Supersampling.
Ambient Occlusion	Screen-Space Ambient Occlusion
Auto Exposure	Camera Effects: Adaptive Exposure White Balance Filmic tone mapping Bloom Lens Dirt
White Balance
Tonemapping
Bloom
Color Grading: Tone Lookup Texture	Color Correction Color Correction LUT
Chromatic Aberration	Postprocess Materials: post_color_correction
Grain
Deferred Fog	Haze
Depth of Field	Depth of Field
Motion Blur	Motion Blur
Screen Space Reflection	SSR
Contact Shadows	Screen Space Shadows
Micro Shadows	Cavity of SSAO