CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
发行说明

开发信息

限制(所有型号通用)

  • 文件路径中请勿包含逗号:','、制表符:'\t' 或换行符:'\n' 字符。
    • 这些字符会阻止CRI库和工具正确解释路径。
    • 可能会出现由于文件路径不正确而无法打开文件或分配内存失败等错误。
  • 当我们的插件与录音中间件(例如Everyplay)一起使用时,音频可能无法正确录制。
    • 更多信息请参考SDK手册中的“设备特定信息”->“游戏录制中间件的使用”页面。
    • 目前, CRIWARE插件的低延迟播放模式不被游戏录制中间件(包括Everyplay)录制。

已知错误(所有型号共有)

  • 如果您在连接到游戏内预览时关闭插件,应用程序将以一定的速度挂起。
    • 为避免此问题,请在关闭插件之前断开CRI Atom Craft端的游戏内预览。
  • 当同时使用Seek播放和循环播放时,存在视频播放中途停止的问题。
    • 目前尚未找到解决方法,因此请暂时避免同时使用Seek播放和循环播放。
  • 如果您创建启用高保真度立体声响复制模式的 CriManaMovieController 并播放视频,则播放结束时可能会崩溃。
  • Mana Preview -> Enable Timeline Scrub Playback 如果禁用项目设置,编辑器可能会在以下情况下挂起。
    • 将 Unity 时间线光标置于同一剪辑上,编辑 Mana 时间线剪辑的视频文件名。
    • 为了避免该问题,请从 Project Settings -> CRIWARE -> Editor -> Mana Preview 启用相应的设置。
  • 所有型号常见或特定的已知问题将在未来的 SDK 版本中修复。

Unity Editor

执行要求

  • Please refer to the system requirements for Unity

执行确认

  • Unity Ver.2022.3.17f1

备注

  • 如果您在 Mac OSX 环境中打开下载的 SDK 中的示例项目,由于安全警告,您可能无法加载该库。
    • 如果您想查看示例项目的工作原理,请在允许库打开后重新启动 UnityEditor。
    • 另外,如果您想检查 Asset Support Add-on 的行为,请在重新启动 Unity Editor后重新导入CRI资产。

Android

执行要求

  • 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.)

执行确认

  • Android NDK (Revision r20)
  • Android SDK
  • Java Development Kit

已知缺陷

  • 在配备双扬声器的 Android 设备上,即使设备旋转,输出通道也不会改变,因此立体声输出可能无法按预期工作。
  • 如果图形 API 设置为 vulkan,则CRI Mana 需要 Unity 2019.1 或更高版本才能工作。
    • 即使使用 Unity 2018,您也可以自行构建应用程序。
    • 然而,使用Unity 2018构建时,已确认应用程序启动时崩溃或电影素材在播放时出错。
  • 启用“SonicSYNC”功能时会出现以下问题。
    • 在某些设备上,执行“使用设备按钮等进行音量控制”或“打开/关闭飞行模式”等系统操作时,会出现声音中断(小噪音)。
    • 连接蓝牙耳机时播放带音频的视频时,会出现音频中断或卡顿的情况。

iOS

执行要求

  • 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.)

执行确认

  • iOS 17.2.1
  • Xcode 15

已知缺陷

  • 如果启用CRI Atom的音频播放,Unity 的标准麦克风输入功能将无法正常工作。
  • 我们已确认,在 Unity 2019.3 等已弃用 OpenGLES2 的版本中,当启用 OpenGLES2 作为图形 API 时,无法正确执行 H.264 编解码器视频播放。
    • 如果您想在上述环境下使用H.264播放,请单独联系我们。
  • 启用“SonicSYNC”功能时会出现以下问题。
    • 在 iPhone 7 或更早版本等双核设备上使用连接的 Xcode 进行调试时,会出现音频中断(小噪音)。

MacOSX

执行要求

  • Unity 2018 or later
  • Mac OS X 10.13 or later (only 64bit is supported)

执行确认

  • Mac OS X 13.3.1
  • Xcode 14.3

已知缺陷

  • 如果播放视频时满足以下所有条件,则视频可能无法流畅播放,或者可能出现警告 W2015080610。

PC(Windows)

执行要求

  • 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

执行确认

  • Windows 10 Pro (64bit)

版本信息

SDK

  • CRIWARE SDK for Unity
    • Ver.3.10.01

插件

  • CRIWARE Unity plugin
    • Ver.2.42.46

工具

  • CRI Atom工具版本 3
    • Ver.3.52.02
  • CRI File System工具
    • Ver.2.52.00 -Sofdec工具
    • Ver.2.24.03
  • ADX LipSync 工具
    • Ver.1.00.02
  • 版本信息查看工具
    • Ver.1.50

附加插件

  • Asset Support Add-on
    • Ver.1.1.04+0.8.09

扩展插件

  • 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.