UndoPro

undopro

Undoproは、Unityのデフォルトシステムに統合されたコマンドベースの元に戻すシステムです。これにより、開発者はユーザーを新しい元気な作業フローに強制せずに、元に戻す/やり直しのアクションを使用できます！

フォーラムスレッド

インストール

UndoProの使用方法 /ツールの配布方法によっては、いくつかのオプションがあります。

1. Unityパッケージマネージャー（推奨）
   Unityパッケージマネージャーに移動し、git urlで追加し、https：//github.com/seneral/undopro.git#release-pkgを入力してください
   または、リリース-PKGブランチからダウンロードして、以前のUnityバージョンにディスクからインストール
   undoproに基づいてツールを配布する場合、ユーザーは最初にundoproを手動でインストールする必要があります。
   しかし、このオプションは、UndoProを使用して他のツールと最も互換性があり、自動的に更新することもできます
2. undoproを個別にインストールして配布します
   2番目に最良のオプションは、undoproを変更しないでください。すべての関係ツールがガイドをそのままに保つ限り、それをうまく配布することができます。しかし、UnityがUndoproを破り、それを機能させるためにホットな修正が必要な場合、あなたは問題に遭遇しますが、あなたまたは他のツールはまだあなたのツールと一緒に古いUndoproバージョンを配布しています
3. Undoproをプロジェクトに埋め込みました
   すべてのガイドを必ず変更し、すべてのundoproコードを個別の名前空間に包み、アセンブリ定義を変更してください。そうしないと、他のツールと競合します。
   あなたが配布するUndoproバージョンが最新であることを確認するためだけに責任を負うので、お勧めしません。
   undoproの特定のバージョンが絶対に必要な場合、またはツールで使用する前に変更したい場合にのみこれを行います。

特徴

• 元に戻すための拡張コールバック：レコード名で元に戻す/やり直し、onaddundorecord、...
• コマンドベースの元に戻すレコードを作成するためのAPI
• コンテキストを使用しても、ほとんどの匿名のアクションを問題なく処理します！

それがどのように機能するか

Unityは、UNDOシステムに関する非常に限られた情報のみを提供します。

• 現在のレコードのIDですが、着実に増加するのではなく、ユニークではありません：/
• 現在のレコード/グループ名（一意ではない）
• リフレクションでは、名前のみで完全な元に戻す/やり直したスタック（一意ではありません）
• undoredoperformedコールバック

内部的には、コマンドベースのレコードを追加するためのAPIが呼び出されると、UndoProはデフォルトシステムにダミーレコードを作成します。これは、利用可能なコールバックを使用して追跡され、コマンドはそれぞれやり直しスタックまたはその他の方法から切り替えると実行されます。大きなハーデンは、デフォルトの元に戻すシステムの動作でした。それはほとんど予測不可能です！レコードは、元に戻す/やり直したときに特定の条件で複製するか、消滅する場合があります。それは非常に困難ですが、しっかりした追跡アルゴリズムを作成するための要件です。明らかに、新しいレコードの追加も検出する必要があります。

追跡が行われた場合、元に戻すとスタックの両方のシフト値が別々に計算されます（覚えておいてください、元に戻す/やり直し中に記録が消えたり重複したりする可能性があります！）。その後、内部レコードがそれに応じて更新され、元に戻す/redoのレコードが概説されています。

これらすべての方法で、追加のコールバックonundoperformed/onredoperformed/onaddundorecordが呼び出されます。

コマンドベースのレコードのシリアル化

シリアル化も大きな問題であり、アクション、さらに悪い匿名のアクションをシリアル化するのは困難です。 Undoproは、シリアル化する必要があるすべてのカスタムレコードを保持する現在のシーンに隠された一時的なGameObjectを維持しています。シリアル化は、アクション、オブジェクト、メソッドなどのすべての組み合わせをインテリジェントに処理するいくつかのラッパークラスによって達成されます。

このシステムは一般的に使用することもできます！ - >すべてのシリアル化可能なオブジェクト（UnityEngine.Objectとsystem.Objectの両方）と非正解オブジェクトを部分的にサポートします（1レイヤーシリアル化可能なメンバーシリアル化）、他のすべてのオブジェクトはデフォルト化されます - >ほとんどの匿名アクションでもサポートされます（まだ見つかりません）！コンテキストを完全に使用して、ほぼすべてのローカル変数を参照できます（上記の条件が適用されます）！

問題

このシステムは信頼できるように見えますが、完全に防弾であるとは主張していません！ただし、追跡を台無しにしたときに発生する可能性のある最悪のケースは、レコードが少量で相殺されることです（アクションは1つまたは2つのレコードが実行されるか2つのレコードが実行されます）。幸いなことにそのような状況は現在ありませんが、失敗に対して責任を負いません！あなたがそれを壊すことができた場合は、それについて私に通知し、あなたがしたことの情報を（問題を通して）提供してください、そして私はこれを修正しようとします:)

インストール

プロジェクトのどこかにundoproフォルダーを置くだけで、あなたは行きます！エディターフォルダーにある必要はありませんが、実行時に使用できるという意味ではありません。エディターAPIを必要とする機能は、プリプロセッサチェックによって実行時に除外されます。一方、エディターフォルダーには、1の機能をテストする2つの便利なウィンドウがあります。元のシステム自体と2。アクションシリアル化システム。これらのウィンドウに加えて、システムを簡単にデバッグして、#define undo_debug in undopromanagerでどのように機能するかを確認できます。あなた自身のプロジェクトにアクションシリアル化システムを使用するために、もちろんライセンスとともにフォルダーUndopro/serializableActionをコピーするだけです！

API

開発者向けのAPIは非常に簡単です。 undopro依存関係を追加してから、undopromanagerを使用してシステムと対話します。重要な要素：

• RecordOpterationAndPerform-ラベルとともに元に戻す/やり直すためのアクションを受け入れ、レコードとして追加します。さらに、REDOアクションが実行されます。
• RecordOperation（2つのオーバーロード） - ラベルとともに元に戻す/やり直すためのアクションを受け入れ、レコードとして追加します。既に手動でアクションを実行している場合は使用してください
• OnUndoperformed Callback-元に戻したときに呼び出されました。すべての元に戻すレコードを渡します。これは、グループ化された場合に複数になる可能性があります。
• OnRedoperformed CallBack -REDOが実行されたときに呼び出されます。すべてのRedoneレコードを渡します。これは、グループ化された場合に複数になります。
• OnaddundoreCordコールバック-UndoProとデフォルトシステムの両方から、レコードが追加されたときに呼び出されます。その名前と「重要」と見なされるかどうかを渡します（追加されたときにRedoスタックをクリアする記録もあります。これは、追加されたレコードが最後のレコードグループに含まれているかどうか、または新しいグループを開いたかどうかに関連する可能性があります（不確実）。
• enabableUndopro/disableUndopro-システムの状態を切り替えます。単にレコードにホールを作成し、以前のレコードを台無しにするため、無効にすることはお勧めしません！

推奨事項：何かを計算したり、中間結果で操作を実行した場合、結果がシリアル化可能であれば、これをセットアップするのは非常に簡単です。元に戻す/redoアクションで再計算する代わりに、以前のシリアル化可能な結果を元に戻すアクションとREDOアクションの新しい結果を設定するだけです。終わり！

著者とライセンス

この拡張機能はSeneralによって作成され、MITライセンスの下で公開されています（ライセンスでさらに指定されています。MD）