镜头数据模块和数据结构

Shotgun 7.0 建立了一个官方数据模块来跟踪剪辑信息，用以捕获镜头数据的历史快照。

将该信息保存在 Shotgun 中后，便可开启许多功能，包括跟踪镜头历史记录，支持镜头复用（例如在商业广告中使用 30/60/90 秒镜头），以及在含有非 VFX 镜头的时间线环境中观看任何媒体片段。

除了支持 Shotgun 的浏览器和 RV 审核工具之外，镜头数据模块还为工作室提供了将其内部剪辑工具集成到 Shotgun 中的功能。

镜头数据模块的核心是“镜头”(Cut)和“镜头项”(Cut Item)实体。在镜头级别，我们跟踪镜头的全局信息，如修订号、FPS、EDL 文件和可选的基础层电影版本。

默认情况下，镜头可与镜头序列和场景相关联，但可以针对 Shotgun 中几乎所有实体进行自定义，以此来支持各种剪辑工作流，例如剧集、商业广告、宣传片等。

镜头项可连接到镜头，并构成 EDL 的实际项目。可将其视为基于 Shotgun 的 EDL 视图。在此级别，我们跟踪镜头顺序、采用帧和时间码格式的个别视频片段输入/输出点，以及可选的镜头和版本链接等信息。

镜头字段详细信息

镜头项字段详细信息

下面根据实际用例和客户反馈介绍了 Shotgun 用于跟踪镜头信息的标准字段。发布这些标准是为了帮助确保所有 Shotgun 客户以一致的方式使用工具和与第三方应用程序的集成。

注意：只有静态图像或影片文件才受官方支持。

镜头字段

字段名称	（字段类型）	internal_field_name	说明和用法	示例
镜头入点(Cut In)	（数字）	sg_cut_in	镜头中使用的第一帧。此输入来自剪辑，用于播放影片和帧。	15
镜头出点(Cut Out)	（数字）	sg_cut_out	镜头中使用的最后一帧。此输入来自剪辑，用于播放影片和帧。	125
镜头时长(Cut Duration)	（数字）	sg_cut_duration	时间线中此镜头的时长。	111
镜头顺序(Cut Order)	（数字）	sg_cut_order	镜头在整个项目的整个时间线中的播放顺序。用于在按镜头顺序播放时对镜头和镜头版本进行排序，并使版本的相邻镜头进入当前正在查看的镜头。	210000007
剪辑序列开头入点(Head In)	（数字）	sg_head_in	连续镜头可用于此镜头的第一帧编号。	11
剪辑序列结尾出点(Tail Out)	（数字）	sg_tail_out	连续镜头可用于此镜头的最后一帧编号。	130
剪辑序列时长(Working Duration)	（数字）	sg_working_duration	此镜头中从“剪辑序列开头入点”(Head In)到“剪辑序列结尾出点”(Tail Out)的可用帧的完整时长。	120

版本字段

字段名称	（字段类型）	internal_field _name	说明和用法	示例
已上传影片(Uploaded Movie)	（文件/链接）	sg_uploaded_movie	用于包含已上传影片文件的文件字段。用于播放 Shotgun 中存储的较低分辨率影片媒体。
影片路径(Path to Movie)	（文本）	sg_path_to_movie	影片在本地文件系统上的位置（未上传）。用于播放本地存储的较低分辨率影片媒体。	/path/to/movie.mov
影片宽高比(Movie Aspect Ratio)	（浮点数）	sg_movie_aspect_ratio	影片的宽高比。用于对图像正确设置格式以供查看。	1
影片有场记板信息(Movie Has Slate)	（复选框）	sg_movie_has_slate	指示影片文件是否有场记板信息。此项用于在播放中包含或忽略场记板信息。	[✔]
帧路径(Path to Frames)	（文本）	sg_path_to_frames	高分辨率帧在本地文件系统上的位置。用于播放高分辨率帧。	/rvshotgundemo/BBB_Short/08_a-team/012/ANIM/001/BBB_08_a-team_012_ANIM_001.#.jpg
第一帧(First Frame)	（数字）	sg_first_frame	版本中包含的第一帧编号。用于播放影片或帧以计算版本中可用的第一帧。	11
最后一帧(Last Frame)	（数字）	sg_last_frame	版本中包含的最后一帧编号。用于播放影片或帧以计算版本中可用的最后一帧。	130
帧宽高比(Frames Aspect Ratio)	（浮点数）	sg_frames_aspect_ratio	高分辨率帧的宽高比。用于对图像正确设置格式以供查看。	1
帧有场记板信息(Frames Have Slate)	（复选框）	sg_frames_have_slate	指示帧是否有场记板信息。此项用于在播放中包含或忽略场记板信息。	[ ]
部门(Department)	（文本或列表）	sg_department	提交版本的部门。此项用于查找来自同一部门的最新版本。	ANM

对镜头字段有问题吗？

镜头级别时间线字段（如“剪辑序列开头入点”(Head In)、“剪辑序列结尾出点”(Tail Out)）独立于“镜头”(Cut)和“镜头项”(Cut Item)值。

这有两个主要原因。第一个原因是剪辑数据跟踪的迭代特性。例如，您可能想要将正在使用的临时镜头输入到 Shotgun 中，但不希望在镜头正式发布之前更新镜头级别值。第二个原因是，控制柄帧的数量会因您的流程和部门需求而有所不同。此类型的信息通常不会因镜头而波动，应单独进行跟踪。

为便于使用，可以选择“Update Cut Fields on Shots”选项，以便 RV 导入镜头应用能够在导入时自动处理镜头级别字段的更新。如果您正在执行自己的集成，则需记住镜头级别的字段。

我们已经在 Shotgun 中跟踪镜头数据，能否将该数据用于新的审核工具集？

可以，但此过程不会自动完成。

为避免在发布转出时出现任何问题，我们构建了镜头数据模块，但对“镜头”(Cut)、“镜头项”(Cut Item)和“CutVersionConnection”实体进行了一些更改。为了降低发布转出时的风险，我们已将数据结构迁移与数据迁移分离开来。数据迁移将由我们的支持团队通过发布后流程进行处理。

如果您想要将旧时间线数据用于 7.0 镜头数据模块，我们的支持团队可以提供帮助。只需向他们提交请求即可。

数据结构和数据迁移详细信息

如果您想了解具体详细信息，请继续阅读！

如果站点从未使用“镜头”(Cut)、“镜头项”(Cut Item)或“CutVersionConnection”实体，则将您的站点升级到 Shotgun v7.0 时，数据结构迁移过程只是从您的站点数据结构中移除这些未使用的字段，您现在可以使用这些新字段，无需专门进行数据迁移。

如果在 7.0 数据结构迁移升级期间我们的系统发现您的数据库中使用了上述三个实体，则迁移过程不会从当前数据结构中移除相应实体的任何字段或数据，而是已将这些字段更改为用户字段，现在将其视为用户自己添加的字段。 

例如，如果系统检测到您在站点数据库中使用“镜头”(Cut)实体，但未使用“镜头项”(Cut Item)或“CutVersionConnection”实体，“镜头”(Cut)实体的“镜头序列”(Sequence) (sg_sequence) 字段将不会删除，而是被归类为用户字段，您可以随意将其删除。由于未检测到“镜头项”(CutItem)和“CutVersionConnection”，系统会自动将其移除。

此方法可确保在升级到 Shotgun 7.0 期间不会丢失数据。

迁移到 Shotgun 7.0 之后，验证您当前站点数据库中是否存在“镜头”(Cut)、“镜头项”(CutItem)和/或“CutVersionConnection”实体。（在您升级到 7.0 版本之前，Shotgun 团队也会执行此项操作，如果我们检测到您的站点中使用了这些实体，可能会与您联系。） 

如果您当前的站点数据结构另外还包含其他动态字段，请确保它们不会与新数据结构中最近添加的字段重叠。

如果您发现这三个字段中的任何一个或全部正在使用中，请选择以下数据迁移选项之一：

选项 1：将现有数据保留在原位置

如果由于内部原因您确实无法选择任何其他选项，这是一个很好的短期选择。

优点：

如果您的脚本或 Shotgun 页面使用旧字段，这些脚本或页面仍将有效，而无需进行任何更改。

缺点：

您的站点数据结构中将遗留包含 Shotgun 不再使用的数据的旧实体字段。例如，创建镜头时，用户可以选择填充“镜头序列”(Sequence)和“链接”(Link)字段，但不知道“镜头序列”(Sequence)字段已不再使用。另外，新的镜头导入工具会自动填充镜头的“链接”(Link)字段，但不会填充镜头的“镜头序列”(Sequence)字段。因此，如果您的脚本目前依赖于所设置的“镜头序列”(Sequence)字段，则在使用镜头导入工具时这些脚本将找不到数据。

如何继续操作：

对于此选项，由于现有数据可以保存在旧字段中，而新数据保存在新字段中，因此无需执行任何操作。我们建议将此选项作为一个短期解决方案，并鼓励客户以后尽量实施下面的选项 2 或选项 3。

选项 2：删除现有数据

如果您发现某个已移除实体用于测试目的或者该实体与不再需要的旧项目相关联，可以选择将现有数据从您的站点中完全删除。

优点：

过程简单。

缺点：

导致数据丢失。

如何继续操作：

请联系我们的支持团队来了解可从您的站点中安全删除的实体字段列表。之后，我们将安排时间来移除您站点数据结构中的旧实体字段。完成后，与这些特定字段关联的数据将从您的站点中移除，但其他实体字段的值将保留在数据库中。

选项 3：将现有数据迁移到新实体和字段

此选项最能确保您的站点数据结构不会处于同时具有新旧实体字段的过渡状态。

优点：

这种方式最能确保您的站点数据结构不会处于同时具有新旧实体字段的过渡状态，从而避免发生客户端混乱以及未来出现错误。

缺点：

根据您对现有字段的使用情况，迁移可能需要对脚本和内部工具进行更改。

如何继续操作：

如果您想要将现有数据迁移到新字段，请告知我们的支持团队。之后，我们将调度一个自动化任务来迁移数据并移除站点数据结构中的旧字段。完成迁移后，我们会通知您。

您也可以自行执行迁移。如果您有任何问题，我们的支持团队随时愿意为您提供帮助。不要忘记更新内部脚本和工具，以移除对旧字段的支持。

如果您选择自行执行数据迁移，以下迁移详细信息将会有所帮助：

“镜头”(Cut)实体：

源镜头	目标镜头	注释
镜头序列(Sequence) [sg_sequence]	实体(Entity) [link]	此新字段是对现有字段的扩展（可用于链接到非“镜头序列”(Sequence)实体类型）。

“镜头项”(Cut Item)实体：

源镜头项	目标镜头项	注释
类型(Type) [sg_cutitem_type]	不适用	由于新数据模块没有任何与此相应的字段，该字段将保留为“用户”字段，您可以随时将其删除。
镜头(Cut) [sg_cut]	镜头(Cut) [cut]	此字段的名称在 UI 中不会发生更改，但在内部将针对脚本而更改。

“CutVersionConnection”实体：

系统将为每个“CutVersionConnection”实体创建一个“镜头项”(Cut Item)。

源 CutVersionConnection	目标镜头项
缓存的显示名称(Cached Display Name) [cached_display_name]	- 缓存的显示名称(Cached Display Name)  [cached_display_name] - 镜头项名称(Cut Item Name) [code]
镜头备注(Cut Comments) [sg_cut_comments]	说明(Description) [description]
镜头时长(Cut Duration) [sg_cut_duration]	镜头项时长(Cut Item Duration) [cut_item_duration]
镜头入点(Cut In) [sg_cut_in]	镜头项入点(Cut Item In) [cut_item_in]
镜头出点(Cut Out) [sg_cut_out]	镜头项出点(Cut Item Out) [cut_item_out]
镜头顺序(Cut Order) [sg_cut_order]	镜头顺序(Cut Order) [cut_order]