Use Custom Scripts

Use Custom Scripts to further extend and customize your pipeline by running your own code.

阅读时间2 分钟

最后更新于 8 个月前

重要

You're solely responsible for any custom code you enter, and Unity is not liable for any errors, malfunctions, or damages resulting from the use of your custom code.

You can provide code tailored to your needs. The following apps support Custom Scripts:

Asset Transformer
Linux Shell
Python
Blender

You can use Custom Scripts in two ways:

Enter custom code in the built-in editor, and execute it with command-line arguments (optional).
Fetch a script from a script library and execute it with command-line arguments (optional).

Prerequisites

You can access Custom Scripts when you create or edit a pipeline.

Enter custom script code

To enter your custom code:

Sign in to your Unity Dashboard account.
In the side navigation bar, select Pipeline Automation > Pipelines. You can create or edit a pipeline.
In the pipeline builder, add a step. The Select an action from app dialog opens.
Select the Python app.
Select the Run Custom Script action.
Select Add Action. In the Step Parameters tab, the Custom Scripts section appears in the Inputs section.
Enter your code in the built-in editor or select Browse Files to upload a script file from your local drive. The script code from your file appears in the built-in editor.
Enter Command Line Arguments to pass as pipeline inputs.
Select Save.

Your custom script is now embedded in the pipeline. When you run the pipeline, it runs your script file and prompts for input if you enable Command Line Arguments.

Fetch and run a custom script

To run a script in this way, ensure the script exists in the job’s storage. First download it from a source such as Unity Asset Manager or Unity Version Control. The output of an action that downloads files includes parameters that locate the downloaded script path. You must provide this path to actions that run script files.

To fetch and run a custom script file:

Sign in to your Unity Dashboard account.
In the side navigation bar, select Pipeline Automation > Pipelines. You can create or edit a pipeline.
In the pipeline builder, add a step. The Select an action from app dialog opens.
Select the Python app.
Select the Run Custom Script File action.
Select Add Action. In the Step Parameters tab, the Custom Scripts section appears in the Inputs section.
In the Script Path field, select Download file – Download Directory and enter the script file name, for example,
```
/scriptexample.py
```
.
Enter Command Line Arguments to allow the script to receive parameters generated by the pipeline.
Select Save.

Your custom script is now embedded in the pipeline. When you run the pipeline, it runs your script file and prompts for input if you enable Command Line Arguments.

文档

Development

User Acquisition

Monetization

工业

文档