コンテキスト メニューに選択肢を追加する

extensions = {
    contextual_actions = [
        {
            label = "Open In Sublime"
            type = "asset"

            when = {
                ...
            }

            when_multi_select = {
                ...
            }

            do = [
                ...
            ]
        }
    ]
}

{
    label = "Open in Paint"
    type = "asset"

    when = {
        // Matches both types of image file
        extension = [
            "png"
            "jpg"
        ]
    }

    do = [
        {
            type = "process"
            path = "\"C:\\Program Files\\paint.net\\PaintDotNet.exe\" \"$project\\$1\""
        }
    ]
}

{
    type = "asset"
    label = "Open In Sublime"

    when = {
        // Matches any asset type
        extension = "*"
    }

    do = [
        {
            type = "process"
            path = "\"C:\\Program Files\\Sublime Text 3\\sublime_text.exe\" \"$project\\$1\""
        }
    ]
}

// In tests-actions.stingray_plugin
{
    label = "Checkout"
    type = "asset"

    when = {
        extension = "*"
        predicate = {
            type = "js"
            module = "module-actions"
            function_name = "isReadOnly"
        }
    }

    do = [
        {
            type = "js"
            module = "module-actions"
            function_name = "checkout"
        }
    ]
}
// In module-actions.js

define(['common/file-system-utils', 'services/file-system-service', 'services/project-service'], function (fileUtils, fileSystemService, assetService, projectService) {

    return {
        // The first parameter passed to an asset predicate is the path to the asset within the project (effectively the
        // asset resource name and its file extension). For example, content/models/character.unit
        isReadOnly: function (assetRelativePath) {

            // The API for invoking predicate actions is Promise based (thus asynchronous). The final Promise must return something
            // "truthy" in order for the contextual action to appear in the contextual menu.
            return projectService.relativePathToAbsolute(assetRelativePath).then(function (absPath) {
                return fileSystemService.isReadOnly(absPath);
            });
        },
    }
});

// Example in tests-actions.stingray_plugin
{
    type = "asset"
    label = "Duplicate"

    // Note that this action works both for single asset and multi selection of assets
    when = {
        extension = "*"
    }

    // when_multi_select is a predicate.
    when_multi_select = {
        // This is a nice trick when_multi_select should always be true: invoke an in-place script that returns true.
        type = "js"
        script = "true"
    }

    do = [
        {
            type = "js"
            module = "module-actions"
            function_name = "duplicateAssets"
        }
    ]
}
// In module-actions.js
define(['common/file-system-utils', 'services/file-system-service', 'services/project-service'], function (fileUtils, fileSystemService, assetService, projectService) {

    return {
        // Since this action can be invoked both for single and multi selection, we need to check whether its parameter is an array or not.
        duplicateAssets: function (assets) {
            if (!_.isArray(assets)) {
                assets = [assets];
            }

            // Note that each elements in the assets array is a relative asset path.
            _.each(assets, function (assetRelativePath) {
                // Do something to duplicate an asset
            });
        },
    }
});

// From asset-browser.stingray_plugin
contextual_actions = [
    {
        type = "level_object"
        label = "Find in Asset Browser"

        // Context specific for asset types
        when = {
                category = "unit"
        }

        do = [
            {
                type = "js"
                module = "asset-browser-actions"
                function_name = "findLevelUnitInAssetBrowser"
            }
        ]
    }
]

{
    type = "level_object"
    label = "Reset position"

    when = {
        category = ["unit", "light"]
    }

    do = [
        {
            type = "js"
            module = "asset-browser-actions"
            function_name = "setPosToZero"
        }
    ]
}

// In test-actions.stingray_plugin
{
    type = "level_object"
    label = "Close door"

    // Context specific for asset types
    when = {
        category = "unit"
        predicate = {
            type = "js"
            module = "module-actions"
            function_name = "isDoor"
        }
    }

    do = [
        {
            type = "js"
            module = "module-actions"
            function_name = "closeDoor"
        }
    ]
}
// In module-actions.js
isDoor: function (levelObjectTreeNode) {
    // If the unit resource that corresponds to the level object is a door, allow the user to close it.
    return levelObjectTreeNode.dataContext.Type &&
        levelObjectTreeNode.dataContext.Type.startsWith('model/content/door_');
}

{
    type = "level_object"
    label = "Duplicate Objects"

    // Works both for single level object selection and for multi selection.
    when = {
        category = "*"
    }

    when_multi_select = {
        type = "js"
        script = "true"
    }

    do = [
        {
            type = "js"
            module = "module-actions"
            function_name = "duplicateLevelObjects"
        }
    ]
}
// from module-actions.js
duplicateLevelObjects: function (levelObjects) {
    if (!_.isArray(levelObjects)) {
        levelObjects = [levelObjects];
    }

    _.each(levelObjects, function (levelObject) {
        // dataContext corresponds to the level object Backend Remote Object. Id is the Level Obejct unique id in the level.
        levelEditingService.duplicate(levelObject.dataContext.Id);
    });
}