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 Familie von Nikon-Kamera-Steuerungs-SDKs.
  • Unified Z SDK v2: Nikons neuerer Remote SDK-Pfad für spiegellose Z-Serie-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 Kamera-Verbindung.

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 Legacy SDK-Unterstützung in der App.
  • Der Support Sie auffordert, den v2-Pfad zu testen und Protokolle zu senden.

Das v2 SDK ist für Z-Serie-Body. 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 Gruppen von Bodies. Das ist der Legacy-Pfad. Er ist ausgereift, gut verstanden und bleibt der richtige Weg für DSLR-Bodies.

Nikon liefert jetzt auch ein neueres einheitliches Remote SDK für die Z-Serie. Anstelle eines kamerabasierten Moduls pro Kamera verwendet es ein gemeinsames Z SDK-Payload und Nikons aktuelles Z-Serie-Unterstützungsmodell. 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 Weg 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 Originale gemäß den normalen Pfadregeln an Ihr endgültiges Ziel.

Dies bewahrt das vertraute Pfadverhalten, einschließlich Dateinamen-Tokens, Zähler, Gruppenordner und doppelsichere endgültige Namen. Es bewahrt auch die von Nikon produzierten gestuften Originale zur Wiederherstellung. Die App löscht diese gestuften Originale 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 Pfad-Ziel 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.

Gestufte Originale

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 gestufte Originale 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.