![]() |
发布提供将文件发布至 Shotgun 的用户界面和功能。 |

通过发布应用,艺术家可以发布他们的作品,以便其可供下游的艺术家使用。它支持在艺术家的内容创建软件中以传统方式发布工作流,以及在磁盘上单独发布任何文件。在内容创建软件中操作并使用基本 Shotgun 集成时,该应用将自动发现并显示项目以供艺术家发布。对于较复杂的生产需求,工作室可以编写自定义发布插件来推动艺术家工作流。
文档
发布器的完整文档位于此处。
相关应用和文档
![]() |
加载器使用 Shotgun 加载器可以快速简要了解和浏览已发布到 Shotgun 的文件。通过一个可搜索的树视图导航系统可以轻松快速地到达您要查找的任务、镜头或资产,之后,加载器显示相应项目的所有发布的缩略图式概况。通过可配置的挂钩,您便可以轻松地在您的当前场景中引用或导入发布。 |
![]() |
Shotgun 面板通过 Shotgun 面板可以快速访问某个嵌入式面板中的 Shotgun 信息。可以使用它轻松访问有关用户当前正在处理的任务的信息,并且您可以即时访问活动流、注释、任务、版本和发布。可播放您团队中的其他成员发送以进行审核的版本。可在您的应用程序中直接回复注释。如果您的工作流跟踪依存关系信息,您也可以直接从 Shotgun 面板浏览此信息。 |
![]() |
管理员手册这是 Shotgun 集成的管理员手册。 |
![]() |
用户手册这是 Shotgun 集成的用户手册。 |
安装和更新
将此应用添加到 Shotgun Pipeline Toolkit
如果您想将此应用添加到 Project XYZ 中名为 asset 的环境中,请执行以下命令:
> tank Project XYZ install_app asset tk-maya tk-multi-publish2
更新至最新版本
如果您已在某个项目中安装了此应用,要获取最新版本,可运行 update
命令。您可以导航到该特定项目随附的 tank 命令,并在该项目中运行它:
> cd /my_tank_configs/project_xyz > ./tank updates
或者,也可以运行您的工作室的 tank
命令并指定项目名称,指示该命令要对哪个项目运行更新检查:
> tank Project XYZ updates
协作和代码演进
![]() |
如果您可以获取 Shotgun Pipeline Toolkit,意味着也可以获取我们在 GitHub 中存储和管理的所有应用、插件和框架的源代码。欢迎根据实际需要演进和完善这些内容,以它们为基础做进一步的独立开发,修改它们(以及向我们提交 Pull 请求!),或者只是随手玩一玩,简单了解它们的构建方式和 Toolkit 的工作原理。您可以通过以下网址访问此代码库:https://github.com/shotgunsoftware/tk-multi-publish2。 |
特殊要求
- 需要安装 Shotgun Pipeline Toolkit 核心 API 版本 v0.18.153 或更高版本才能使用此功能。
配置
下面是使用的所有配置设置的摘要。您需要在要启用此应用或插件的环境文件中定义这些设置。
display_name
类型:str
默认值:Publish
说明:指定在菜单和主发布对话框中使用的名称。
validate_on_publish
类型:bool
默认值:True
说明:如果为 True(默认值),单击“发布”(Publish)按钮将先执行验证逻辑,然后再发布。如果为 False,将跳过验证。如果为 False,并且没有手动触发验证,在继续执行发布逻辑之前,将弹出一个确认对话框。注意:这是高级选项。如果将此项设置为“False”,很可能会打破附带的 Toolkit 集成,这些集成假设在发布之前始终会执行验证。
task_required
类型:bool
说明:如果为 True,则验证是否为每个项目选择了任务,并禁用/启用“验证”(Validate)和“发布”(Publish)按钮,最后更改任务标签的颜色。
publish_plugins
类型:list
默认值:[{u'hook': u'{self}/publish_file.py', u'name': u'Publish to Shotgun', u'settings': {}}, {u'hook': u'{self}/upload_version.py', u'name': u'Upload for review', u'settings': {}}]
说明:发布插件列表。
post_phase
类型:hook
默认值:{self}/post_phase.py
说明:此挂钩定义在每个发布执行阶段(包括验证、发布和完成)之后要执行的逻辑。这样,可以在发布会话期间对发布树进行非常具体的管理和自定义。例如,可以通过此挂钩在验证之后将发布树序列化至磁盘。
path_info
类型:hook
默认值:{self}/path_info.py
说明:此挂钩包含在发布期间用于通过文件路径推断信息的方法。它包括版本和帧编号标识、发布显示名称、图像序列路径等。
help_url
类型:str
说明:在发布器中单击帮助按钮时打开的 URL。此 URL 指向的页面通常应列出工作室的发布工作流。如果没有提供 URL,则帮助按钮不会显示。
display_action_name
类型:str
默认值:Publish
说明:简短版本的 display_name 设置,用作按钮名称。
collector
类型:hook
默认值:{self}/collector.py
说明:从场景和拖放的文件中提取项目时的逻辑。
collector_settings
类型:dict
说明:收集器特定的配置设置。
enable_manual_load
类型:bool
默认值:True
说明:如果为 True(默认值,正常操作),用户可以与主对话框进行交互以放置文件或文件夹。此外,用户还可以使用浏览按钮来选择文件或文件夹。如果为 False,此功能基本上会禁止用户将任何内容添加到项目中。