捕获交易

请放心：当应用程序负责将捕获保存到您的计算机时，它会将保存视为捕获交易。仅仅因为快门已触发或电影录制已停止，交易并不被视为完成。应用程序还必须证明预期的计算机端文件已正确到达其最终路径目的地。

这在高容量或关键会话中尤为重要，例如学校肖像、产品批次、证据工作、医疗文档、复制架和其他拍摄，其中错过保存可能会影响后续的许多决策。

交易保护的内容

捕获交易保护计算机端的保存。

如果您的保存模式期望计算机上的图像或电影文件，应用程序会监控SDK传输、最终路径保存和最终文件证明，然后才将捕获视为成功。如果捕获仅限于卡，应用程序不期望该捕获的最终计算机路径文件。

目标很简单：避免危险的情况，即相机拍摄了一张照片，但您期望在计算机上的文件缺失、不完整或不在工作流程期望的位置。

遗留远程SDK捕获

在遗留远程SDK模式下，应用程序从Nikon SDK接收媒体数据，并通过最终路径管道保存它。

对于计算机端的静态图像或电影保存，交易检查：

• SDK交付了预期的媒体数据。
• 选择了最终路径位置。
• 应用程序将数据写入临时预发布.ttctmp文件。
• 临时文件被重命名为最终图像或电影扩展名。
• 最终文件存在。
• 最终文件大小与SDK接收的数据匹配。
• 当该设置启用时，应用了只读文件属性。

该.ttctmp文件是临时预发布文件。它防止文件夹监视器、杀毒扫描程序、脚本和图像浏览器对部分写入的最终文件做出反应。最终重命名的文件是对捕获交易重要的证明。

统一Z SDK v2捕获

在统一Z SDK v2模式下，Nikon首先将计算机端的静态图像写入特定于捕获的暂存文件夹。然后，应用程序审核暂存的原件，并通过正常路径规则将其复制到您的最终目的地。

对于计算机端的静态图像保存，交易检查：

• 创建了特定于捕获的GUID暂存文件夹。
• Nikon的StartShooting请求成功。
• 拍摄状态达到终止状态。
• 在预期的暂存文件夹中找到了暂存文件。
• 暂存文件大小在最终复制之前稳定。
• 应用程序将每个暂存的原件复制到临时最终路径文件。
• 临时文件被重命名为最终扩展名。
• 最终文件存在并与暂存原件的大小匹配。
• 捕获清单记录审核结果。

暂存的原件保留用于恢复和支持。应用程序在最终路径复制后不会自动删除Nikon生成的暂存原件。

如果证明失败会发生什么

如果应用程序无法证明所需的计算机端捕获已正确保存，则将其视为关键捕获保存失败。

发生这种情况时：

• 应用程序顶部会出现指导错误警报。
• 日志记录SDK模式、主体、保存模式、失败阶段、相关路径和字节计数（如果可用）。
• 待处理的捕获工作流命令被取消，以便序列不会继续在同一失败中拍摄。
• 正常的准备或进度消息不应隐藏失败警报。
• 如果启用，应用程序在警报提升后断开主体连接。

首先阅读指导警报。然后，如果您需要详细的诊断信息，请打开日志。

在关键捕获保存错误后断开连接

设置  机身  交易包括在关键捕获保存错误后断开连接。

当继续进行失败的保存比停止会话更糟糕时启用此选项。对于关键生产工作，断开连接通常是更安全的选择，因为它使问题显而易见，并防止更多捕获进入同一失败保存路径。

如果您希望相机在您阅读警报并决定下一步操作时保持连接，请将其禁用。即使设置关闭，应用程序仍会提升指导错误警报并记录日志详细信息。

测试失败路径

设置  机身  交易还包括特定于SDK的调试捕获测试标志。这些标志故意强制捕获交易失败，以便您可以确认在依赖生产中的工作流程之前，警报、日志、工作流取消和可选断开连接行为是可见的。

仅在测试会话期间使用这些。正常拍摄时请将其禁用。

遗留调试捕获测试标志：

• 强制遗留SDK捕获错误
• 强制遗留传输错误
• 强制最终路径保存失败
• 强制最终路径大小不匹配

v2调试捕获测试标志：

• 强制v2 SDK捕获错误
• 强制v2暂存审核失败
• 强制最终路径保存失败
• 强制最终路径大小不匹配
• 强制意外的SDK保存路径

在强制失败后，确认您看到了指导错误警报，日志中包含DEBUG TEST条目，并且如果启用了关键捕获保存错误后断开连接，则主体已断开连接。然后在继续正常捕获工作之前禁用测试标志。

发送支持的内容

如果您在捕获交易失败后联系支持，请包括：

• 指导警报标题和消息。
• 日志文件。
• 活动的Nikon SDK模式。
• 连接的机身型号。
• 捕获保存模式。
• 您期望的最终路径文件夹。
• 使用统一Z SDK v2时的v2暂存文件夹或捕获清单。

这些证据通常使失败可重构，而无需猜测。