<script setup>
import '/style.css'
</script>
# 点击与互动
## 属性

#### <font id="API" />rendering3d<font id="Type">: boolean</font>{#rendering3d} 
> 默认值：true

控制是否渲染3D场景。
- 当关闭(false)时，3D 场景的渲染将在客户端暂停，画面会停留在最后一次渲染的状态。
- 2D UI界面不受此属性影响，除 3D 渲染外的客户端行为不受此属性影响。

::: details 性能优化与游戏设计中的应用场景

#### 截图和录像

当玩家想要截取游戏世界的屏幕截图或录制游戏录像时，可能需要一个稳定的画面。通过将`rendering3d`设置为`false`，可以暂停3D渲染，从而确保在截图或录像时画面不会发生变化，提高截图和录像的质量，让玩家能够留下美好的回忆。


#### 性能优化

在某些情况下，为了节省计算资源或提高游戏性能，创作者可能希望暂时关闭3D渲染。例如，当玩家切换到游戏的设置菜单或进行某些不需要实时3D渲染的操作时，可以通过将`rendering3d`设置为`false`来减少CPU和GPU的负担，从而提升整体的游戏流畅度和响应速度。

#### 游戏设计

在某些游戏设计中，可能需要实现一种“时间暂停”或“画面定格”的效果，让玩家可以仔细查看游戏世界的某个部分，而不希望3D场景继续动态变化。这时，通过将`rendering3d`设置为`false`可以实现这一效果，同时保持2D UI的响应性，以便玩家可以继续与游戏进行交互，如查看角色信息、调整装备等。


#### 故障排查

在开发和测试阶段，创作者可能需要诊断游戏世界中的某些问题。通过将`rendering3d`设置为`false`，可以暂停3D渲染，从而更容易地观察和分析游戏世界的静态状态，有助于定位和解决问题，提高游戏的稳定性和可靠性。

#### 过场动画

在游戏过程中，过场动画通常用来展示故事情节或关键事件。在这些动画播放时，可能不需要实时渲染3D游戏世界，因为动画本身可能已经包含了所有的视觉效果。通过将`rendering3d`设置为`false`，可以确保3D游戏世界不会干扰过场动画的播放，同时节省计算资源，使动画播放更加流畅。




#### 低配置设备优化

对于配置较低的设备来说，实时渲染3D游戏世界可能会很吃力。通过提供一个选项来关闭3D渲染（将`rendering3d`设置为`false`），可以确保这些设备上的玩家仍然能够享受游戏，尽管游戏体验可能会以2D形式呈现，但这也为玩家提供了更多的选择和灵活性。

#### 游戏教学

在教学关卡或教程中，有时需要向玩家展示特定的游戏机制或操作。通过将`rendering3d`设置为`false`，可以暂停游戏世界的动态变化，从而更容易地引导玩家完成教学步骤，帮助他们更快地掌握游戏技巧和提高游戏水平。

:::


::: details 点击查看示例代码
```javascript
const renderingBtn = ui.findChildByName('rendering3d');
renderingBtn.events.on('pointerdown', () => {
    console.info('渲染开关！');
    world.rendering3d = !world.rendering3d;
})
```
:::



