PreferencePerk

継承:Perk セクション名:dialog 優先度:900(210)

PreferencePerkはユニットのプリファレンスを管理する機能を付与します。

全ユニットに共通な設定はグローバル設定の“system.preference”セクションに記述します。

{
    "system": {
        "preference": {
            "options": {
                "preferenceServer": Boolean|String,
            }
        }
    },
}

各ユニット固有の設定は“preference”セクションに記述します。

{
    "preference": {
        "options": {
            "preferenceServer": Boolean|String,
        },
        "targets": [String, ...],
    }
}

型:Boolean|String デフォルト:False

型:Array of String

変更を管理したいプリファレンス値のキーを指定します。複数のキーを指定できます。該当のキーのプリファレンス値に変更があった場合、applyスペルが呼び出され、関連するイベントがトリガされます。

プリファレンスサーバに接続します。サーバに接続すると、プリファレンスの変更があった時に通知を受け取ることができます。

applyスペルを呼び出し、プリファレンスをユニットに適用します。その際、e.detail.preferencesにすべてのプリファレンスが渡されます。

型:* 対象:unit

指定されたキーのプリファレンス値を返します。キーに指定がない場合、すべてのプリファレンス値を返します。

プリファレンス値です。

型:Undefined 対象:unit

指定されたキーにプリファレンス値をセットします。

なし。

型:Undefined 対象:unit 非同期

ユニットにプリファレンスを適用します。このパークでは適用するためのイベントを引数のトリガするのみです。

なし。

• beforeApplyPreferences
• doApplyPreferences
• afterApplyPreferences