{"id":4174,"date":"2023-03-09T10:56:42","date_gmt":"2023-03-09T01:56:42","guid":{"rendered":"https:\/\/blog.criware.com\/?p=4174"},"modified":"2024-06-04T16:48:22","modified_gmt":"2024-06-04T07:48:22","slug":"cri-assets-for-unity","status":"publish","type":"post","link":"https:\/\/blog.criware.com\/index.php\/2023\/03\/09\/cri-assets-for-unity\/","title":{"rendered":"CRI Assets for Unity"},"content":{"rendered":"<p>Recent versions of the CRIWARE Unity Plug-in include the new <strong>Asset Support Add-on<\/strong>. This add-on allows for the data generated by the CRIWARE tools to be used as regular Unity assets, which improves both workflow and asset management.<\/p>\n<h2 style=\"font-size: 150%; font-weight: bold; margin-top: 40px;\">Installation<\/h2>\n<p>The add-on is provided as a Unity package, so the installation is straightforward:<\/p>\n<ul>\n<li>Locate the cri_asset_support_addon.unitypackage in the Unity plugin folder, normally under \\Addons\\asset_support\\plugin.<\/li>\n<li>Then in Unity, go to Assets, Import Package, Custom Package, and import the Unity package.<\/li>\n<li>This will add CriAssets and CriAddressables folders in your Unity project under CRIMW.<\/li>\n<\/ul>\n<p style=\"text-align: center;\">\n<img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-4175\" src=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/01-Addon-Installation.png\" alt=\"01 Addon Installation\" width=\"889\" height=\"634\" srcset=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/01-Addon-Installation.png 889w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/01-Addon-Installation-300x214.png 300w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/01-Addon-Installation-768x548.png 768w\" sizes=\"auto, (max-width: 889px) 100vw, 889px\" \/>\n<\/p>\n<p>Note that the Asset Support Add-on only works with the following environments:<\/p>\n<ul>\n<li>Unity 2019.4.0f1 or later<\/li>\n<li>Unity Addressable Asset System 1.8.5 or later<\/li>\n<\/ul>\n<p>The Add-on also adds CRI&#8217;s own Scripted Importer, so conflicts may arise if you already have implemented your own importer for Criware-related files (such as ACF, ACB, AWB, USM).<\/p>\n<h2 style=\"font-size: 150%; font-weight: bold; margin-top: 40px;\">CRI Assets<\/h2>\n<p>With the Asset Support Add-on installed you can now import ACF, ACB, AWB, and USM files as Unity assets.<\/p>\n<p>These assets do not have to be located in the <em>StreamingAssets<\/em> folder anymore. From now on, assets can be imported anywhere under the Unity Assets folder. This also means that when building CueSheet binaries from Atom Craft, they can be exported directly into the Unity project folder, and automatically will appear as Unity assets. Therefore, it is now possible to maintain a custom folder hierarchy for the audio assets, which simplifies their import and management during the production cycle.<\/p>\n<p style=\"text-align: center;\">\n<img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/02-Unity-Assets.png\" alt=\"02 Unity Assets\" width=\"889\" height=\"386\" class=\"alignnone size-full wp-image-4177\" srcset=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/02-Unity-Assets.png 889w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/02-Unity-Assets-300x130.png 300w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/02-Unity-Assets-768x333.png 768w\" sizes=\"auto, (max-width: 889px) 100vw, 889px\" \/>\n<\/p>\n<p>Assets with the .acf \/ .acb \/ .awb \/ .usm extensions have also access to new settings in the Inspector.<\/p>\n<p>For every type of asset, the <em>Deploy Type <\/em>setting determines the actual location of the data:<\/p>\n<ul>\n<li><strong>StreamingAssets<\/strong> (Default) \u2013 Copy the assets in the StreamingAssets folder and include them in the built binaries. The data placed in StreamingAssets will be removed after the build.<\/li>\n<li><strong>OnMemory<\/strong> \u2013 Allow the inclusion of the assets in an AssetBundle without using the addressable system, which is convenient for downloadable content (DLC).<\/li>\n<li><strong>Addressables<\/strong> \u2013 Use the <a href=\"https:\/\/docs.unity3d.com\/Manual\/com.unity.addressables.html\">Unity Addressable Asset System<\/a> to manage the data.<\/li>\n<\/ul>\n<p>Note that it is also possible to create a custom Deploy Type that implements the <em>ICriAssetImplCreator <\/em>interface for your own resource management system.<\/p>\n<p>In addition, all the Cues included in the CueSheet of an ACB are now browsable and playable. AWB can also be linked directly from the ACB if needed.<\/p>\n<p style=\"text-align: center;\">\n<img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/03-ACB.png\" alt=\"03 ACB\" width=\"662\" height=\"609\" class=\"alignnone size-full wp-image-4178\" srcset=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/03-ACB.png 662w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/03-ACB-300x276.png 300w\" sizes=\"auto, (max-width: 662px) 100vw, 662px\" \/>\n<\/p>\n<p>For the USM files used by Sofdec, <em>Loop<\/em>, <em>Additive<\/em>, <em>Ambisonics<\/em> options are also available.<\/p>\n<p style=\"text-align: center;\">\n<img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/04-USM.png\" alt=\"04 USM\" width=\"566\" height=\"316\" class=\"alignnone size-full wp-image-4179\" srcset=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/04-USM.png 566w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/04-USM-300x167.png 300w\" sizes=\"auto, (max-width: 566px) 100vw, 566px\" \/>\n<\/p>\n<p>Finally, two new types of assets dedicated to multi-platform and\/or multi-lingual projects can be created:<\/p>\n<ul>\n<li><strong>Multi-Platform ACB \/ ACF \/ USM<\/strong> \u2013 These multi-platform assets reference the various versions of an ACB, ACF or USM required for all the platforms targeted by the project. By using this type of asset, only the ACB, ACF or USM corresponding to the platform you are building for will be included in the binary.<\/li>\n<li><strong>Multi-Lingual ACB<\/strong> \u2013 This asset references all the ACB used for the different languages, making it easy to switch languages in the application. This asset can also reference the ACB from other platforms.<\/li>\n<\/ul>\n<p style=\"text-align: center;\">\n<img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/05-Multilingual-ACB.png\" alt=\"05 Multilingual ACB\" width=\"582\" height=\"337\" class=\"alignnone size-full wp-image-4180\" srcset=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/05-Multilingual-ACB.png 582w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/05-Multilingual-ACB-300x174.png 300w\" sizes=\"auto, (max-width: 582px) 100vw, 582px\" \/>\n<\/p>\n<h2 style=\"font-size: 150%; font-weight: bold; margin-top: 40px;\">Components<\/h2>\n<p>CRI Assets use dedicated components to load the different types of Unity assets. Although the components themselves are different, their usage is similar to standard ones:<\/p>\n<ul>\n<li><strong>Cri Atom Assets<\/strong> &#8211; Component to manage the loading of ACF\/ACB.<\/li>\n<li><strong>Cri Atom Source For Asset<\/strong> &#8211; Component of a sound source<\/li>\n<\/ul>\n<p><strong>Cri Atom Assets<\/strong> are objects used to load data from an ACF file and the associated Cue Sheets.<\/p>\n<p>By adding a component to an object of the scene, it is possible to specify an ACF asset and the list of the ACB assets to load. The <em>DSP Bus Setting<\/em> can also be selected.<\/p>\n<p style=\"text-align: center;\">\n<img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/06-Cri-Atom-for-Asset.png\" alt=\"06 Cri Atom for Asset\" width=\"571\" height=\"326\" class=\"alignnone size-full wp-image-4181\" srcset=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/06-Cri-Atom-for-Asset.png 571w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/06-Cri-Atom-for-Asset-300x171.png 300w\" sizes=\"auto, (max-width: 571px) 100vw, 571px\" \/>\n<\/p>\n<p>Then the <strong>Cri Atom Source For Asset<\/strong> components are used to produce sound using ADX. Unlike the standard component, where you have to type by hand the name of the ACB and the Cue, it is now possible to select &#8211; or drag and drop &#8211; an ACB asset directly into the Inspector. The Cue can then be selected from a list.<\/p>\n<p>Other parameters such as <em>Volume<\/em>, <em>Pitch<\/em>, and <em>3D Positioning<\/em> remain unchanged.<\/p>\n<p style=\"text-align: center;\">\n<img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/07-Cri-Atom-Source-for-Asset.png\" alt=\"07 Cri Atom Source for Asset\" width=\"581\" height=\"299\" class=\"alignnone size-full wp-image-4182\" srcset=\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/07-Cri-Atom-Source-for-Asset.png 581w, https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/03\/07-Cri-Atom-Source-for-Asset-300x154.png 300w\" sizes=\"auto, (max-width: 581px) 100vw, 581px\" \/>\n<\/p>\n<p>The new Asset Support Add-on gives you more control over the management of your ADX or Sofdec assets within Unity, and its workflow improvements better suit modern game development.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Recent versions of the CRIWARE Unity Plug-in include the new Asset Support Add-on. This add-on allows for the data generated<\/p>\n","protected":false},"author":2,"featured_media":4187,"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,6,7],"tags":[],"class_list":["post-4174","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-adx","category-sofdec","category-tutorials"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/4174","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=4174"}],"version-history":[{"count":7,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/4174\/revisions"}],"predecessor-version":[{"id":5524,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/4174\/revisions\/5524"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/media\/4187"}],"wp:attachment":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/media?parent=4174"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/categories?post=4174"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/tags?post=4174"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}