Shotgun 和 RV 配置手册

步骤 1. 启用 Shotgun 和 RV 软件包

Shotgun 软件包包含在 RV 安装中。启用后，这会使“Shotgun 可识别”RV，并在 RV 中提供相应功能以直接与 Shotgun 交互。如果您具有先前版本的 RV，我们建议您下载更新的版本。

要启用 Shotgun 软件包，请执行以下操作：

启动 RV
选择“RV > Preferences”菜单
选择“Packages”选项卡
选中“Shotgun 集成”(Shotgun Integration)软件包旁边的“Installed”和“Load”复选框
关闭“Preferences”窗口并重新启动 RV

现在在菜单栏中应该会看到一个 Shotgun 菜单。

RV Preferences

注意：此时 RV 已启用 Shotgun 软件包，但其尚未配置为可知晓要连接到哪一台 Shotgun 服务器。因此，当 RV 启动时，您可能会看到“No config module found”这样的警告。您可以在下一步中配置 Shotgun。

步骤 2. 准备 Shotgun 站点进行 RV 集成

RV 集成所需的最少 Shotgun 字段

审片室用户注意事项：审片室激活后将创建这些字段，因此如果要跳过手动设置，只需在“应用 > 管理应用”(Apps > Manage Apps)菜单中启用审片室。

请参见用于跟踪镜头信息的标准字段，以确保为这些字段配置正确的字段类型。以下括号中的值为不存在数据时 RV 假定的默认值或行为。

镜头字段

镜头入点(Cut In) (1)：用于修剪播放以匹配当前镜头。
镜头出点(Cut Out) (100)：用于修剪播放以匹配当前镜头。
镜头顺序(Cut Order)（无）：用于在查看版本时“限定版本和相邻版本”。如果没有跟踪镜头顺序，此特定菜单项将不起作用。

版本字段

影片路径(Path To Movie)（媒体不存在时将显示默认颜色栏）：需要提供以作为要加载进行播放的默认媒体。
影片宽高比(Movie Aspect Ratio) (1.0)
影片有场记板信息(Movie Has Slate)（否(No)）：如果为“是”(Yes)，则您可以在播放期间切换查看和隐藏场记板信息。
帧路径(Path To Frames)（媒体不存在时将显示默认颜色栏）：允许您换入高分辨率帧而不是低分辨率影片。
帧宽高比(Frames Aspect Ratio) (1.0)
帧有场记板信息(Frames Have Slate)（否(No)）：如果为“是”(Yes)，则您可以在播放期间切换查看和隐藏场记板信息。
第一帧(First Frame) (Shot.Cut In)：在播放完整长度的版本时查找版本中第一个可用的帧。
最后一帧(Last Frame) (Shot.Cut Out)：在播放完整长度的版本时查找版本中最后一个可用的帧。
部门(Department)（无）：在 Shotgun 信息控件中显示，以表明版本源自的部门。

在 Shotgun 中启用 RV 菜单项

以管理员身份登录到 Shotgun 服务器。
转到“站点偏好设置”(Site Preferences)页面，然后找到并展开“Advanced Preferences”部分。
选中“启用 RV 集成”(Enable RV Integration)旁边的复选框。
通过单击“保存更改”(Save Changes)按钮保存首选项。

步骤 3. 允许 RV 对 Shotgun 站点进行身份认证

转到“管理 > 脚本”(Admin > Scripts)页面。

如果没有名为“rv”的脚本，必须创建一个（目前名称必须为“rv”）。

复制“rv”脚本的应用程序密钥。密钥应如下所示：

e1d958a09fa0c134d678cb0b6176cbb03ccec193

注意：脚本密钥为随机生成，因此您的密钥将不同于上述示例。

步骤 4. 下载并安装配置文件

下载文件 shotgun_fields_config_custom.mu，然后按照以下方式进行修改：

在文本编辑器中打开该文件并向顶部的 // ADD YOUR SERVER INFO HERE 下方添加站点 URL 和脚本密钥。
将 shotgun_fields_config_custom.mu 放置在 RV 可以找到的地方。默认情况下，RV 将在这些位置进行查找：

Linux
~/.rv/Mu
RV_HOME/plugins/Mu

Windows
~\Application Support\RV\Mu # windows xp
~\AppData\Roaming\RV\Mu # windows 7
RV_HOME\plugins\Mu

Mac
~/Library/Application Support/RV/Mu
RV_HOME/PlugIns/Mu

注意：RV_HOME 是 RV 应用程序的安装路径。

步骤 5. 启动 RV 并连接到 Shotgun 站点

启动 RV。
单击菜单“Shotgun > Preferences > Set Shotgun Config Style”。
键入“custom”。或者也可以键入一个空格以清除当前设置（如果有）。默认情况下，RV 将查找名为“custom”的配置样式。

将配置样式设置为“custom”之后，退出并重新启动 RV。
确保要在 RV 中播放的媒体位于本地或网络驱动器上。
登录到您的 Shotgun 站点。
转到某个版本页面。
选择一个或多个版本。
单击“在 RV 中播放”(Play in RV)。

应该看到本地或网络媒体在 RV 窗口中播放。自定义配置完成！

更新 RV-Shotgun 集成软件包

例如，您可以使用标记功能。首先，向版本实体添加“已标记”(Flagged)字段。然后，确保 RV-Shotgun 集成软件包可以识别该“已标记”(Flagged)字段。

使用文本编辑器打开您的 shotgun_fields_config_*.mu 文件。

找到如下所示的部分：

 /* -----------------------------------------*/
 // ADDITIONAL FIELDS
 /* -----------------------------------------*/
 // name                 prettyName              fieldName               fieldType       entityType      compute
 ("name",                "Name",                 "code",                 "text",         "Version",      false),
 ("description",         "Description",          "description",          "text",         "Version",      false),
 ("created",             "Created",              "created_at",           "date_time",    "Version",      false),
 ("status",              "Status",               "sg_status_list",       "status_list",  "Version",      false),
 ("shotStatus",          "Shot Status",          "sg_status_list",       "status_list",  "Shot",         false),
 ("assetStatus",         "Asset Status",         "sg_status_list",       "status_list",  "Asset",        false),
 ("department",          "Department",           "sg_department",        "text",         "Version",      false),
 ("flagged",             "Flagged",              "flagged",              "checkbox",     "Version",      false)
 };

上面的粗体行是为了正常使用标记功能需要添加的内容。请务必在前一行添加逗号。

保存此文件，操作完成！

开发人员信息

Shotgun 软件包的代码是开源的，可在 GitHub 的以下位置找到：https://github.com/shotgunsoftware/rv-integration-package。如果您进行了修改并认为其他用户也应做此修改，请提交有关您的更改的 Pull 请求，Shotgun 开发人员将联系您并尝试实现这一操作。

疑难解答

如果您已按照本手册操作，但 RV 仍无法与 Shotgun 站点通信，请检查此问题快速列表。

1. RV 和 Shotgun 软件包版本是否正确？

您应该安装 RV 3.10.6 或更高版本，以及 Shotgun 软件包 1.32 或更高版本。要查看版本是否正确，请启动 RV，转到“Preferences”，单击“Packages”，然后选择“Shotgun 集成”(Shotgun Integration)软件包。注释应包含相关的版本号。

RV 软件包

如果您没有 RV 3.10.6 或更高版本，可以从此处下载：http://www.tweaksoftware.com/downloads。

Shotgun 软件包

此软件包让您可以通过 RV 访问所有 Shotgun 菜单项。要检查是否具有此软件包，请启动 RV，转到“Preferences”，然后单击“Packages”。如果没有，请按照以下步骤获取该软件包：

下载 Shotgun 软件包。
启动 RV。
转到“RV > Preferences”，然后单击“Packages”选项卡。
如果已安装任何 Shotgun 软件包，请取消选中每个软件包对应的“Installed”和“Load”复选框，然后将它们全部删除。
单击“Add Packages...”。
通过文件浏览器导航到您下载的 rvpkg 文件，选择该文件，然后单击“打开”(Open)。
显示“Choose Package Installation”提示时，保留 RV 选择的位置。
单击“确定”(OK)，等待软件包显示在“Packages”窗口中。
确保“Installed”和“Load”复选框处于选中状态。
关闭 RV 首选项。
退出并重新启动 RV。

您现在应该看到一个 Shotgun 菜单。

2. RV Shotgun 配置样式是否设置正确？

RV 处于打开状态时，转到“Shotgun > Preferences > Set Shotgun Config Style”。它应设置为“custom”。如果不是，请在输入中键入 custom，然后点击。退出并重新启动 RV。

3. 您是否有权访问想要播放的媒体？

如果您每次尝试从 Shotgun 使用 RV 菜单项时仅看到颜色栏，可能是因为您无权访问这些文件。RV 将尝试通过一种与文件路径在 Shotgun 中的存储方式一致的方式来解析文件路径（即，影片路径(Path to Movie) = /BBB_Short/09_tree_trunk/011/ANIM/002/BBB_09_tree_trunk_011_ANIM_002.mov）。

4. 您是否正确设置了 RV 要求的每个 Shotgun 字段？

RV 需要已在 Shotgun 中创建某些字段，并需要其中每个字段具有特定名称和数据类型。为确保字段符合此规范，请参考此页面上的详细介绍部分。

5. 从 Shotgun 启动 RV 时是否看到“Connection refused”错误？

检查 shotgun_fields_config.mu 文件内容，确认站点 URL 前面带有 https:// 而非 http://。

目录