変更イベント

変更イベントは、AddressableAssetGroup や AddressableAssetEntry が追加または削除された場合など、特定のデータが操作されたときに Addressables システムの各部分に通知するために使用されます。

変更イベントは、Addressables の内部で SetDirty 呼び出しの一部としてトリガーされます。SetDirty は、AssetDatabase によるアセットの再シリアル化が必要になったことを示すために使用されます。この SetDirty の一部として、以下の 2 つの変更イベントコールバックがトリガーされる可能性があります。

  • public static event Action<AddressableAssetSettings, ModificationEvent, object> OnModificationGlobal
  • public Action<AddressableAssetSettings, ModificationEvent, object> OnModification { get; set; }

これらは AddressableAssetSettings に定義されており、それぞれ静的アクセサーまたはインスタンスアクセサーを通じてアクセスできます。

サンプルコード

AddressableAssetSettings.OnModificationGlobal += (settings, modificationEvent, data) =>
        {
            if(modificationEvent == AddressableAssetSettings.ModificationEvent.EntryAdded)
            {
                //処理を実行
            }
        };

        AddressableAssetSettingsDefaultObject.Settings.OnModification += (settings, modificationEvent, data) =>
        {
            if (modificationEvent == AddressableAssetSettings.ModificationEvent.EntryAdded)
            {
                //処理を実行
            }
        };

変更イベントには、イベントに関連付けられたデータの汎用 Object が渡されます。以下に示すのは、変更イベントとそれらで渡されるデータタイプのリストです。

各変更イベントで渡されるデータ

  • GroupAdded このイベントで渡されるデータは、加えられた AddressableAssetGroup またはグループのリストです。
  • GroupRemoved このイベントで渡されるデータは、削除された AddressableAssetGroup またはグループのリストです。
  • GroupRenamed このイベントで渡されるデータは、名前が変更された AddressableAssetGroup またはグループのリストです。
  • GroupSchemaAdded このイベントで渡されるデータは、スキーマが加えられた AddressableAssetGroup、またはグループのリストです。
  • GroupSchemaRemoved このイベントで渡されるデータは、スキーマが削除された AddressableAssetGroup、またはグループのリストです。
  • GroupSchemaModified このイベントで渡されるデータは、変更された AddressableAssetGroupSchema です。
  • GroupTemplateAdded このイベントで渡されるデータは、追加されたグループテンプレートオブジェクトを表す ScriptableObject で、通常は IGroupTemplate が実装されています。
  • GroupTemplateRemoved このイベントで渡されるデータは、削除されたグループテンプレートオブジェクトを表す ScriptableObject で、通常は IGroupTemplate が実装されています。
  • GroupTemplateSchemaAdded このイベントで渡されるデータは、スキーマが加えられた AddressableAssetGroupTemplate です。
  • GroupTemplateSchemaRemoved このイベントで渡されるデータは、スキーマが削除された AddressableAssetGroupTemplate です。
  • EntryCreated このイベントで渡されるデータは、作成された AddressableAssetEntry です。
  • EntryAdded このイベントで渡されるデータは、加えられた AddressableAssetEntry またはエントリーのリストです。
  • EntryMoved このイベントで渡されるデータは、あるグループから別のグループに移動された AddressableAssetEntry またはエントリーのリストです。
  • EntryRemoved このイベントで渡されるデータは、削除された AddressableAssetEntry またはエントリーのリストです。
  • LabelAdded このイベントで渡されるデータは、加えられた String ラベルです。
  • LabelRemoved このイベントで渡されるデータは、削除された String ラベルです。
  • ProfileAdded このイベントで渡されるデータは、加えられた [BuildProfile] です。
  • ProfileRemoved このイベントで渡されるデータは、削除されたプロファイル ID の String です。
  • ProfileModified このイベントで渡されるデータは、変更された [BuildProfile]、または BuildProfile のバッチが変更された場合は null です。
  • ActiveProfileSet このイベントで渡されるデータは、アクティブなプロファイルとして設定されたプロファイル ID の String です。
  • EntryModified このイベントで渡されるデータは、変更された AddressableAssetEntry またはエントリーのリストです。
  • BuildSettingsChanged このイベントで渡されるデータは、変更された AddressableAssetBuildSettings オブジェクトです。
  • ActiveBuildScriptChanged このイベントで渡されるデータは、アクティブなビルダーとして設定された IDataBuilder ビルドスクリプトです。
  • DataBuilderAdded このイベントで渡されるデータは、DataBuilder のリストに追加された ScriptableObject で、通常は IDataBuilder が実装されています。
  • DataBuilderRemoved このイベントで渡されるデータは、DataBuilder のリストから削除された ScriptableObject で、通常は IDataBuilder が実装されています。
  • InitializationObjectAdded このイベントで渡されるデータは、InitializationObject のリストに追加された ScriptableObject で、通常は IObjectInitializationDataProvider が実装されています。
  • InitializationObjectRemoved このイベントで渡されるデータは、InitializationObject のリストから削除された ScriptableObject で、通常は IObjectInitializationDataProvider が実装されています。
  • ActivePlayModeScriptChanged このイベントで渡されるデータは、新しくアクティブな再生モードデータビルダーとして設定された IDataBuilder です。
  • BatchModification このイベントで渡されるデータは null です。このイベントは主に、いくつかのイベントが同時に発生していて、AddressableAssetSettings オブジェクトをダーティとしてマークする必要があることを示すために使用されます。
  • HostingServicesManagerModified 渡されるデータは、変更された HostingServicesManager または HttpHostingService です。
  • GroupMoved このイベントで渡されるデータは、AddressableAssetGroup の完全なリストです。
  • CertificateHandlerChanged このイベントで渡されるデータは、使用される証明書ハンドラーの新しい System.Type です。