跳转至

3.1 引擎插件的使用

多媒体

3D音频播放器

1. 介绍

用于在3D空间中播放音频。该音频具有方向性,会根据距离远近衰减。 默认情况下,从摄像机位置可以听到声音。

2. 创建

点击 快速创建→多媒体→3D音频播放器 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。

3d_audio_player

3. 属性设置

3D音频播放器通过右下角的 属性面板 (见图中3处)进行设置。

  • 流:即将要播放的音频。目前支持 OGGWAVMP3 格式,可以拖动音频资源到该属性栏上进行设置。

  • 播放中:启用后,音频将开始播放。

  • 自动播放:启用后,音频将会在添加到场景树中时播放。

  • 流暂停:启用后,音频播放将暂停。

  • 最大距离:听众能听到该音频的最大距离。

  • 超范围模式:选择当听众超出最大范围时音频是否应暂停。

3D视频播放器

1. 介绍

用于在3D空间中播放视频。

2. 创建

点击 快速创建→多媒体→3D视频播放器 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。

目前支持的视频格式包括: OGVMP4FLVAVIMPEGMKVWebM ,将视频资源拖到视频属性栏(见图中3处)上即可完成设置。

3d_video_player

3. 属性设置

3D视频播放器通过右下角的 属性面板 (见图中3处)进行设置。

  • 视频:即将要播放的视频。可以拖动视频资源到该属性栏上进行设置。

  • 本地化到场景:默认为不勾选,若勾选,则每个场景都包含这个资源的一个独立拷贝。

  • 路径:该视频在项目目录下的位置。

  • 名称:视频的名称。

  • 自动播放:默认为不勾选,若勾选,则启动案例运行之后视频自动开始播放。

3D幻灯片播放器

1. 介绍

用于在3D空间中播放幻灯片。

2. 创建

点击 快速创建→多媒体→3D音频播放器 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。

3d_ppt_player

3. 属性设置

3D幻灯片播放器通过右下角的属性面板(见图中3处)进行设置。

  • PPT资源文件:即将要播放的幻灯片。目前支持 pptpptx 格式,需要先导入幻灯片,再将ppt资源拖到该属性栏上进行设置。

  • PPT的宽(像素):PPT内容显示的区域的宽。

  • PPT的高(像素):PPT内容显示的区域的高。

  • 显示PPT的网格的宽:整个PPT播放器面板显示区域的宽。

  • 显示PPT的网格的高:整个PPT播放器显示区域的宽。

  • 标题:设置PPT播放器面板左上角的标题。

  • 标题字体大小:设置PPT播放器面板左上角的标题的字体大小。

  • 当前PPT页数字体大小:设置PPT播放器面板右下角的ppt当前页数的字体大小。

  • PPT总页数字体大小:设置PPT播放器面板右下角的PPT总页数的字体大小。

  • 时间:自动播放时换页的时间间隔。

  • 自动:启动后,ppt将开启自动播放。

环境

全景天空

1. 介绍

用于在3D空间中创建全景天空。

2. 创建

点击 快速创建→环境→全景天空 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。

将全景图片(见图中3处)拖到 全景 属性栏(见图中4处)上进行设置。

sky

动态天气

1. 介绍

用于在3D空间中创建动态天气效果。

2. 创建

点击 快速创建→环境→动态天气 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。

weather

3. 属性设置

动态天气通过右下角的属性面板(见图中3处)进行设置。

  • 时间设置:设置当前时间,影响光照方向,数值范围为0点-24点。

  • 天空颜色:设置天空的颜色。

  • 风向:设置风的方向,数值范围为0°-360°。

  • 风强:设置风的强度。

  • 降雨量:设置降雨的大小。

  • 降雪量:设置降雪的大小。

  • 云层覆盖:设置云层的厚度。

  • 环境:加载预设的天气resource文件,其中可以设定的属性如下:

    • 背景:设定天空的背景颜色,天空方向以及阳光强度。

    • 环境光:设定该天空环境下的反射光颜色,反射光照强度以及天空光照的作用值。

    • 雾:设定雾气氛围。

    • 景深远模糊:设置远景模糊效果。

    • 景深近模糊:设置近景模糊效果。

    • 屏幕空间反射(SSR):若开启此效果,所有材质将利用深度缓存器和前一帧的颜色,来创建比反射探针更精准的反射。

    • 屏幕空间环境光遮蔽(SSAO):若开启,则可以表现出场景中物体在环境光照下产生的近似轮廓阴影。

    • 发光:设定当前环境光照参数。

    • 色彩校正:校正当前环境的光照色彩,如亮度、对比度、饱和度。

    • 自动曝光模式:设置曝光模式。

    • 资源:设定当前环境的预加载资源文件及其名称。

海面

1. 介绍

用于在3D空间中创建海面模型。

2. 创建

点击 快速创建→环境→海面 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。

ocean

3. 常见问题

如何制作特定形状的水面效果?

1.选择特定形状模型节点;
2.修改材质属性,选择加载选项(如图所示);
3.选择海洋材质路径:res://addons/ocean/ocean/materials/visual_water_a.resource,加载后该模型即变为海面效果。

ocean_material

地形

1. 介绍

用于在3D空间中创建地形模型。

2. 创建

点击 快速创建→环境→地形→调节地形参数 (见图中1处),弹出 生成地形 面板进行参数设置,完成后节点会在右侧 场景树 (见图中2处)中显示。

terrain

terrain_data

温馨提示

地形目录有默认目录,可以在生成地形后在底部文件系统中修改目录名称。

3. 画刷

地形画刷可以用来自由调整地形细节。

terrain_brush

图中1处:更改画刷类型,包括:

  • 提升高度、降低高度:用于改变地形高低;

  • 光滑高度:用于平滑画刷当前位置和周围的高度差;

  • 水平面:用于根据当前画刷位置和周围的高度差创建一个平滑表面;

  • 平台:用于搭建一个特定高度的平台,高度可以在图中2处设置;

  • 侵蚀:用于制造雨水侵蚀效果;

  • 地形纹理绘制:用于改变地形表面纹理,如岩石层、泥土层等;

  • 地形颜色绘制:用于改变地形表面颜色;

  • 地形草皮绘制:用于增加地形表面植被,如草皮、花朵等;

图中2处:更改画刷大小、不透明度和特殊类型的属性。

4. 属性设置

  • 环境风:用于影响当前地形上的各类植被,也会对当前场景中其他物体造成影响;

  • 组块大小:影响渲染效率,一般不需要做修改;

  • 着色器类型:主要使用4种,Classic4和Classic4Lite都是基础地形着色器,但是前者效果会比后者更好,后者效率更高;LowPoly是低多边形着色器,用于生成卡通效果的地形;Custom是自定义着色器。

  • 自定义着色器:如果想要使用自定义着色器,需要先将着色器类型设置为Custom。

5.其他设置

terrain_settings

点击 地形 按钮显示图中下拉框:

  • 导入地形:用于导入地形高度图,根据地形高度图可以生成地形模型;

  • 生成地形:用于生成/修改当前地形数据,更改地形的高低起伏;

  • 调整地形精度:用于调整地形整体精度;

  • 烘焙地形全局贴图:用于生成地形纹理图,给默认着色器进行使用;

  • 刷新地形碰撞体:用于更新地形碰撞体,防止产生穿模或悬空问题;

  • 输出高度图:用于输出当前地形数据,生成地形高度图,以便后续复用。

地形装饰

1. 介绍

用于在3D空间中添加装饰模型。

2. 创建

点击 快速创建→环境→地形装饰 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。

terrain_scatter

点击 Add 按钮添加装饰模型,然后选取想要添加到场景中的装饰模型,点击场景任意位置即可放置。

温馨提示

在地形上添加装饰模型时需要先刷新地形碰撞体,否则会导致模型漂浮在空中。

辅助功能

寻路指引

1.介绍 用于在3D空间中生成一条指示线路。支持两种模式,分别是固定线路和导航线路。

2.创建 点击 快速创建→辅助功能→寻路指引 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。 route_guidance

3.属性设置 寻路指引通过右下角的 属性面板 (见图中3处)进行设置。 - 宽度校准值:调整路径宽度; - 每米的UV:箭头密度; - 模式:切换固定线路和导航线路两种模式,切换模式后会有下面的不同参数; - 固定路径点集:固定路径需要的点。通过多个点连成线路,需要大于等于2个点; - 导航节点:导航节点路径,是一个Navigation类型的节点,需要与导航网格实例一起使用; - 导航节点起始点:导航路径起始点,一般设置为角色节点; - 导航节点终点:导航路径终点。

温馨提示

路线角度需要控制在大于等于90度,这样能取到比较好的效果;导航网格实例尽量窄一些,能取得较好的效果。

自动跟随

1.介绍 会使挂载在该节点下的节点根据参数一直跟随在选中的节点面前。

2.创建 点击 快速创建→辅助功能→自动跟随 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。 auto_follow

3.属性设置 - 启用:启用跟随; - 与节点的距离:与跟随的节点的距离; - 跟随触发的距离:当两个节点的距离大于该值,该节点及其挂载的节点会跟随移动; - 跟随触发角度:当两个节点的旋转角度大于该值,则该节点及其挂载的节点会跟随移动; - 跟随速度:跟随移动时的速度; - 固定跟随:一直触发,相对的距离和角度保持不变。 - 跟随的节点: 被跟随的节点。

VR插件

VR相机

1.介绍 支持多种VR设备的第一人称节点。新建该节点并选择适当的模式运行即可。

2.创建 点击 快速创建→相机→VR相机 进行创建(见图中1处),创建完成后节点会在右侧 场景树 (见图中2处)中显示。 vrplayer

3.属性设置 - 运行模式:分为PC,Openvr和Quad Buffered Stereo三种模式,PC模式便于调试,Openvr适配MR头盔或者Quest头盔,Quad Buffer Stereo适配cave大屏。 - 角色高度:设置player身高; - 角色半径:设置角色碰撞胶囊体的半径; - 静止:启用后不能进行移动; - 自由漫游:可以使用特定的键位进行漫游; - 世界缩放:vr世界的缩放比。

4.使用注意事项 - 使用quest头盔时,需要勾选 使用Quest 选项,这样才可以在quest头盔中使用钓鱼线瞬移。 - PC模式方便调试使用,wasd控制移动。 - Quad Buffer Stereo需要搭配专业级图形显卡及相应的多通道主动立体环境,此外,需要在 项目设置→显示→窗口→立体 中开启四立方缓冲立体。 - 更多细节可以阅读手册VR硬件内容发布及使用一节。

屏幕控件

表格插件

1.介绍 适用于在引擎中制作表格。同时在工具栏添加Marge cells按钮,可以将选中的多个单元格合并(如果可以合并) gongjulan 2.创建 在资源商店中下载导入表格插件,点击 快速创建→平面控件→表格 进行创建,创建完成后节点会在右侧 场景树 中显示。 3.属性设置 - 行:行数,可自行更改 - 列:列数,可自行更改 - 对齐:水平对齐,调整字体在水平方向上的对齐(靠左,靠右,居中等) - 垂直对齐:垂直对齐,调整字体在垂直方向上的对齐(靠左,靠右,居中等) - 字体:可添加字体,更改字体大小等,与引擎中的Font属性相同,设置的字体会同时应用到作为tablecell节点中 - 线的宽度:表格的线宽 - 线条颜色:表格线的颜色 - 默认单元格高度:添加格子时新格子的高度 - 默认单元格宽度:添加格子时新格子的宽度 - 单元格矩阵:为了在编辑器中保存变化而导出的变量,不能手动进行修改 4.使用注意事项 不能修改tablecell节点中脚本变量下的属性,不然会导致错误.

3D按钮插件

1.介绍 在3D空间中的button节点。通过新建自定义Button3D节点来使用 2.创建 在资源商店中下载导入表格插件,点击 快速创建→平面控件→3D按钮 进行创建,创建完成后节点会在右侧 场景树 中显示。 3.属性设置 - 文本:按钮文本 - 面板缩放比:控件大小 - 宽度:按钮宽度 - 高度:按钮高度 - 字体大小:文本字体大小 - 启用公告牌:开启后,按会一直朝向主相机 - 关闭深度测试:是否关闭深度测试,设置为true表示关闭深度测试 - 渲染优先级:渲染优先级 - 按钮正常状态贴图:按钮正常状态贴图 - 按钮悬浮状态贴图:按钮悬浮状态贴图 - 按钮按下状态贴图:按钮按下状态贴图 - 信号:pressed,当被点击时触发 signal

3D面板插件

1.介绍 在3D空间中的panel节点。通过新建自定义Panel3D节点来使用 2.创建 在资源商店中下载导入表格插件,点击 快速创建→平面控件→3D面板 进行创建,创建完成后节点会在右侧 场景树 中显示。 3.属性设置 - 面板缩放比:控件大小 - 宽度:面板宽度 - 高度:面本高度 - 启用公告牌:开启后,会一直朝向主相机 - 启用按钮:是否启用按钮 - 按钮文本:按钮文本 - 面板文本:面板文本 - 按钮文本文字大小:按钮文本文字大小 - 面本文本文字大小:面本文本文字大小 - 关闭深度测试:是否关闭深度测试,设置为true表示关闭深度测试 - 渲染优先级:渲染优先级 - 按钮正常状态贴图:按钮正常状态贴图 - 按钮悬浮状态贴图:按钮悬浮状态贴图 - 按钮按下状态贴图:按钮按下状态贴图 - 面板贴图:面板贴图 - 信号:button_pressed,当按钮被点击时触发 panel_signal

3D字体控件

1.介绍 可以在3D空间中输入字体并自动将字体转化为3D状态。并且可以将字体变成meshinstance。 convert_mesh 2.创建 在资源商店中下载导入表格插件, 在项目设置中启用插件qiyong 点击 快速创建→平面控件→3D字体 进行创建,创建完成后节点会在右侧 场景树 中显示。

3.属性设置 - 文本:显示的文本 - 字体大小:字体大小 - 字体:可以导入自定义字体 - 对齐:字体位置 - 颜色:字体材质的颜色 - 金属:字体材质的金属度 - 粗糙度:字体材质的粗糙度 - 发射光颜色:字体材质的发射光颜色 - 发射光强度:字体材质的发射光强度 - 拉伸:字体的拉伸程度(直观表现为字体的厚度) - 最大步长:步数越多,渲染的时间就越长 - 步长大小:较小的步长将增加渲染时间,而较大的尺寸将更快地渲染