CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
关于迁移到 SDK Ver.2.50

版本升级的主要变化

在CRIWARE SDK for Unity Ver.2.50中,与之前的版本相比,我们做了以下主要更改。
  1. 更改保证运行环境
    Android 操作系统支持的设备已从 2.1 或更高版本更改为 2.3 或更高版本。

  2. 更改插件文件结构
    更改了一些插件文件的文件夹结构。详情请参考下面的cri4u_sdk_changes_v250_plugin_update“关于更改插件文件结构”。
    在导入插件之前,您需要手动删除一些文件夹。

  3. 更改了 CriManaPlayer 使用的标准着色器文件的规格
    CriManaPlayer 标准使用的着色器文件名以及某些模型加载的着色器已更改。 如果您使用自定义着色器功能,请参阅 如果您正在自定义电影播放的着色器

  4. CRI ADX主要版本更新
    CRI ADX工具和运行时均已进行重大更新。
    该工具已从CRI Atom Craft Ver.1 替换为CRI Atom Craft Ver.2,并且项目文件不再兼容。
    使用CRI Atom Craft Ver.1项目文件时,需要使用转换工具将其转换为Ver.2。
    CRI Atom Craft Ver.1 的 ACF/ACB/AWB 音频数据输出也可以与新插件一起使用。

其他SDK更新请参考SDK变更历史文本和插件变更历史文本。

关于更改插件文件结构
与视频播放相关的插件的文件结构已部分更改。
如果您使用源代码控制工具管理插件文件,请反映以下更改。

  * Assets

  o * Plugins

  | \ * CriWare

  |   \ * CriMana

  |     o * Details

  |     \ * Shaders

  |       o * DesktopRGB.shader

  |       o * DesktopAdditive.shader

  |       o * DesktopAlpha.shader

  |       o * DesktopAlphaAdditive.shader

  |       o * GLES20RGB.shader

  |       o * GLES20Additive.shader

  |       o * GLES20Alpha.shader

  |       \ * GLES20AlphaAdditive.shader

  \ * Resources

    \ * CriWare

      \ * CriMana

 

 

 

 

: 重命名 -> 详细信息 *重命名里面的所有文件

 

: 重命名> ForwardRgb.shader

: 重命名 > ForwardRgbAdditive.shader

: 重命名> ForwardRgba.shader

: 重命名 > ForwardRgbaAdditive.shader

: 重命名 > Yuv2Rgb.shader

: 重命名 > Yuv2RgbAdditive.shader

: 重命名> Yuva2Rgba.shader

: 重命名 > Yuva2RgbaAdditive.shader

 

 

: 移动 -> Plugins/CriWare/CriMana/Resources *重命名里面的所有文件。

 

  * Assets

  \ * Plugins

    \ * CriWare

      \ * CriMana

        o * Detail

        o * Resources

        \ * Shaders

          o * ForwardRgb.shader

          o * ForwardRgba.shader

          o * ForwardRgbaAdditive.shader

          o * ForwardRgbAdditive.shader

          o * Yuv2Rgb.shader

          o * Yuv2RgbAdditive.shader

          o * Yuva2Rgba.shader

          \ * Yuva2RgbaAdditive.shader

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

注意
如果将新的插件包导入到包含以前的插件包的环境中,则Unity项目中可能会残留不必要的文件,这可能会带来麻烦。
在导入Ver.2.5x unitypackage之前,请务必删除以下文件和文件夹。
  • Plugins/CriWare/CriMana/Details/CriManaPlayerImpl.cs
  • Plugins/CriWare/CriMana/Details
  • Plugins/CriWare/CriMana/Shaders/DesktopAdditive.shader
  • Plugins/CriWare/CriMana/Shaders/DesktopAlpha.shader
  • Plugins/CriWare/CriMana/Shaders/DesktopAlphaAdditive.shader
  • Plugins/CriWare/CriMana/Shaders/DesktopRGB.shader
  • Plugins/CriWare/CriMana/Shaders/GLES20Additive.shader
  • Plugins/CriWare/CriMana/Shaders/GLES20Alpha.shader
  • Plugins/CriWare/CriMana/Shaders/GLES20AlphaAdditive.shader
  • Plugins/CriWare/CriMana/Shaders/GLES20RGB.shader
  • Resources/CriWare/CriMana/DesktopShaderHolder/Additive.prefab
  • Resources/CriWare/CriMana/DesktopShaderHolder/Alpha.prefab
  • Resources/CriWare/CriMana/DesktopShaderHolder/AlphaAdditive.prefab
  • Resources/CriWare/CriMana/DesktopShaderHolder/RGB.prefab
  • Resources/CriWare/CriMana/MobileShaderHolder/Additive.prefab
  • Resources/CriWare/CriMana/MobileShaderHolder/Alpha.prefab
  • Resources/CriWare/CriMana/MobileShaderHolder/AlphaAdditive.prefab
  • Resources/CriWare/CriMana/MobileShaderHolder/RGB.prefab
  • Resources/CriWare/CriMana
  • Resources/CriWare

如果您正在自定义影片播放着色器
由于上面shader文件名的变化,用于视频播放的CRI Mana Player组件 着色器名称也已更改。
除了更改着色器名称之外,我们还更改了该插件中某些模型使用的着色器本身。 因此,如果您使用自定义着色器功能来切换着色器文件, 请参阅 此处 了解 CriManaPlayer.shaderDispatchFunction 请更正属性中注册的着色器调度函数的实现。

关于CRI Atom Craft Ver.2
CRI Atom Craft Ver.2 添加了一些主要功能。
  • 多人开发支持功能
  • 版本控制工具配合功能
  • 动作/节拍同步/选择器
基本工具的使用方法与Ver.1没有区别。
关于新添加的功能和工程文件转换的详细信息,请参考《CRI Atom Craft V2》差异手册。
  • cri/tools/criatomex/CRI_Atom_Tools_V2_Manual_j.chm