尼康远程SDK

该应用程序使用尼康远程SDK连接到尼康相机，改变相机设置，启动实时视图，并捕捉图像。

有两个远程SDK选项：

• 遗留远程SDK：较旧的尼康相机控制SDK系列。
• 统一Z SDK v2：尼康为Z系列无反相机提供的新远程SDK路径。

大多数用户不需要考虑SDK，除非他们正在更改机身设置，测试较新的Z机身，或排查相机连接问题。

我应该使用哪个？

当您使用遗留远程SDK时：

• 您正在使用单反相机。
• 您的Z机身在遗留模式下已经运行良好，并且您需要最广泛的经过验证的功能覆盖。
• 您正在排查问题，并希望与旧路径的行为进行比较。

当您使用统一Z SDK v2时：

• 您正在使用受支持的尼康Z系列机身，并希望使用尼康的新Z SDK路径。
• 您的Z机身比应用程序中遗留SDK的支持更新。
• 支持团队要求您测试v2路径并发送日志。

v2 SDK适用于Z系列机身。它不是单反相机路径。

为什么有两个远程SDK？

多年来，尼康为单个机身或小机身组提供了单独的远程SDK模块。这是遗留路径。它成熟，易于理解，并且仍然是单反相机的正确路径。

尼康现在还提供了更新的统一Z系列远程SDK。它不再为每台相机提供一个特定机身的模块，而是使用通用的Z SDK负载和尼康当前的Z系列支持模型。这使其成为新Z机身和固件更改的更可能的长期路径。

权衡

遗留模式是针对较旧受支持机身和单反相机的最可靠路径。如果相机在此模式下运行良好，它可能是更简单的选择。

统一Z SDK v2是较新的。它支持当前的Z系列SDK方向，但由于尼康改变了SDK报告捕捉、实时视图、相机状态和保存文件的方式，因此某些行为有所不同。应用程序在可能的情况下保持正常工作流程不变，但v2可能仍会在特定机身上暴露不同的支持设置。

运行时相机能力始终优先。如果连接的机身未报告某个设置可用，应用程序无法安全地强制启用该设置。

在统一Z SDK v2中捕捉静态图像

当v2将图像保存到计算机时，尼康首先将原始文件写入暂存文件夹。然后，应用程序审核捕捉并通过正常路径规则将原始文件复制到您的最终目的地。

这保持了熟悉的路径行为，包括文件名令牌、计数器、组文件夹和防重复的最终名称。它还保留了尼康生成的暂存原件以供恢复。应用程序不会自动删除这些暂存原件。

仅卡片捕捉保持为仅卡片。在该模式下，应用程序等待相机端的捕捉完成，但不会将文件复制到PC路径。

捕捉安全性

当应用程序预计将捕捉保存到计算机时，该保存被视为捕捉事务。仅仅因为相机拍摄了一张照片，事务并不被视为成功。应用程序还必须证明最终文件在路径目标处正确保存。

有关用户界面的遗留证明、v2暂存审核、指导警报、可选断开连接、工作流程取消和调试失败测试的说明，请参见 捕捉事务。

暂存原件

暂存文件夹在路径设置中配置。将其保留在本地驱动器上，并确保有足够的可用空间以容纳您预期的最大会话。

由于暂存原件被保留，请在确认最终文件并不再需要恢复副本后手动清理它们。

日志

在请求帮助时，请包含日志。日志记录了会话是否使用了遗留模式或统一Z SDK v2模式、连接的机身、报告的能力和捕捉审核细节。