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 spiegellose Z-Serie-Kameras.

Die meisten Benutzer müssen sich nicht mit dem SDK beschäftigen, es sei denn, sie ändern die Body-Einstellung, testen ein neueres Z-Modell oder beheben eine Kameraverbindung.

Welche sollte ich verwenden?

Verwenden Sie das Legacy Remote SDK, wenn:

  • Sie eine DSLR verwenden.
  • Ihr Z-Modell 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 ein unterstütztes Nikon Z-Serie-Modell verwenden und den neueren Z SDK-Pfad von Nikon wünschen.
  • Ihr Z-Modell 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-Modelle. Es ist nicht der DSLR-Pfad.

Warum gibt es zwei Remote SDKs?

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

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 wahrscheinlicher, dass es der langfristige Weg für neuere Z-Modelle und Firmware-Änderungen ist.

Abwägungen

Der Legacy-Modus ist der am besten bewährte Weg für ältere unterstützte Modelle 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 Modell anzeigen.

Die Laufzeitfähigkeiten der Kamera haben immer Vorrang. Wenn das verbundene Modell 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 Ihren endgültigen Zielort.

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 Karte bleibt nur auf Karte. In diesem Modus wartet die App, bis die Aufnahme auf der Kameraseite abgeschlossen ist, kopiert jedoch keine Dateien in den PC-Pfad.

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 Zielort 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 beibehalten 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, das verbundene Modell, die gemeldeten Fähigkeiten und die Details zur Aufnahmeprüfung.