# 事件

<callout>事件在Spine Essential版中不可用。</callout>

事件是在动画过程中触发某件事情的触发器。在Spine编辑器中，可以将事件设置为播放音频。在其他方面，事件应该在运行时处理，你可以在运行时编写代码以执行任何你喜欢的动作来响应事件。例如，产生粒子效果、伤害敌人、开门等等。

音频事件的音频播放是Spine编辑器中的一项功能，Spine运行时并不管理音频播放。在运行时，需要编写代码来[处理事件](/spine-applying-animations#侦听器)，并使用事件的音频路径、音量和均衡属性播放相应的音频。

从Spine导出的视频可以包含来自音频事件的音频。有关更多详细信息，请参见[AVI导出](/spine-export#AVI)和[MOV导出](/spine-export#MOV)。

# 设置

选择层级树中的`事件`节点，然后点击`新建...` `事件`可创建事件。

![](/img/spine-user-guide/events/new.png)

# 属性

![](/img/spine-user-guide/events/properties.png)

`整数`、`浮点数`和`字符串`属性是为事件提供额外信息或上下文的值。设置姿势有这些值的默认值，并且每个事件关键帧可能有不同的值。

## 整数

存储整数，不带小数部分。它可以[设置关键帧](/spine-keys#事件)。

## 浮点数

存储可能包含小数部分的数字。它可以[设置关键帧](/spine-keys#事件)。

## 字符串

存储文本字符串。它可以[设置关键帧](/spine-keys#事件)。

## 音频路径

设置音频路径后，在播放动画时遇到该事件的关键帧时，Spine编辑器将播放相应的音频文件。更多信息请参见[查找音频文件](#查找音频文件)。

一旦设置了音频路径，事件就会变成[音频事件](#音频事件)，并且会出现`音量`和`均衡`属性。

### 音量

用于设置Spine编辑器播放音频事件时的播放音量。它可以[设置关键帧](/spine-keys#事件)。

### 均衡

设置Spine编辑器播放音频事件时的均衡度。它可以[设置关键帧](/spine-keys#事件)。

对于双声道音频，此选项可设置左右声道的音量。对于单声道音频，这将向左或向右平移音频。

# 音频节点

层级树中的`音频`节点有一个指向文件夹的路径，Spine将在该文件夹中查找骨骼的wav、mp3和ogg音频文件。音频路径可以是项目文件保存位置的相对路径，也可以是绝对路径。可以使用`浏览`按钮指定路径，也可以输入路径，然后按`Enter`。设置路径后，该文件夹中的音频文件会出现在`音频`节点下。Spine会监视该音频文件夹，并会立即加载对音频文件的任何更改。

![](/img/spine-user-guide/events/audio.png)

默认情况下，仅显示音频文件夹中找到的前2,000个音频文件。这可防止Spine在意外指定错误路径时扫描数百万个文件。取消选中`限制扫描`可允许Spine查找超过2,000个音频文件。

## 音频事件

“音频事件”是设置了[音频路径](#音频路径)的事件。可以通过键入音频路径或将音频文件拖动到层级树中的事件来设置音频路径。

或者，也可以通过选择音频文件，然后单击层级树属性中的`新建事件`来创建新的音频事件。这将创建具有相同名称的事件并设置音频路径。

如果没有被任何事件使用，`音频`节点下的每个音频文件都有一个红色图标，如果至少有一个事件使用，则是绿色图标。

如果清除层级树中该事件旁边的可见点，音频将不会播放，也不会在[音频视图](/spine-audio-view)中显示。

## 查找音频文件

Spine使用`音频`节点下指定的路径并附加事件的音频路径来查找事件的音频文件。事件的音频路径不需要包含文件扩展名。Spine将查找文件扩展名为`.wave`、`.mp3`或`.ogg`的文件。

例如，如果音频节点有`./audio/`，而某个事件的音频路径是`footstep`，则Spine会查找`./audio/footstep.wav`、`./audio/footstep.mp3`和`./audio/footstep.ogg`。请注意，某些操作系统区分大小写。

音频路径可以包含子文件夹。例如，如果音频节点有`./audio/`，而某个事件的音频路径是`gun/reload`，则Spine会查找`./audio/gun/reload.wav`。

## 音频格式

Spine支持WAV、MP3和OGG音频文件。WAV文件需要是PCM，1或2个通道，每个采样16位。

[SoX](http://sox.sourceforge.net/)是用于转换音频文件的免费命令行工具。例如，要将WAV文件转换为每个采样16位：

```
sox input.wav -b 16 output.wav
```

# 视口事件

在播放动画时遇到事件关键帧时，事件名称会在视口中的骨架上方短暂显示。

![](/img/spine-user-guide/events/viewport-name.png)

要在视口中隐藏事件名称，请清除层级树中事件旁边的可见点。如果是音频事件，则不会播放，也不会显示在[音频视图](/spine-audio-view)中。

要在视口中隐藏所有事件名称，请将[曲线图筛选器](/spine-graph#筛选器)和[摄影表筛选器](/spine-dopesheet#筛选器)设置为排除事件。

## 文件夹

可以将事件组织到文件夹中。要创建文件夹，请选择一个事件，然后单击`新建...` `文件夹`。可以通过拖动事件在文件夹之间移动事件。

在导出的骨架数据中，文件夹名称先于事件名称以创建Spine运行时使用的最终名称。例如，如果`attacks`文件夹有一个事件`reload`，则运行时的事件名称为`attacks/reload`。

# 视频

[Bilibili](https://www.bilibili.com/video/BV1nf4y1y7EV/)
<iframe src="//player.bilibili.com/player.html?bvid=BV1nf4y1y7EV&autoplay=0" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>!!

[youtube:gPj9ZkSb0gU&list=PLwGl7Ikd_6GRFo7d0uRu_fN2RIlvkxW7b]

[下一节: 视图](/spine-views)
[上一节: 变换约束](/spine-transform-constraints)
[Spine用户指南: 目录]