CRIWARE Unity Plugin Manual  Last Updated: 2025-05-08
CRI Ware for Unity ChangeLog

[3.12.00]-2025-04-07

  • C# Script
    • 2.44.29
  • Library
    • 2.44.10
  • Native Libraries
    • Atom : 2.29.293
    • Base : 2.55.22
    • File System : 2.88.13
    • Mana : 2.29.18

Specification Changes

  • [Fs][android] Deprecated insecure HTTPS communication using CriFsWebInstaller.ModuleConfig.allowInsecureSSL.
    • Since this version, setting this field to true will have no effect.
  • [Mana][all_platform] Removed the deprecated 'Infinite' option in the MaxFrameDrop setting of components that inherit from CriManaMovieMaterial.

New Features

  • [all_module][all_platform] An option to output logs via the standard output is now available in the error handler.
  • [Atom][all_platform] Added Clip-In feature to the Atom Timeline Clip, making it possible to play audio from an arbitrary position when entering a Clip.
  • [Atom][pc] Added functions to get the current audio output device.
    • CriAtomEx.GetOutputAudioDeviceId_PC
    • CriAtomEx.GetOutputAudioDeviceIndex_PC
  • [Atom][all_platform] Added the CriAtomExAsrRack.Default property.
  • [Atom][all_platform] Added the following members to the CriAtomExAcf.AcfDspBusInfo struct:
    • speakerMapping
    • outputType
    • outputOptions
  • [Mana][all_platform] Added support for AV1 codec expansion.

Bug Fixes

  • [Mana][editor] Fixed an issue where the Unity editor would occasionally hang up when repeatedly changing clip settings while previewing a Mana Timeline track.
  • [Atom][editor] Fixed an issue where the runtime could enter an invalid state if the Atom Source's Inspector was displayed while in Play Mode.
  • [Atom][all_platform] Fixed an exception that would occur when initializing the library on a thread other than the main thread.

Bug Fixes

  • [Atom][editor] Fixed an issue where the waveform preview in the CRI Atom Timeline extension was not rendered when the build target was not set to Standalone.

[3.11.01]-2025-01-31

  • C# Script
    • 2.43.67
  • Library
    • 2.43.33
  • Native Libraries
    • Atom : 2.28.272
    • Base : 2.54.34
    • File System : 2.87.27
    • Mana : 2.28.25

Specification Changes

  • [Atom][all_platform] CriAtomExOutputAnalyzer can now be attached or detached while CriAtomExPlayer is playing.

New Features

  • [Atom][all_platform] Added the CriAtomExAcb.IsAttachedAwbFile(string) method.
  • [Atom][android] The following functions have been added to get and set the priority of the server processing thread:
    • CriAtom.GetThreadPriorityANDROID()
    • CriAtom.SetThreadPriorityANDROID()
  • [Atom][all_platform] The followng functions have been added to get the ASR Rack IDs for Ambisonic, channel-based, object-based and passthrough playback:
    • CriAtomExAsrRack.GetAmbisonicRackId()
    • CriAtomExAsrRack.GetChannelBasedAudioRackId()
    • CriAtomExAsrRack.GetObjectBasedAudioRackId()
    • CriAtomExAsrRack.GetPassThroughRackId()

Bug Fixes

  • [Mana][all_platform] Fixed an issue where movies may not have been rendered correctly after editing the project's color space settings.
  • [Fs][android] Fixed the File System initialization process to support Android Game Activity.
  • [Mana][all_platform] Fixed an issue where the compile error would occur when headless mode is enabled.

[3.11.00-web]-2024-12-04

  • C# Script
    • 2.43.50
  • Library
    • 2.43.23
  • Native Libraries
    • Atom : 2.28.259
    • Base : 2.54.32
    • File System : 2.87.22
    • Mana : 2.28.16

[3.11.00]-2024-11-13

  • C# Script
    • 2.43.46
  • Library
    • 2.43.19
  • Native Libraries
    • Atom : 2.28.246
    • Base : 2.54.32
    • File System : 2.87.21
    • Mana : 2.28.16

Specification Changes

  • [Atom][android] The audio playback latency estimation feature for Android has been deprecated.
  • [Atom][editor] CriWare.CriAtomWindowPrefs settings assets will now always be generated under the Assets folder.
  • [Atom][all_platform] Added the following speaker mapping definition:

New Features

  • [Atom][android] Added the following class variable, which can be used for background audio playback on Android:
    • - CriWare.CriAtomServer.EnableBackgroundPlayback_ANDROID
  • [Atom][ios] Added the following functions for background audio playback on iOS:
  • [Atom][ios] Added an iOS-specific option to the CriWareInitializer component to enable/disable iOS audio interruption notification handling by ADX.
  • [Atom][all_platform] Added CriWare.CriAtomExPlayer.SetStartTimeMicro .
  • [Atom][pc][macosx][linux] Added an function to retrieve waveform data from a Cue.
  • [Atom][Mana][all_platform] Added events before and after the initialization/finalization of the Atom and Mana libraries:
    • CriAtomPlugin.OnBeforeInitialize
    • CriAtomPlugin.OnInitialized
    • CriAtomPlugin.OnBeforeFinalize
    • CriManaPlugin.OnBeforeInitialize
    • CriManaPlugin.OnInitialized
    • CriManaPlugin.OnBeforeFinalize
    • CriManaPlugin.OnFinalized
  • [Fs][all_platform] Added File System information to Project Setting -> CRIWARE -> Editor -> Common. The properties that can be set are the same as in CriFsConfig .
  • [Atom][all_platform] Added selector information to the CueInfo struct. The following field was added:
    • CueInfo.selectorIndex
  • [Atom][all_platform] In CriWareInitializer, added the following parameters that disable the Atom sound output:
    • CriWareInitializer.CriAtomConfig.enableAtomSoundDisabledMode
    • CriWareInitializer.CriAtomConfig.enableAtomSoundDisabledModeLinux
  • [Atom][all_platform] Added the CriWare.CriAtomEx.CueInfo.pitch field.
  • [Mana][all_platform] Added the ability to check the call time of some of the Mana functions in the Unity Profiler.
    • To disable this feature, please add the following directives:
    • CRI_DISABLE_PROFILER_EXTENSION
  • [Atom][Fs][Mana][all_platform] Added the ability to check the memory usage of each CRIWARE module from the Unity Profiler.
  • [Atom][pc] Added the ability to check the presence of audio devices on a PC using CriAtomOutputDeviceObserver .

Bug Fixes

  • [all_module][editor] Fixed an issue which would cause multiple "obsolete API" warnings in Unity 2023 and above.
  • [all_module][editor] Fixed an issue where the following properties might not be correct after reloading assemblies in the Editor.
    • CriWare.CriFsPlugin.isInitialized
    • CriWare.CriAtomPlugin.isInitialized
    • CriWare.CriManaPlugin.isInitialized
  • [Mana][all_platform] Fixed an issue where the rendering could be corrupted if Stop was not called after a video playback and another video of a different resolution was played on the same player.
  • [Mana][android] Fixed a potential crash when disposing a video player on devices with the Memory Tagging Extension enabled.
  • [all_module][editor] Fixed an issue where the Linux library information was not displayed in the Version Information window.

Other

  • [Mana][ios][android][macosx] Added details to some of the error messages related to the graphics API.
  • [Mana][all_platform] To prevent unwanted code stripping, calls to reflection methods have been removed from the initialization of the VP9 library.
  • [Mana][all_platform] In the Mana Timeline extension, the starting playback latency has been reduced for Mana Clips that have a preparation time.

[3.10.01]-2024-04-26

  • C# Script
    • 2.42.46
  • Library
    • 2.42.32
  • Native Libraries
    • Atom : 2.27.353
    • Base : 2.53.16
    • File System : 2.86.6
    • Mana : 2.25.29

New Features

Bug Fixes

  • [Atom][editor] Fixed an issue where preview playback of WebGL streaming Cue could not be performed in Atom Browser or in the Inspector of the CriAtomSource component.
  • [Atom][editor] Fixed an issue where preview playback of WebGL audio data was not possible in Atom Browser.
  • [Mana][android] Fixed an issue where video playbacks were not rendered correctly on a small number of Mali GPU-equipped devices when the Graphics API setting was OpenGLES3.

Other

  • [Atom][all_platform] Updated the comment explaining the setting range of the arguments for CriAtomExPlayer.SetDspTimeStretchRatio .
  • [all_module][editor] Each page switching button in the Version Window will now be disabled if the corresponding module does not exist.

[3.10.00]-2024-02-06

  • C# Script
    • 2.42.33
  • Library
    • 2.42.25
  • Native Libraries
    • Atom : 2.27.320
    • Base : 2.53.16
    • File System : 2.86.5
    • Mana : 2.25.26

Specification Changes

New Features

Bug Fixes

  • [Atom][ios] Fixed an issue where playback might not recover from audio interruption caused by incoming phone call or Siri when Unity Audio is enabled.
  • [Mana][pc][ios][macosx] Fixed an issue where the video rendering could be currupted if the video is played after another one with a larger resolution, and both videos are encoded with the same codec which is either Sofdec.Prime or VP9.
  • [Mana][android] Fixed an issue where H.264 movies could not be rendered correctly when using GLES2 as the graphics API.
  • [Atom][webgl] Fixed an issue where the sound playback may not be recovered when switching back to Safari on iOS.
  • [Mana][webgl] Fixed an issue where the sound in a video playback may stutter on FireFox.
  • [Mana][all_platform] Fixed an issue where customized materials in components inheriting CriManaMovieMaterial would be set to None when PlayerManualFinalize() is called (in an editor extension etc.).

[3.09.02]-2023-12-15

  • C# Script
    • 2.41.109
  • Library
    • 2.41.45
  • Native Libraries
    • Atom : 2.26.382
    • Base : 2.52.27
    • File System : 2.85.1
    • Mana : 2.24.52

New Features

  • [Mana][all_platform] Added the [Use Streamer Manager] option to the CriWareInitializer component.

Bug Fixes

  • [Atom][editor] Fixed a crash when changing the CriAtomServer.EnableAutoConsumePcmOutput setting while the user PCM output mode is enabled.
  • [Atom][all_platform] Fixed an issue in the Atom Timeline extension where the first and last frames of a clip were not included when playing sound.
  • [Atom][editor] Fixed an issue where the display of CRI Profiler would be temporarily corrupted when playing a large number of sounds in the editor.
  • [Mana][all_platform] Fixed an issue where the creation of a new material might fail in the CriManaMovieMaterial component.
  • [Mana][ios] Improved the drawing process during the playback of Sofdec.Prime or VP9 encoded videos for more stability.

[3.09.01]-2023-08-31

  • C# Script
    • 2.41.90
  • Library
    • 2.41.32
  • Native Libraries
    • Atom : 2.26.332
    • Base : 2.52.25
    • File System : 2.85.1
    • Mana : 2.24.38-0.1

New Features

Bug Fixes

  • [all_module][all_platform] Added validation of the initialization parameters during the library's initialization via the CriWareInitializer component.
  • [Mana][all_platform] Fixed an issue in the Mana Timeline expansion where changing Director.time to a position without a clip while ManaClip playback was being prepared would put that ManaTrack in an invalid state, preventing future video playback.
  • [Mana][all_platform] Fixed an issue where internal resources may not be released when using the CriWare.CriMana.Player class alone. CriManaMovieResources GameObjects will now be created in the scene when Players are generated from script.
  • [Atom][all_platform] Fixed a memory leak when the loading process using CriWare.CriAtomExAcbLoader failed to start.
  • [Mana][all_platform] Fixed an issue in the Mana Timeline extension where video from a Mana Clip would be played in fast-forward when played immediately after another clip while the CriManaTrack's FrameSync setting was enabled.
  • [Mana][all_platform] Fixed exceptions when the following operations were performed:
  • [Mana][all_platform] Fixed an issue in the Mana Timeline extension where the video playback position was not updated accordingly to the skipping or rewinding operations while playing the same ManaClip. Uncheck the following CriManaTrack setting to return to the previous behavior.
    • Check Pos Within Clip
  • [Mana][all_platform] Fixed an issue where edits to a CriManaClip would not be applied if the PlayableDirector did not have the focus.
  • [Atom][editor] Fixed a crash caused by the Atom Timeline extension when the library is finalized during preview playback.
  • [Mana][macosx] Fixed an issue where video rendering would be corrupted if the alpha video's YUV channel had a different resolution than the alpha channel.
  • [Mana][ios] Fixed an issue - when the CPU load was high - where the frames would be displayed out of order and at the wrong timing when playing back Sofdec.Prime or VP9 codec videos.
  • [Mana][pc][android] Fixed an issue where video playback on a VR platform resulted in a single-eye display.
  • [Atom][all_platform] Fixed an issue where the CriWare.CriAtomConfig.InGamePreviewConig settings for CriWare.CriWareInitializer would not always be applied.
  • [Atom][all_platform] Fixed an issue where other listeners could still be enabled even though a CriAtomListener component was set to be exclusive.
  • [Mana][ios] Fixed an issue where CriWare.CriMana.Player.GetDisplayedFrameNo returned incorrect values ​​when playing Sofdec.Prime or VP9 encoded videos.
  • [Atom][editor] Fixed an issue where the method CriWare.CriAtomExPlayback.GetTimeSyncedWithAudio would not work properly after the following operations:
    • Start play mode in editor
    • Pause the play mode
    • Stop the play mode without resuming from pause

[3.09.00]-2023-06-29

  • C# Script
    • 2.41.62
  • Library
    • 2.41.24
  • Native Libraries
    • Atom : 2.26.305
    • Base : 2.52.25
    • File System : 2.85.1
    • Mana : 2.24.38

Specification Changes

  • [Atom][all_platform] A return value has been added to the following API to indicate whether the ACF registration was successful.
  • [Atom][all_platform] Removed the "VR Mode" flag from the Library Initializer.
  • [all_module][webgl] The contents of sofdec2.worker.wasm.bin are now encapsulated in sofdec2.worker.wajs. If you are updating from an older plugin, please remove the sofdec2.worker.wasm.bin file manually.
  • [all_module][webgl] The build process will now abort if the copy of library files fails.
  • [Atom][ios] The sleep-on-resume processing and associated plugin functions from previous implementations have been removed.
  • [Atom][all_platform] Changed the length of the arrays (i.e., the maximum number of channels) in CriWare.CriAtomExAsr.BusAnalyzerInfo from 8 to 16.
  • [Atom][all_platform] The PlatformConfig structure and the constructor of the CriAtomExAsrRack class that takes it as an argument are now deprecated. Use a platform-specific structure that inherits from IPlatformConfig instead.

New Features

Bug Fixes

  • [Mana][webgl] Fixed an issue where the values of some fields in CriWare.CriMana.FrameInfo could not be retrieved correctly.
  • [Mana][ios] Fixed a potential crash when destroying the video player.
  • [Atom][editor] Fixed a warning triggered by the CRI Timeline extension when using Unity Timeline 1.5.2 or above.
  • [Atom][all_platform] Fixed an issue with the Atom Timeline where the position of the playback would not reflect changes made explicitly, for instance by a script. Disable the following CriAtomTrack setting to return to the previous behavior:
    • Check Position within Clip
  • [Atom][all_platform] Fixed an issue with CriWare.CriAtomEx3dListener.IsDestroyable not working correctly.
  • [all_module][editor] Fixed an issue where plugin information for macOS would not be displayed in the Version Information window on Unity 2021.3.23 or above.
  • [Atom][Mana][all_platform] Fixed unnecessary GC Allocation occuring during playback in the CRI Timeline extension.
  • [Atom][editor] Fixed several issues in the inspector of the CriAtomSource component.
    • Fixed an issue where the sound in the scene would be stopped if the inspector of a CriAtomSource was displayed in the Unity Editor in PlayMode.
    • Fixed an issue where the current DSP bus settings were not applied during preview playback in the CriAtomSource inspector.
  • [Atom][editor] Fixed issues in the CRI Profiler:
    • Fixed the information display being delayed or stopped by an error when there are multiple sound sources.
    • Fixed an IndexOutOfRange exception and a temporary lack of display when the content on the timeline was too complex.
  • [Atom][ios] Fixed an issue where audio output except for the plugins would be disabled when finalizing the Atom library.
  • [all_module][editor] Fixed an issue where CriConsoleLog was not outputing some logs related to the plugin.
  • [all_module][ios] Fixed an issue where some files were not referenced correctly when the exported Xcode project was moved to another environment.
  • [Atom][all_platform] Fixed an issue where the SetStartTime of the AtomSource.player bound to the Atom Timeline was overridden by the plugin processing.
  • [Atom][all_platform] Fixed an issue where warnings related to the following callbacks could be triggered even though the callbacks were not used:
  • [Mana][ios] Fixed an issue causing flickering when playing Sofdec.Prime or VP9 encoded videos. Note that there is now a one-frame delay between the start of the playback and rendering of the video.
  • [Fs][all_platform] Fixed an issue where an invalid instance remained when an exception occurred in the CriWare.CriFsUtility.WebInstall method.
  • [Mana][android] Fixed an issue where H.264 movies might not be rendered correctly in the following environments if OpenGLES2 or OpenGLES3 was selected as the Graphics API:
    • - Devices on which CriManaPlugin.IsCodecSupported() returns false
    • - Environments where the Unity Universal Render Pipeline is enabled
    • - Windows Subsystem for Android
    • Note that the playback load has also changed for the above-mentioned Graphic APIs. Please define the following preprocessor flag if you want to return to the previous behavior:
    • - CRI_DISABLE_MANA_OUTPUT_BUFFER_FOR_OPENGLES3
  • [Atom][ios] Fixed an issue where CriWare.CriAtomOutputDeviceObserver.IsDeviceConnected would not update properly.
  • [Mana][editor] Fixed an issue in the MacOS Editor where video playback would not be performed correctly when a specific platform was specified as the Target Platform.
  • [Mana][ios] Fixed an issue where the video would stop when any of the following operations were performed when Render Extra Frame on Pause in PlayerSettings was turned off.
    • Completely pulling down the notification center
    • In the Stage Manager on an iPad, choosing "Add Another Window" to launch another app