CRIWARE for C#

CRIWARE for C# はC#開発環境で利用可能なCRIWAREプラグインです。
本マニュアルはCRIWARE for C# の利用方法やサンプルプロジェクトの説明を含みます。

対応環境

  • 対応ランタイムは次のとおりです

    • netstandard2.1
    • Unity 2021 以降

  • 対応機種は次のとおりです。

    • Windows x86_64
    • macOS x86_64/arm64
    • iOS arm64
    • Android armeabi-v7a/arm64-v8a
    • Linux x86_64

ライブラリに関する詳細な情報は各パッケージ内のドキュメントをご確認ください。

対応プロダクト

本SDKでは次のミドルウェアに対応しています

  • CRI ADX
  • ファイルマジック PRO

各ミドルウェアの機能説明はネイティブSDK向けマニュアルもご参照ください。

他SDKからの移行

Unityプラグインに慣れている方へ

CRIWARE for Unityではプラグイン内部で行っていた一部処理を、アプリケーション側で行う必要があります。
詳細はサンプルプロジェクトをご確認ください。

初期化処理

Unityプラグインではシーン内にコンポーネントを配置して初期化を行いますが、本プラグインではコードからの初期化が必須です。
このとき、Unityプラグインでは初期化処理に付随して行っていた各種リソースの確保が明示的に必要です。
最低限、ボイスプールとDbasの作成をおすすめします。

ゲームオブジェクト/コンポーネント

CRIWARE for C# では GameObject/Component 等のUnity特有機能との連携はありません。
例として、3Dポジショニングを行う場合はTransformが持つ座標/姿勢の情報を毎フレームCriAtomEx3dSourceへ渡す必要があります。
CriAtomExPlayer等のネイティブラッパークラスを利用していた場合は引き続き同様の利用が可能です。

ネイティブプラグインに慣れている方へ

本プラグインはネイティブSDKとほぼ同様のAPI体系で利用いただけますが、アロケータの利用を前提としている点にご留意ください。

本プラグインでは専用のアロケータを利用する前提でハンドルを管理しています。
ネイティブAPIを利用する場合、初期化や各ハンドルの確保時にワーク領域とサイズを渡すことが可能ですが、本プラグインでは非推奨です。

また、アロケータはCriWare.CriAtomCSharp.Initialize(CriWare.CriAtomCSharp.Config)メソッド内で登録されます。
上記メソッドを利用する場合はアプリケーションコードからアロケータを登録する必要はありません。
機種固有の初期化メソッドを利用する場合は、CriWare.CriAtomCSharp.SetupDefaultAllocator()メソッドを利用して 専用のアロケータを登録してください。