尼康远程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路径。

外部触发器

遗留远程SDK模式可以接收在应用程序外部触发的捕捉，例如按下相机机身上的物理快门按钮。

统一Z SDK v2的静态图像传输是不同的。在v2模式下，ControlMyNikon只能在应用程序启动捕捉时传输静态图像，因为尼康要求应用程序在拍摄开始之前提供特定于捕捉的暂存文件夹。

如果您在v2模式激活时按下物理快门按钮，使用遥控释放或使用其他外部触发器，相机可能仍会捕捉图像，但ControlMyNikon可能无法接收将其传输到计算机所需的SDK事件。使用应用程序的拍摄或连拍控制进行v2计算机端传输。当您需要物理机身快门或外部触发捕捉以将图像传输到ControlMyNikon时，请使用遗留远程SDK模式。

捕捉安全性

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

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

暂存原件

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

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

日志

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