{"id":6263,"date":"2021-06-21T15:26:07","date_gmt":"2021-06-21T15:26:07","guid":{"rendered":"http:\/\/desres20.netornot.at\/?p=6263"},"modified":"2021-06-21T15:26:07","modified_gmt":"2021-06-21T15:26:07","slug":"wwise-implementierung-in-unity-teil-4-scripting","status":"publish","type":"post","link":"http:\/\/desres20.netornot.at\/?p=6263","title":{"rendered":"Wwise Implementierung in Unity (Teil 4: Scripting)"},"content":{"rendered":"\n

Neben der Nutzung vorgefertigter Skripte, die f\u00fcr die Implementierung von Wwise in Unity mitliefert sind, gibt es auch die M\u00f6glichkeit eigene Skripte bzw. eigenen Code zu schreiben, um Befehle an Wwise zu senden. Der Vorteil davon ist, dass man ganz genau bestimmen kann, an welcher Stelle Befehle an Wwise \u00fcbermittelt werden sollen. Viele Funktionen werden au\u00dferdem von den mitgelieferten Skripten nicht abgedeckt und m\u00fcssen deshalb selbst erstellt werden. H\u00e4ufig muss z.B. ein Sound abgespielt werden, wenn ein Spieler eine Taste bet\u00e4tigt oder etwas im Spiel geschieht, was nicht mit Triggercollidern zu tun hat.<\/p>\n\n\n\n

<\/p>\n\n\n\n

F\u00fcr das Implementieren von Wwise in Unity mittels Skripte gibt es grunds\u00e4tzlich zwei M\u00f6glichkeiten: Die direkte Hardkodierung eines Befehls oder die Kodierung mithilfe von Wwise-Types<\/em>, die im Unity-Inspector einen Property Drawer<\/em> anzeigen, mit welchem man Wwise-Objekte<\/em> (Event, State, Switch usw.) ausw\u00e4hlen kann.

Jeder hardkodierte Befehl beginnt mit dem Begriff AkSoundEngine<\/em>, der quasi eine Information f\u00fcr Unity darstellt, dass ein Wwise-Objekt aufgerufen werden soll. Daraufhin wird bestimmt, welche Wwise-Funktion ausgef\u00fchrt werden soll. Eine der grundlegendsten Funktionen ist “PostEvent<\/em>” f\u00fcr das Aufrufen eines Wwise-Events. Desweiteren gibt es noch die Funktionen “setState<\/em>” bzw. “setSwitch<\/em>” zum Bestimmen eines States bzw. Switches, “setPosition<\/em>“, damit Wwise die Position eines GameObjects <\/em>bekommt, was f\u00fcr die korrekte dreidimensionale Wiedergabe von diegetischen Sounds ben\u00f6tigt wird, “setRTPC<\/em>“, mit welchem Parameter aus dem Spiel an Wwise \u00fcbermittelt werden und viele weitere Funktionen, die in der Wwise-Dokumentation<\/a> nachgeschlagen werden k\u00f6nnen.
In den runden Klammern wird immer der Name des Wwise-Objekts als String mit angegeben. Manchmal werden noch andere Argumente ben\u00f6tigt, wie das GameObject<\/em>, von dem der Befehl ausgeht.<\/p>\n\n\n\n

\"\"
Das Aufrufen eines hartkodierten Trigger-Events, das Sounds f\u00fcr Fu\u00dfschritte abspielt<\/em><\/figcaption><\/figure>\n\n\n\n

<\/p>\n\n\n\n

Alternativ dazu kann man auch mithilfe von Wwise-Types Implementierungen realisieren. Dazu wird zun\u00e4chst eine Variable mit einer Wwise-Type-Klasse initialisiert. Wwise-Type-Klassen sind die verschiedenen Arten von Wwise-Objekten. Das ist z.B. AK.Wwise.Event<\/em> f\u00fcr Wwise-Events, AK.Wwise.State<\/em> f\u00fcr Wwise-States und viele andere. Auch alle Wwise-Type-Klassen k\u00f6nnen in der Wwise-Dokumentation<\/a> nachgeschlagen werden. <\/p>\n\n\n\n

Daraufhin kann im Unity-Inspector im Property Drawer<\/em> des Skripts das jeweilige Wwise-Objekt, welches im Wwise-Editor angelegt ist, ausgew\u00e4hlt werden.<\/p>\n\n\n\n

\"\"
Variable “Play_SFX_Ellen_Run” mit dem gleichnamigen Wwise-Objekt im Property Drawer belegt<\/em><\/figcaption><\/figure>\n\n\n\n


Nach der Initialisierung wird die Variable in einer Funktion im Skript aufgerufen. Dabei wird die Variable mit der jeweiligen Wwise-Funktion aufgerufen, wie z.B. “Post()<\/em>” bei Wwise-Events oder “SetValue()<\/em>” bei RTPCs, States oder Switches.<\/p>\n\n\n\n

\"\"
Variable “EllenFootsteps” wird mit Wwise-Type “AK.Wwise.Event” initialisiert und in der darauffolgenden Funktion “FootstepWwiseType()” mit der “Post()”-Funktion aufgerufen<\/em><\/figcaption><\/figure>\n\n\n\n

<\/p>\n\n\n\n

Quellen:<\/p>\n\n\n\n

[1] https:\/\/www.audiokinetic.com\/courses\/wwise301\/?source=wwise301&id=Posting_Events_using_WwiseTypes#read<\/p>\n\n\n\n

[2] https:\/\/www.audiokinetic.com\/courses\/wwise301\/?source=wwise301&id=Creating_a_WwiseType_Event_property#read<\/p>\n\n\n\n

[3] https:\/\/www.audiokinetic.com\/library\/edge\/?source=SDK&id=waapi_functions_index.html<\/p>\n\n\n\n

[4] https:\/\/www.audiokinetic.com\/library\/edge\/?source=Unity&id=annotated.html<\/p>\n","protected":false},"excerpt":{"rendered":"

Neben der Nutzung vorgefertigter Skripte, die f\u00fcr die Implementierung von Wwise in Unity mitliefert sind, gibt es auch die M\u00f6glichkeit eigene Skripte bzw. eigenen Code zu schreiben, um Befehle an Wwise zu senden. Der Vorteil davon ist, dass man ganz genau bestimmen kann, an welcher Stelle Befehle an Wwise \u00fcbermittelt werden sollen. Viele Funktionen werden<\/p>\n