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.

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.