Nikon Remote SDK

Wie die App mit Nikon-Kameras kommuniziert

Die App verwendet die Nikon Remote SDKs, um eine Verbindung zu Nikon-Kameras herzustellen, Kameraeinstellungen zu ändern, die Live-Ansicht zu starten und Bilder aufzunehmen.

Es gibt zwei Remote SDK-Optionen:

  • Legacy Remote SDK: die ältere SDK-Familie zur Kamerasteuerung von Nikon.
  • Unified Z SDK v2: Nikons neuerer Remote SDK-Pfad für Z-Serie spiegellose Kameras.

Die meisten Benutzer müssen nicht über das SDK nachdenken, es sei denn, sie ändern die Body-Einstellung, testen einen neueren Z-Body oder beheben eine Kameraverbindung.

Welche sollte ich verwenden?

Verwenden Sie das Legacy Remote SDK, wenn:

  • Sie eine DSLR verwenden.
  • Ihr Z-Body bereits gut im Legacy-Modus funktioniert und Sie die umfassendste nachgewiesene Funktionalität benötigen.
  • Sie Probleme beheben und das Verhalten mit dem älteren Pfad vergleichen möchten.

Verwenden Sie Unified Z SDK v2, wenn:

  • Sie einen unterstützten Nikon Z-Serie Body verwenden und den neueren Z SDK-Pfad von Nikon wünschen.
  • Ihr Z-Body neuer ist als die Unterstützung des Legacy SDK in der App.
  • Der Support Sie auffordert, den v2-Pfad zu testen und Protokolle zu senden.

Das v2 SDK ist für Z-Serie Bodies. Es ist nicht der DSLR-Pfad.

Warum gibt es zwei Remote SDKs?

Viele Jahre lang lieferte Nikon separate Remote SDK-Module für einzelne Bodies oder kleine Body-Gruppen. Das ist der Legacy-Pfad. Er ist ausgereift, gut verstanden und bleibt der richtige Pfad für DSLR-Bodies.

Nikon liefert jetzt auch ein neueres, einheitliches Remote SDK für die Z-Serie. Anstelle eines kameraspezifischen Moduls pro Kamera verwendet es ein gemeinsames Z SDK-Payload und Nikons aktuelles Unterstützungsmodell für die Z-Serie. Das macht es zum wahrscheinlicheren langfristigen Pfad für neuere Z-Bodies und Firmware-Änderungen.

Abwägungen

Der Legacy-Modus ist der am besten bewährte Pfad für ältere unterstützte Bodies und DSLRs. Wenn eine Kamera dort gut funktioniert, kann es die einfachere Wahl sein.

Unified Z SDK v2 ist neuer. Es unterstützt die aktuelle SDK-Richtung der Z-Serie, aber einige Verhaltensweisen sind unterschiedlich, da Nikon geändert hat, wie das SDK die Aufnahme, die Live-Ansicht, den Kamerazustand und die gespeicherten Dateien meldet. Die App hält den normalen Workflow, wo möglich, gleich, aber v2 kann dennoch unterschiedliche unterstützte Einstellungen auf einem bestimmten Body offenbaren.

Die Laufzeitfähigkeiten der Kamera haben immer Vorrang. Wenn der verbundene Body nicht meldet, dass eine Einstellung verfügbar ist, kann die App sie nicht sicher aktivieren.

Aufnahme von Standbildern im Unified Z SDK v2

Wenn v2 Bilder auf den Computer speichert, schreibt Nikon zuerst die Originaldateien in einen Staging-Ordner. Die App prüft dann die Aufnahme und kopiert die Originals gemäß den normalen Pfadregeln an Ihr endgültiges Ziel.

Dies bewahrt das vertraute Verhalten des Pfades, einschließlich Dateinamen-Tokens, Zähler, Gruppenordner und doppelsichere endgültige Namen. Es bewahrt auch die von Nikon produzierten gestaffelten Originals zur Wiederherstellung. Die App löscht diese gestaffelten Originals nicht automatisch.

Die Aufnahme nur auf der Karte bleibt nur auf der Karte. In diesem Modus wartet die App, bis die Aufnahme auf der Kameraseite abgeschlossen ist, kopiert jedoch keine Dateien in den PC-Pfad.

Externe Auslöser

Der Legacy Remote SDK-Modus kann Aufnahmen empfangen, die außerhalb der App ausgelöst werden, z. B. durch Drücken des physischen Auslösers auf dem Kameragehäuse.

Die Übertragung von Standbildern im Unified Z SDK v2 ist anders. Im v2-Modus kann ControlMyNikon Standbilder nur übertragen, wenn die App die Aufnahme startet, da Nikon verlangt, dass die App den aufnahme-spezifischen Staging-Ordner vor Beginn der Aufnahme bereitstellt.

Wenn Sie den physischen Auslöser drücken, einen Fernauslöser verwenden oder einen anderen externen Auslöser verwenden, während der v2-Modus aktiv ist, kann die Kamera das Bild möglicherweise trotzdem aufnehmen, aber ControlMyNikon erhält möglicherweise nicht die SDK-Ereignisse, die benötigt werden, um es auf den Computer zu übertragen. Verwenden Sie die App Shoot- oder Burst-Steuerungen für die Übertragung auf der Computerseite im v2-Modus. Verwenden Sie den Legacy Remote SDK-Modus, wenn Sie die physische Body-Auslösung oder externe Auslöserfassung benötigen, um Bilder in ControlMyNikon zu übertragen.

Aufnahmesicherheit

Wenn die App erwartet, eine Aufnahme auf dem Computer zu speichern, wird dieses Speichern als Aufnahme-Transaktion behandelt. Die Transaktion wird nicht als erfolgreich angesehen, nur weil die Kamera ein Bild aufgenommen hat. Die App muss auch nachweisen, dass die endgültige Datei korrekt am Pfadziel gespeichert wurde.

Für die benutzerseitige Erklärung von Legacy-Nachweisen, v2-Staging-Audit, Guidance-Warnungen, optionaler Trennung, Workflow-Abbruch und Debug-Fehlertests siehe Aufnahme-Transaktionen.

Gestaffelte Originals

Der Staging-Ordner wird in den Pfadeinstellungen konfiguriert. Lassen Sie ihn auf einem lokalen Laufwerk mit ausreichend freiem Speicherplatz für die größte Sitzung, die Sie erwarten.

Da gestaffelte Originals aufbewahrt werden, reinigen Sie sie manuell, nachdem Sie die endgültigen Dateien bestätigt haben und die Wiederherstellungskopie nicht mehr benötigen.

Protokolle

Wenn Sie um Hilfe bitten, fügen Sie das Protokoll bei. Das Protokoll zeichnet auf, ob die Sitzung im Legacy-Modus oder im Unified Z SDK v2-Modus verwendet wurde, den verbundenen Body, die gemeldeten Fähigkeiten und die Details zur Aufnahmeprüfung.