订购 Shotgun 固定期限的使用许可后可以免费获取 RV。要开始使用,请从 Shotgun 站点的“应用”(Apps)菜单下载 RV。
本手册假定您已经获得某个 Shotgun 站点的管理员权限,已安装 RV 3.10.6 或更高版本,以标准形式存储关于版本和镜头的时间线信息,并具备足够的技术知识来编辑和保存配置文件。
步骤 1. 启用 Shotgun 和 RV 软件包
Shotgun 软件包包含在 RV 安装中。启用后,这会使“Shotgun 可识别”RV,并在 RV 中提供相应功能以直接与 Shotgun 交互。如果您具有先前版本的 RV,我们建议您下载更新的版本。
要启用 Shotgun 软件包,请执行以下操作:
- 启动 RV
- 选择“RV > Preferences”菜单
- 选择“Packages”选项卡
- 选中“Shotgun 集成”(Shotgun Integration)软件包旁边的“Installed”和“Load”复选框
- 关闭“Preferences”窗口并重新启动 RV
现在在菜单栏中应该会看到一个 Shotgun 菜单。
注意:此时 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://。
0 评论