# イベント

<callout>イベントはSpine Essentialでは利用できませんのでご注意ください。</callout>

イベントとは、アニメーション中に何かを起こすトリガーとなるものです。Spineエディター内では、イベントを設定してオーディオを再生することができます。それ以外のイベントは、ランタイムで処理されることを想定しており、イベントに応じて好きなアクションを起こすコードを書くことができます。例えば、パーティクルエフェクトを発生させたり、敵にダメージを与えたり、ドアを開けたりするなどです。

オーディオイベントのオーディオ再生はSpineエディター内の機能ですが、Spineランタイムではオーディオ再生を管理しません。ランタイムには、[イベントを処理](/spine-applying-animations#リスナー)し、イベントのオーディオパス、ボリューム、バランスのプロパティを使用して適切なオーディオを再生するコードを記述する必要があります。

また、Spineからエクスポートしたビデオには、オーディオイベントからのオーディオを含めることができます。詳細は、[AVIエクスポート](/spine-export#AVI)及び[MOVエクスポート](/spine-export#MOV)をご覧ください。

# セットアップ

イベントを作成するには、ツリーの`Events(イベント)`ノードを選択し、`New...(新規...)` `Event(イベント)`をクリックします。

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

# プロパティ

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

`Integer(整数)`、`Float(浮動小数点)`、`String(文字列)`の各プロパティは、イベントに追加情報やコンテキストを与える値です。セットアップポーズでこれらの値のデフォルト値を設定できますが、イベントのキーには異なる値を設定することができます。

## Integer(整数)

小数点以下の要素を含まない数値を格納します。この値は[キーとして記録](/spine-keys#イベント)できます。

## Float(浮動小数点)

小数点以下の要素を持つ数値を格納します。この値は[キーとして記録](/spine-keys#イベント)できます。

## String(文字列)

文字列を格納します。この値は[キーとして記録](/spine-keys#イベント)できます。

## オーディオパス

`Audio path(オーディオパス)`が設定されていると、アニメーションの再生中にこのイベントのキーに遭遇したとき、Spineエディターは対応するオーディオファイルを再生します。詳細は、[オーディオファイルの検索](#オーディオファイルの検索)をご覧ください。

オーディオパスが設定されると、そのイベントは[オーディオイベント](#オーディオイベント)となり、`Volume(ボリューム)`と`Balance(バランス)`のプロパティが表示されます。

### ボリューム

`Volume(ボリューム)`はSpineエディターで再生する際のオーディオイベントの再生音量を設定します。この値は[キーとして記録](/spine-keys#イベント)できます。

### バランス

`Balance(バランス)`はSpineエディターで再生する際のオーディオイベントのバランスを設定します。この値は[キーとして記録](/spine-keys#イベント)できます。

2チャンネルオーディオの場合は、左右のチャンネルの音量を設定します。1チャンネルオーディオの場合は、オーディオを左右にパンします。

# オーディオノード

ツリーの`Audio(オーディオ)`ノードには、Spineがそのスケルトン用のWAV、MP3、OGGなどのオーディオファイルを検索するフォルダへのパスがあります。このオーディオパスは、プロジェクトファイルが保存されている場所からの相対パスでも、絶対パスでも設定可能です。`Browse(参照)`ボタンでパスを指定するか、パスを入力して`Enter`キーを押すことで設定できます。パスが設定されると、そのフォルダ内のオーディオファイルが`Audio(オーディオ)`ノードの下に表示されます。Spineはオーディオフォルダを監視し、オーディオファイルに変更があった場合は即座にロードします。

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

デフォルトでは、オーディオフォルダで見つかった最初の2,000個のオーディオファイルのみが表示されます。これにより、誤って間違ったパスを指定してしまった場合に、何百万ものファイルをスキャンしてしまうことを防ぎます。`Limit scanning(スキャンを制限)`のチェックを外すと、Spineは2,000個以上のオーディオファイルを見つけることができます。

## オーディオイベント

「オーディオイベント」とは、[オーディオパス](#オーディオパス)が設定されているイベントのことです。オーディオパスの設定は、キーボードで入力するか、オーディオファイルをツリーのイベントにドラッグして行います。

また、オーディオファイルを選択して、ツリーのプロパティで`New Event(新規イベント)`をクリックすると、新しいオーディオイベントが作成されます。これにより、オーディオパスが設定された同じ名前のイベントが作成されます。

`Audio(オーディオ)`ノードの下にある各オーディオファイルには、どのイベントでも使用されていない場合は赤のアイコンが、1つ以上のイベントで使用されている場合は緑のアイコンが表示されます。

ツリー内のイベントの横にある表示ドットがオフになっている場合、オーディオは再生されず、[オーディオビュー](/spine-audio-view)にも表示されません。

## オーディオファイルの検索

Spineは、`Audio(オーディオ)`ノードで指定されたパスを取得し、イベントに設定されたオーディオパスを追加することで、そのイベントのオーディオファイルを検索します。イベントのオーディオパスには、ファイルの拡張子を含める必要はありません。Spineは`.wav`、`.mp3`、`.ogg`のいずれかの拡張子を持つファイルを検索します。

例えば、オーディオノードに`./audio/`が設定されており、イベントのオーディオパスが`footstep`となっている場合、Spineは`./audio/footstep.wav`、`./audio/footstep.mp3`、`./audio/footstep.ogg`を検索します。OSによっては、大文字と小文字を区別しますのでご注意ください。

オーディオのパスにはサブフォルダ名を含めることができます。例えば、オーディオノードに`./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#フィルター)の両方を設定し、イベントを除外します。

## フォルダ

イベントはフォルダに整理することができます。フォルダを作成するには、イベントを選択して`New...(新規...)` `Folder(フォルダ)`をクリックします。イベントはドラッグしてフォルダ間を移動できます。

エクスポートされたスケルトンデータでは、イベント名の前にフォルダ名が付けられ、Spineランタイムで使用される最終的な名前になります。例えば、フォルダ`attacks`の中にイベント`reload`がある場合、ランタイムでのイベント名は`attacks/reload`となります。

# ビデオ

[youtube:gPj9ZkSb0gU&list=PLwGl7Ikd_6GRFo7d0uRu_fN2RIlvkxW7b]

[次: ビュー](/spine-views)
[前: トランスフォーム・コンストレイント](/spine-transform-constraints)
[Spine ユーザーガイド: 目次]