点击与互动

属性

enableInteract

默认值：false

是否允许实体进行互动。如果允许互动，走进互动范围之内，实体身上将会出现互动提示。

## interactRadius

默认值：16

实体互动范围。数值越小，则需要靠近实体才会出现互动提示。

范围有多个可互动实体，按下键盘'['或']'键，切换互动目标。

## interactHint

默认值：无

进入实体互动范围时，实体身上出现的提示文本。

## interactColor

默认值：GameRGBColor(0, 1, 0)

进入实体互动范围时，提示文本的颜色。

点击查看示例代码

// 先在场景中放置一个名称为 NPC 的实体。
const npc = world.querySelector("#NPC");
npc.enableInteract = true; // 允许进行互动
npc.interactRadius = 16; // 实体的互动范围
npc.interactHint = npc.id; // 互动提示框显示实体的名称
npc.interactColor = new GameRGBColor(1, 0, 1); // 互动提示的文字颜色

// 玩家与实体进行交互时触发
npc.onInteract(async ({ entity }) => {
  const result = await entity.player.dialog({
    type: GameDialogType.TEXT, // 对话框的类型，TEXT是文本框。
    title: npc.id, // 对话框标题为NPC名字，表示正在说话的是NPC
    lookEye: entity, // 将相机放在玩家位置
    lookTarget: npc, // 相机镜interactHint头对准NPC
    content: `你好，${entity.player.name}，很高兴认识你。`,
  });
});

方法

say()

让实体说话。

输入参数

参数	必填	默认值	类型	说明
message	是		string	说话的内容
options.duration		2000	number	气泡及广播提示语的持续时间（ms）
options.hideFloat		false	boolean	气泡内容是否在世界广播上隐藏？

点击查看示例代码

// 创建一个实体并让它每秒说一句话
const e = world.createEntity({
  position: [64, 9, 64],
});

setInterval(() => {
  e.say("hey, im a box.  my position is " + e.position.toString());
}, 1000);

onClick()

当玩家用鼠标点击实体时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到鼠标点击时的处理函数

## onInteract()

当实体进行互动时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到互动时的处理函数

## onEntityContact()

当实体触碰另一个实体时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到碰到另外的实体的处理函数

## onEntitySeparate()

当实体停止触碰另一个实体时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到停止碰到另外的实体的处理函数

## onFluidEnter()

当实体进入液体时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到进入液体的实体的处理函数

## onFluidLeave()

当实体离开液体时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到离开液体的实体的处理函数

## onVoxelContact()

当实体触碰方块时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到触碰方块的实体的处理函数

## onVoxelSeparate()

当实体停止触碰方块时触发

输入参数

参数	必填	默认值	类型	说明
handler	是		function	监听到停止触碰方块的实体的处理函数

接口

GameEntityContactEvent

当两个实体碰撞时触发的事件

参数	类型	说明
entity	GameEntity	碰撞中的第一个实体
other	GameEntity	碰撞中的第二个实体
axis	GameVector3	碰撞的分离轴，也就是碰撞后物体弹飞的方向
tick	number	两个实体碰撞的时间
force	GameVector3	碰撞所产生的力

## GameFluidContactEvent

当实体进入或离开液体时触发的事件

参数	类型	说明
entity	GameEntity	触碰液体的实体
voxel	number	液体方块 id
tick	number	实体进入或离开液体的时间

## GameVoxelContactEvent

当实体触碰方块时触发的事件

参数	类型	说明
entity	GameEntity	触碰到方块的实体
voxel	number	液体方块 id
tick	number	实体触碰方块的时间
axis	GameVector3	触碰的分离轴，也就是触碰后物体弹飞的方向
force	GameVector3	碰撞力
voxel	number	被触碰的方块 id
x	number	被触碰方块的 x 坐标
y	number	被触碰方块的 y 坐标
z	number	被触碰方块的 z 坐标