CRIWARE Unity Plugin Manual
Last Updated: 2024-07-12
Release Note
Development Information
Restrictions (for all platforms)
Do not include comma ',', tab '\t', or line break '\n' in file paths.
These characters prevent CRI libraries and tools from correctly interpreting the path.
File opening errors or memory allocation errors may occur if the file path is not set properly.
When you record a game scene with a game recording middleware such as "Everyplay", the sounds played by our Plugin may not be recorded.
For more details, please refer to "Platform-specific information"->"Using game recording middleware" in the CRIWARE Unity Plugin Manual.
Currently, the CRIWARE audio in low-latency playback mode is not recorded by game recording middleware (including Everyplay).
Known Issues (for all platforms)
There is a chance for the application/Unity editor to hang up when the plugin is finallized while using in-game preview.
To avoid this issue, please disconnect from the CRI Atom Craft before finallizing the plugin.
Movie playback may stop working when seeking through a movie with looping enabled.
Unfortunately, no workaround is available at the moment. Please avoid using seeking and looping playback simultaneously.
Crash may occur at the end of a video playback if the CriManaMovieController is created with Ambisonics
If you disable the Mana Preview -> Enable Timeline Scrub Playback project setting, the editor may hang up in the following situation.
Edit the video file name of a Mana Timeline clip with the Unity Timeline cursor positioned on the same clip.
To avoid the issue, enable the corresponding setting from Project Settings -> CRIWARE -> Editor -> Mana Preview.
Known issues will be fixed in the future releases of the SDK.
Unity Editor
System Requirements
Please refer to the system requirements for Unity
Test Environment
Unity Ver.2022.3.17f1
Notes
On macOS, security warnings may prevent the library from loading when opening the Unity sample projects included in the SDK.
In order to check the sample projects, please allow the library to open and then restart the Unity Editor.
Futhermore, to check the operation of the Asset Support Add-on, please re-import the CRI assets after restarting the Unity Editor.
Android
System Requirements
Unity 2018 or later
Models with ARM64/ARMv7/x86/x64-compliant CPU and Android OS 4.4 or later. (Please note that testing on the emulator is not performed.)
Test Environment
Android NDK (Revision r20)
Android SDK
Java Development Kit
Known Issues
On Android devices equipped with dual speakers, the output channel does not change even when the device is rotated, so the stereo output may not work as intended.
If Graphics API is set to vulkan, Unity 2019.1 or higher is required for CRI Mana to work.
Even with Unity 2018, you can build the app itself.
However, when building with Unity 2018, it has been confirmed that the app crashes on startup or movie materials error when playing.
The following issue occurs when the "SonicSYNC" function is enabled.
On some devices, sound stuttering may occur when performing system operations such as "volume control using device buttons, etc." or "on/off airplane mode."
When playing a video with audio while a Bluetooth headset is connected, audio interruptions or stutters occur.
iOS
System Requirements
Unity 2018 or later
Models with a ARM v7/arm64-compliant CPU and iOS 10 or later. (Please note that the Plugin will not work on the simulator due to the restrictions from the Unity native Plugin.)
Test Environment
iOS 17.2.1
Xcode 15
Known Issues
When performing sound playback with CRI Atom, Unity's standard microphone input will not work properly.
For iOS, on Unity versions where OpenGLES2 is deprecated (e.g. Unity2019.3), H.264 video playback cannot be performed normally when OpenGLES2 is selected as the Graphics API.
Please contact us if you need to use H.264 playback in that environment.
The following issues will occur when the "SonicSYNC" function is enabled.
Sound stuttering occurs during Xcode debugging on dual-core devices such as iPhone 7 or earlier models.
MacOSX
System Requirements
Unity 2018 or later
Mac OS X 10.13 or later (only 64bit is supported)
Test Environment
Mac OS X 13.3.1
Xcode 14.3
Known defects
If all of the following conditions are met when playing a video, the video may not play smoothly or the warning W2015080610 may occur.
[CRIWARE Library Initializer]->[Enable SonicSYNC] is true
Outputting audio from an external audio device
PC(Windows)
System Requirements
Unity 2018 or later
Windows 7 / 8.1 / 10 / 11
DirectX End-User Runtime (June 2010)
Microsoft .NET Framework 3.5 SP1
Microsoft .NET Framework 4.0
Test Environment
Windows 10 Pro (64bit)
Version Informations
SDK
CRIWARE SDK for Unity
Ver.3.10.01
Plugins
CRIWARE Unity plugin
Ver.2.42.46
Tools
CRI Atom tools Ver.3
Ver.3.52.02
CRI File System tools
Ver.2.52.00
Sofdec tools
Ver.2.24.03
ADX LipSync tools
Ver.1.00.02
Version Information Viewer
Ver.1.50
Add-on Plugins
Asset Support Add-on
Ver.1.1.04+0.8.09
Expansion Plugins
CRI ADX LipSync Unity Expansion
Ver.1.02.11
CRI ADX Audio Effect McDSP Expansion
Ver.1.01.02
CRI Sofdec Codec VP9 Expansion
Ver.1.01.06
CRI File System Web Installer Curl Expansion
Ver.1.00.01
CRI Afx Sound xR Expansion
Ver.1.0.1
THIS SERVICE MAY CONTAIN TRANSLATIONS POWERED BY GOOGLE. GOOGLE DISCLAIMS ALL WARRANTIES RELATED TO THE TRANSLATIONS, EXPRESS OR IMPLIED, INCLUDING ANY WARRANTIES OF ACCURACY, RELIABILITY, AND ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.