{"id":2468,"date":"2019-08-09T08:55:11","date_gmt":"2019-08-08T23:55:11","guid":{"rendered":"https:\/\/blog.criware.com\/?p=2468"},"modified":"2019-08-09T09:20:29","modified_gmt":"2019-08-09T00:20:29","slug":"creating-immersive-3d-audio-with-adx2-and-unity-part-3","status":"publish","type":"post","link":"https:\/\/blog.criware.com\/index.php\/2019\/08\/09\/creating-immersive-3d-audio-with-adx2-and-unity-part-3\/","title":{"rendered":"Creating Immersive 3D Audio with ADX2 and Unity: Part 3"},"content":{"rendered":"

Introduction<\/h2>\n

Part 1<\/a> of this series covered some of ADX2\u2019s basic 3D audio features. Part 2<\/a> expanded on that by exploring source-based and listener-based attenuation. The final part of this series will unpack the process of updating our 3D audio parameters in real-time with code. This will allow us to create sound sources which move and rotate around the world the way the player does. Watch the video below to see this effect in action, and feel free to grab the Atom Craft project from any of the previous blogs to quickly get started.<\/p>\n

\n
https:\/\/blog.criware.com\/wp-content\/uploads\/2019\/08\/3daudiopart3.mp4<\/a><\/video><\/div>\n<\/div>\n

<\/p>\n

ADX2<\/h2>\n

For this to work, all we need to do is set up the Sound Source Based Angle <\/strong>with an AISAC on our Cue, as we did in Part 2<\/a>. We could use the Effective Angle instead, however, using an AISAC does provide more flexibility in terms of attenuation shape, and it also allows us to apply filtering if we want.<\/p>\n

\"14-1\"<\/p>\n

Unity<\/h2>\n

The code required to update a 3D sound source is straight-forward, but there are a few points to note:<\/p>\n

    <\/p>\n
  1. We need to create a new CriAtomEx3DSource <\/em>and assign it to our main CriAtomSource <\/em>via player.set3DSource(CriAtomEx3Dsource)<\/em>.<\/li>\n
  2. Next, we apply any arbitrary rotation and movement to the object and then update the 3D audio parameters using the SetConeOrientation <\/em>and SetPosition <\/em>methods, piping in the corresponding object\u2019s forward and transform.position <\/em>values, respectively.<\/li>\n
  3. Finally, we need to call a specific update method on the 3D sound source, informing it to make the necessary changes.<\/li>\n<\/ol>\n

    The Debug.DrawRay <\/em>function is just to visualise the direction of the sound source, which is handy for objects which don\u2019t have a distinct front face (such as our cube).<\/p>\n

    \r\n\r\n\r\n\r\nusing System.Collections;\r\nusing System.Collections.Generic;\r\nusing UnityEngine;\r\n\r\npublic class CubeRotation : MonoBehaviour\r\n{\r\n    public float speed = 0.25f;\r\n    CriAtomEx3dSource source3D;\r\n    CriAtomSource atomSource;\r\n\r\n    void Start()\r\n    {\r\n        atomSource = GetComponent();\r\n        source3D = new CriAtomEx3dSource();\r\n        atomSource.player.Set3dSource(source3D);\r\n\t\t\r\n        atomSource.Play();\r\n    }\r\n\r\n    void Update()\r\n    {\r\n        Debug.DrawRay(transform.position, transform.forward * 100.0f, Color.red);\r\n        transform.Rotate(0, speed, 0);\r\n\r\n        source3D.SetConeOrientation(transform.forward.x, transform.forward.y, transform.forward.z);\r\n        source3D.SetPosition(transform.position.x, transform.position.y, transform.position.z);\r\n        source3D.Update();\r\n    }\r\n}\r\n\r\n\r\n<\/code>\r\n<\/pre>\n
    Conclusion<\/h2>\n
    And that\u2019s all it takes! You might not need to update an object every frame (e.g. if it\u2019s static), so you could just call the necessary cone orientation and position code in the Start() function. Overall, this is just an extension of last month\u2019s blog, and the same use-cases apply. However, the real-time aspect is particularly important if you are trying to create, for example, a more dynamic dialogue system. You could set it so that characters which are facing away from the player appear slightly more muffled (low-passed), like in real life! This could help a scene feel more immersive.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Introduction Part 1 of this series covered some of ADX2\u2019s basic 3D audio features. Part 2 expanded on that by<\/p>\n","protected":false},"author":2,"featured_media":2470,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"colormag_page_container_layout":"default_layout","colormag_page_sidebar_layout":"default_layout","footnotes":""},"categories":[5,7],"tags":[],"class_list":["post-2468","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-adx","category-tutorials"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/2468","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/comments?post=2468"}],"version-history":[{"count":17,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/2468\/revisions"}],"predecessor-version":[{"id":2501,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/2468\/revisions\/2501"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/media\/2470"}],"wp:attachment":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/media?parent=2468"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/categories?post=2468"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/tags?post=2468"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}