CRI Ware for Unity ChangeLog

[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

• _{[Atom][all_platform]} Deprecated CriWare.CriAtomExAsrRack.SpeakerMapping and changed it to CriWare.CriAtom.SpeakerMapping.

New Features

• _{[Mana][all_platform]} Changed the access modifier of CriWare.CriMana.Player.PauseOnApplicationPause function to public.
• _{[Atom][all_platform]} Added an CriWare.CriAtomExOutputPort.IsDestroyable().
• _{[Atom][all_platform]} Added an event CriWare.CriAtomPlugin.OnFinalized that is called after the library finalization.
• _{[Atom][all_platform]} Added a property "ASR Rendering Mode" to LibraryInitializer for specifying speaker mapping.
• _{[Mana][all_platform]} Added API that returns CriAtomExPlayer for sub-audio-track/extra-audio-track.
  • CriWare.CriMana.Player.subAtomExPlayer
  • CriWare.CriMana.Player.extraAtomExPlayer
• _{[Atom][all_platform]} Added the [Max Pitch] parameter to the Library Initializer component.
• _{[Atom][all_platform]} Added APIs to pause output voices. The following methods have been added:
  • CriWare.CriAtomExAsr.PauseOutputVoice
  • CriWare.CriAtomEx.PauseTimer
• _{[all_module][all_platform]} Added a member pan3dWideness in to the struct CriWare.CriAtomExAcf.AcfDspBusInfo.
• _{[all_module][all_platform]} When an error callback occurs using the CriWareErrorHandler component, the message is now output by the native log output function for each platform.
  • If the following APIs are used, messages can be output by the log output function on the user side.
  • CriWare.CriWareErrorHandler.OnCallback
  • CriWare.CriWareErrorHandler.callback
• _[Mana][pc] Added support for Direct3D12.
  • Note that this changes the playback load. Please define the following preprocessor flag if you want to return to the previous behavior:
  • CRI_MANA_USE_LEGACY_DECODER_PC
• _{[Atom][all_platform]} The following API has been added to obtain the total rendering volume of ASR racks.
  • CriWare.CriAtomExAsrRack.GetNumRenderedSamples
• _{[Atom][all_platform]} The following API has been added to specify when to start playback of audio played by the AtomEx player.
  • CriWare.CriAtomExPlayer.SetScheduleTime
• _{[Atom][all_platform]} Added category maximum ignore setting to CriWare.CriAtomExOutputPort.Config.
• _{[Atom][all_platform]} Added the following members to CriWare.CriAtomExDebug.ResourcesInfo .
  • CriWare.CriAtomExDebug.ResourcesInfo.parameterBlock
  • CriWare.CriAtomExDebug.ResourcesInfo.beatSyncInfo
  • CriWare.CriAtomExDebug.ResourcesInfo.beatSyncTransitionSetting
  • CriWare.CriAtomExDebug.ResourcesInfo.beatSyncJob

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.
• _{[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

• _{[Atom][editor]} CRI Atom Timeline audio can now be previewed with 3D effects enabled in Unity's Edit mode.
• _{[Mana][all_platform]} Added the CriWare.CriMana.Player.SyncMasterTimer function.
• _{[Atom][all_platform]} Added functions to load ACB files using a fixed pointer:
  • CriWare.CriAtomExAcb.LoadAcbData(IntPtr, int, CriFsBinder, string)
  • CriWare.CriAtomExAcbLoader.LoadAcbDataAsync(IntPtr, int, CriFsBinder, string, bool)
• _{[Mana][all_platform]} Added functions to adjust concatenation when audio and video lengths do not match within the same usm file:
  • CriWare.CriMana.Player.SetAudioBaseConcatenation
  • CriWare.CriManaMovieMaterial.audioBaseConcatenation
• _[Atom][pc] Added the [Microsoft Spatial Sound] option to the Library Initializer component.
  • For OS versions lower than Windows 10 Build 1703, or when using a special audio interface, this flag needs to be set to false. Generally, we recommand not to change the default value(true) for this flag.

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:
  • Passing null to CriWare.CriMana.Player.UpdateMaterial
  • Setting CriWare.CriManaMovieMaterial.material to null
• _{[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.
  • CriWare.CriAtomEx.RegisterAcf
• _{[Atom][all_platform]} Removed the "VR Mode" flag from the Library Initializer.
• _[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

• _{[Atom][all_platform]} Added a "12ch(7.1.4ch)" option to the ASR Output Mode setting in the Library Initializer.
• _{[Atom][all_platform]} Added a "Use Spatializer" flag to the Library Initializer.
• _{[Atom][all_platform]} Added a flag to the library initialization configuration structure to perform the audio output via SonicSYNC. Please note that there are dedicated options for Android, iOS and Switch and the configuration for these platforms should be made separately.
  • Enable SonicSYNC
• _{[Mana][all_platform]} Added audio Time Stretch processing for speed-specific playback of videos with embedded audio.
  • Audio Time Stretch processing will be performed when AdvancedAudioMode is enabled in components such as CriManaMovieController.
  • AdvancedAudioMode is now enabled by default in components such as CriManaMovieController.
  • Added an AdvancedAudioMode setting to the CriManaMovieControllerForUI component.
  • Added the CriWare.CriMana.Player.SetTimeStretchQuality method for specifying the quality of the audio Time-Stretching.
• _{[Atom][all_platform]} Added the CriWare.CriAtomEx3dRegion.IsDestroyable method.
• _{[Mana][all_platform]} Added RectMask2D support for movies rendered as a part of the UI.
• _{[Atom][editor]} Improved the usability of the Atom Browser's UI.
  • Added the ability to search for Cues by name.
  • The SearchPath and ShowPrivateCue settings are now persisted and will be remembered when the window is opened again.
• _{[Atom][all_platform]} Added a "labelPtr" field and a "label" property to the CriWare.CriAtomExBeatSync structure.
• _{[Atom][all_platform]} Added a "silentMode" field to the CriWare.CriAtomEx.CueInfo structure.
• _{[Atom][all_platform]} The following functions were added to CriWare.CriAtomExCategory :
  • CriWare.CriAtomExCategory.Stop / CriWare.CriAtomExCategory.StopWithoutReleaseTime
  • CriWare.CriAtomExCategory.GetTotalVolume
  • CriWare.CriAtomExCategory.SetFadeInTime / CriWare.CriAtomExCategory.SetFadeOutTime
  • CriWare.CriAtomExCategory.AttachAisac / CriWare.CriAtomExCategory.DetachAisac / CriWare.CriAtomExCategory.DetachAisacAll
  • CriWare.CriAtomExCategory.ResetAllAisacControl / CriWare.CriAtomExCategory.GetNumAttachedAisacs
  • CriWare.CriAtomExCategory.GetNumCuePlayingCount
• _{[Atom][all_platform]} The minimum number of channels can now be specified when creating the following voice pools:
  • CriWare.CriAtomExStandardVoicePool
  • CriWare.CriAtomExWaveVoicePool
• _{[Atom][all_platform]} Added a function to get the CriWare.CriAtomExStandardVoicePool.Config configuration structure passed to the CriWare.CriAtomExStandardVoicePool constructor.
• _{[Atom][all_platform]} Added a function to get the CriWare.CriAtomExWaveVoicePool.Config configuration structure passed to the CriWare.CriAtomExWaveVoicePool constructor.
• _{[Atom][all_platform]} Added support for changing the speed of Playable in the Atom Timeline extension.
• _{[all_module][editor]} The Plugin now works even when Reload Domain is disabled in the Enter Play Mode Options. This feature can be toggled in "Project Settings/CRIWARE/Editor/Common". (Enabled by default)
• _{[Atom][all_platform]} Added members to the following enums to support spatial audio:
  • CriWare.CriAtomEx.SoundRendererType
  • CriWare.CriAtomExAsrRack.SpeakerMapping
• _{[Atom][all_platform]} Added the following methods to specify or retrieve the enabled/disabled status of the binauralizer:
  • CriWare.CriAtomExAsr.EnableBinauralizer
  • CriWare.CriAtomExAsr.IsEnabledBinauralizer
• _{[Atom][all_platform]} Added a "volume" member to the CriAtomExCueInfo structure.

Bug Fixes

• _[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:
  • CriWare.CriAtomExSequencer.OnCallback
  • CriWare.CriAtomExBeatSync.OnCallback
  • CriWare.CriAtomExPlayer.OnBeatSyncCallback
  • CriWare.CriAtomEx.OnCueLinkCallback
• _[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