`<Entity/>`

Entity 表示场景图节点，可包含其他实体及定义外观和行为的组件。

import { Entity } from '@playcanvas/react'

export default function Scene() {
  return (
    <Entity>
      <Entity name="child" />
      <Entity name="other-child">
        <Entity name="nested-child" />
      </Entity>
    </Entity>
  )
}

它提供位置、旋转和缩放，本身不渲染、不模拟物理，也不是摄像机，需要添加相应组件。

提示

组件是 PlayCanvas 行为的基础，通过添加组件赋予实体能力。

属性

名称	类型与说明	默认值
`name?`	`string` 实体名称。	`"Untitled"`
`position?`	`[number, number, number]` 实体相对父级的局部位置，可通过 position 属性设置。	`[0, 0, 0]`
`scale?`	`[number, number, number]` 实体相对父级的局部缩放，可通过 scale 属性设置。	`[1, 1, 1]`
`rotation?`	`[number, number, number]` 实体相对父级的局部旋转，以度为单位的欧拉角表示。	`[0, 0, 0]`
`onPointerUp?`	`PointerEventCallback` 指针抬起事件的回调。	`null`
`onPointerDown?`	`PointerEventCallback` 指针按下事件的回调。	`null`
`onPointerOver?`	`PointerEventCallback` 指针移入事件的回调。	`null`
`onPointerOut?`	`PointerEventCallback` 指针移出事件的回调。	`null`
`onClick?`	`MouseEventCallback` 点击事件的回调。	`null`
`children?`	`ReactNode`	`-`
`tags?`	`Tags` 为图节点添加标签的接口，可通过 findByTag 按标签查找。	`-`
`enabled?`	`boolean` 设置或获取 GraphNode 的启用状态。如果某个父级已禁用，不会产生额外影响；若所有父级启用，则新状态会激活或停用该节点下所有自身启用的子级。	`-`
`ref?`	`Ref<Entity> \| undefined` 获取组件实例的 ref。组件卸载时，React 将 ref.current 设为 null；若传入回调 ref，则使用 null 调用该回调。	`-`
`key?`	`Key \| null \| undefined`	`-`

属性​

属性