Unityのメニューで、 Audiokinetic > Certification > 301 > Lesson 7 を選択し、 Callbacks on a Wwise-Type Event を選択します。

まずスクリプトを作成してから、Wwise-Type Eventプロパティを作成します。

Hierarchyで Wwise ゲームオブジェクトを選択します。

Inspectorで Add Component をクリックし、 PostMusic を検索して New Script を選択し、 Create and Add をクリックします。

PostMusic スクリプトをダブルクリックして開きます。

最初に、Wwise-Type Eventクラスを使い、Eventを作成してポストします。

PostMusic スクリプトの中の、ファンクション以外の場所で、publicなWwise-Type Eventを宣言するために、 public Ak.Wwise.Event と書きます。

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
    
public class PostMusic : MonoBehaviour {
  public AK.Wwise.Event
    // Use this for initialization
    void Start () {
    
    }
    // Update is called once per frame.
    void Update () {
    
    }
}

AK.Wwise.Eventのあとにスペースを1つ追加し、プロパティの名前を MusicEvent とし、行の終わりにセミコロン（ ; ）を入れます。

public class PostMusic : MonoBehaviour {
  public AK.Wwise.Event MusicEvent;

Wwise-Type Eventプロパティを作成できたので、Start時にEventをポストし、ゲームが初期化されたらすぐにEventがポストされるようにします。

Start()ファンクションに、" MusicEvent.Post(gameObject); "と入力します。

public class PostMusic : MonoBehaviour {
  public AK.Wwise.Event MusicEvent;
    // Use this for initialization.
    void Start () {
        MusicEvent.Post(gameObject);
    }

コンポーネントの場合と同様に、Eventのコールバックを設定するにはコールバック情報（Callback Flag、Callback Function）を、Eventのポストと一緒に提供する必要があります。Callback Flagは2つ目の引数で（1つ目の引数はゲームオブジェクト）、AkCallbackTypeクラスを通して可能です。Post()でも、Callback Flagを追加すればよく、まずコンマ（,）を入力し、次にStart()ファンクションにプロパティ名を入力します。

	すべてのCallback Flagが、すべてのWwise Objectタイプと互換性があるわけではないので、注意してください。例えばDestruction_VolcanicBoulder_ImpactsのEventが終了したときにコールバックが欲しければ、AK_EndOfEventというCallbackFlagを使えますが、EventがMusic Segmentを再生しているわけではないので、AK_MusicSyncBarはコールされません。

gameObjectのあとに、コンマ（,）1つとスペース1つを追加し、 AkCallbackType.AK_MusicSyncBar; と入力します。

void Start () {
    MusicEvent.Post(gameObject, AkCallbackType.AK_MusicSyncBar);
}

AkCallbackTypeクラスの中を見てAK_MusicSyncBarというFlagを探し、それを、ポストするEventに追加します。Postファンクションに限って、AK_MusicSyncBarをユニットプロパティタイプとして送信する必要があります。

	本技能検定で使うプログラミングランゲージのC#では、小数点なしの数字を、integer (int)というプロパティタイプに格納できます。このプロパティタイプに正の数も負の数も格納できます（-2,147,483,648から、2,147,483,647までの数値）が、すべての数字が確実に正の数になるように、符号なしのプレフィックス'u'を追加し、符号なしのintにして、uintとして書くことができます（0から、4,294,967,295までの数値）。

プロパティを変換するには、新しいプロパティタイプを括弧内に、CallbackTypeプロパティの前に、追加します。

	あるプロパティを、別のタイプに変換することを、タイプキャスティング（型変換）と呼びます。

(uint) を、AkCallbackType.AK_MusicSyncBarの前に挿入します。

MusicEvent.Post(gameObject, (uint)AkCallbackType.AK_MusicSyncBar);

Postファンクションの下に短い赤線があるのに、気づきましたか？

WwiseがUnityにコールバックしたときに、どのファンクションをコールすべきなのかを、あなたがまだ宣言していないので、下線があるのです。Unityからコールされないように、Update()ファンクションの名前を、Callbackファンクションに変更します。

名前を変更し、 Update() を CallbackFunction() にします。

    // Update is called once per frame.
    void CallbackFunction(){
    
    }

混乱を避けるために、上のUpdate()ファンクションに関するコメントも削除してください。

// Update is called once per frame というコメントを、削除します。

void CallbackFunction(){
    
}

そして、Post()ファンクションに、ファンクション名を追加します。

続いて MusicEvent.Post(gameObject, (uint)CallbackType で、 CallbackFunction と入力し、CallbackFunctionを引数として含めます。

MusicEvent.Post(gameObject, (uint)AkCallbackType.AK_MusicSyncBar, CallbackFunction);

CallbackFunctionの下に、赤線が表示されました。

Post()ファンクションにコールバックファンクションを追加したので、Wwiseサウンドエンジンは、選択されているCallback Typesの1つに遭遇した場合に、コールバックファンクションをコールします。あなたはCallback TypeのAK_MusicSyncBarを選択したので、Wwiseサウンドエンジンは、音楽のバーに遭遇するたびに、コールバックファンクションをコールします。

ただしWwiseサウンドエンジンは、コールバックファンクションで、コールバックノティフィケーションに関する情報も受け取れると期待するので、CallbackFunctionでその情報を受け取れるようにする必要があります。つまり、あなたがすべて必要か全く不要かに関わらず、ファンクションの括弧内に、いくつかの変数を宣言する必要があります。

CallbackFunction() の括弧内に object in_cookie, AkCallbackType in_type, object in_info と入力します。

void CallbackFunction(object in_cookie, AkCallbackType in_type, object in_info){
    
}

これで、Callback Typeなど、コールバックに関する情報を取得できます。今回はコールバックを1つだけ、つまりMusicSyncBarというものだけを、受け取るので、これらのパラメータは不要です。

	このようにCallbackファンクションでインプットするプロパティについて、詳しくは Wwise SDKドキュメンテーション を参照してください。

コールバックの設定が完了しましたが、まだCallbackFunction()が空なので、何もできません。ゆくゆくはゲームのすべてのRhythmActionsコンポーネントをコールする必要があるので、試しにすべてのRhythmActionsコンポーネントが認識できるファンクションを、GameManagerに作成しました。GameManagerスクリプトはシングルトンなので、1つしか存在していなく、ゲームプレイ中に破壊されることはないので、いつでもあるファンクションです。

RhythmActionsスクリプトがランタイムにインスタンス化されると、GameManagerへのリンクが自動的に作成されるので、それらをすべてGameManager経由でコールできるようになります。

CallbackFunction()ファンクションに、 GameManager.PushRhythmAction(); と入力します。

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class PostMusic : MonoBehaviour {
                      public AK.Wwise.Event MusicEvent;
    // Use this for initialization.
    void Start () {
        MusicEvent.Post(gameObject, (uint)AkCallbackType.AK_MusicSyncBar, CallbackFunction);
    }
    void CallbackFunction(object in_cookie, AkCallbackType in_type, object in_info){
        GameManager.PushRhythmAction();
    }
}

がんばりました！このセクションのスクリプト関連の手順を完了したので、 スクリプトを保存 します。次に、Wwise-Type Eventプロパティを、Music_RegionのEventにアサインします。

MusicEvent プロパティで、 Events > Music > General を展開し、 Music_Region をダブルクリックします。

これでRhythmActionsスクリプトを、Sceneのゲームオブジェクトに配信することができ、許可すれば、それらが動きます。

	ワールド環境全体で使う一部のゲームオブジェクト（DesertやForestなど）は、設定がstatic（静的）です。ゲームオブジェクトがstaticであれば、それをランタイムに動かせません。どのゲームオブジェクトでも、Inspector上部でstatic状態を解除できます。

Hierarchyで TrainingArea_ で始まるゲームオブジェクトをすべて選択します。

これらのゲームオブジェクトをすべて選択してからAdd Componentを選択することで、このコンポーネントを、選択中のすべてのオブジェクトに対して同時に追加できます。

Inspectorで Add Component をクリックし、 RhythmActions を検索して選択します。

これで、複数のゲームオブジェクトにRhythmActionsスクリプトを追加でき、カスタムスクリプトを使ってゲームのコア部分にコールバックを組み込めました。それでは、試してみてください。

Playモードに入り 、あなたが選択したオブジェクトがすべて、音楽のテンポに合わせて動くのを見てください。

ゲームオブジェクトの倍率を自由に調整したり、SceneのほかのゲームオブジェクトにさらにRhythmActionsスクリプトを追加したりしてみてください。