![]() |
Shotgun Maya 插件在 Maya 中集成 Shotgun |

Shotgun Maya 插件在 Shotgun Pipeline Toolkit 应用与 Maya 之间建立桥接。它还包含 PySide 分发,该分发专门用于在 Maya 中连接到 QT,因此,可以使用 Python 和 PySide 编写在插件内部运行的应用。
支持的应用程序版本
此插件已经过测试,已知可支持以下应用程序版本:2014 - 2020。请注意,此插件也许(甚至非常有可能)支持更新的发行版本,但是尚未正式在这些版本中进行测试。
概述视频
下面的视频对特性和功能进行了简要的介绍。
文档
Shotgun Maya 插件包含一个用于在 Maya 中集成 Shotgun 应用的标准平台。它采用轻量型设计,操作简单直观,并会向 Maya 菜单中添加一个 Shotgun 菜单。

应用开发人员须知
PySide
Shotgun Maya 插件包含一个 PySide 安装,必要时会激活此安装。
Maya 项目管理
Shotgun Maya 插件在每次启动时,都会设置 Maya 项目指向此插件的设置中定义的一个位置。这意味着,当您打开新文件时,项目也可能会发生变化。我们可以使用模板系统,在配置文件中配置有关基于文件设置 Maya 项目的详细信息。
安装和更新
将此插件添加到 Shotgun Pipeline Toolkit
如果您想将此插件添加到 Project XYZ 中名为 asset 的环境中,请执行以下命令:
> tank Project XYZ install_engine asset tk-maya
更新至最新版本
如果您已在某个项目中安装了此应用,要获取最新版本,可运行 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-maya。 |
特殊要求
- 需要安装 Shotgun Pipeline Toolkit 核心 API 版本 v0.19.18 或更高版本才能使用此功能。
配置
下面是所有配置设置参数。您需要在要启用此应用或插件的环境文件中定义这些设置。
run_at_startup
类型:list
说明:控制哪些应用将在启动时运行。这是一个列表,其中每个列表项都是一个具有“app_instance”和“name”键的词典。“app_instance”值将此条目连接至环境配置文件中定义的一个特定应用实例。“name”是 Maya 插件启动时要运行的命令的菜单名称。如果“name”值为 '',则会启动给定应用实例的所有命令。
template_project
类型:template
说明:用来确定 Maya 项目位置设置的模板。这应该是一个字符串,指定要使用的模板,但是如果您不希望自动设置 Maya 项目,也可以将此设置留空。
use_sgtk_as_menu_name
类型:bool
说明:(可选)选择此项将使用“Sgtk”(而非“Shotgun”)作为菜单主名称。
launch_builtin_plugins
类型:list
说明:启动 Maya 时要加载的 tk-maya 插件的逗号分隔列表。使用此功能将禁用启动 Maya 时引导 Toolkit 的典型机制。
menu_favourites
类型:list
说明:控制主菜单上的收藏夹部分。这是一个列表,每个菜单项是一个具有“app_instance”和“name”键的词典。“app_instance”参数将此条目连接至环境配置文件中定义的一个特定应用实例。“name”是用来创建收藏项的菜单名称。
compatibility_dialog_min_version
类型:int
默认值: 2015
说明:指定将会使尚未得到 Toolkit 完全支持并经过测试的应用程序弹出警告提示的最小主版本。要禁止所测试的版本弹出警告对话框,建议您将此值设置为当前主版本号 + 1。
debug_logging
类型:bool
说明:控制是否将调试消息发送至日志记录程序。
automatic_context_switch
类型:bool
默认值: True
说明:控制 Toolkit 是否应尝试在当前加载的文件每次发生变化时都自动调整其上下文。默认值为 True。