Capturer des transactions

Soyez assuré : lorsque l'application est responsable de l'enregistrement d'une capture sur votre ordinateur, elle surveille l'enregistrement comme une transaction de capture. La transaction n'est pas considérée comme complète simplement parce que l'obturateur a été déclenché ou qu'un enregistrement vidéo a été arrêté. L'application doit également prouver que le fichier attendu côté ordinateur a atteint correctement sa destination finale.

Cela est particulièrement important lors de sessions à fort volume ou critiques, telles que les portraits scolaires, les lots de produits, le travail d'évidence, la documentation médicale, les supports de copie et d'autres prises de vue où un enregistrement manqué pourrait affecter de nombreuses décisions ultérieures.

Ce que protège une transaction

Une transaction de capture protège l'enregistrement côté ordinateur.

Si votre mode d'enregistrement attend un fichier image ou vidéo sur l'ordinateur, l'application surveille le transfert SDK, l'enregistrement final du chemin et la preuve finale du fichier avant de considérer la capture comme réussie. Si la capture est uniquement sur carte, l'application ne s'attend pas à un fichier final sur l'ordinateur pour cette capture.

L'objectif est simple : éviter la situation dangereuse où l'appareil photo a pris une photo, mais le fichier que vous attendiez sur l'ordinateur est manquant, incomplet ou n'est pas à l'endroit où le flux de travail l'attend.

Captures Legacy Remote SDK

En mode Legacy Remote SDK, l'application reçoit des données multimédias du SDK Nikon et les enregistre via le pipeline final.

Pour un enregistrement d'image fixe ou de vidéo côté ordinateur, la transaction vérifie que :

• Le SDK a livré les données multimédias attendues.
• L'emplacement final du chemin a été sélectionné.
• L'application a écrit les données dans un fichier temporaire pré-publication .ttctmp.
• Le fichier temporaire a été renommé avec l'extension finale d'image ou de vidéo.
• Le fichier final existe.
• La taille du fichier final correspond aux données reçues par le SDK.
• L'attribut de fichier en lecture seule a été appliqué lorsque ce paramètre est activé.

Le .ttctmp fichier est un fichier temporaire pré-publication. Il empêche les observateurs de dossiers, les scanners antivirus, les scripts et les navigateurs d'images de réagir à un fichier final partiellement écrit. Le fichier final renommé est la preuve qui compte pour la transaction de capture.

Captures Unified Z SDK v2

En mode Unified Z SDK v2, Nikon écrit d'abord les images fixes côté ordinateur dans un dossier de staging spécifique à la capture. L'application audite ensuite les originaux mis en scène et les copie selon les règles normales du chemin vers votre destination finale.

Pour les enregistrements d'images fixes côté ordinateur, la transaction vérifie que :

• Un dossier de staging GUID spécifique à la capture a été créé.
• La demande de StartShooting de Nikon a réussi.
• L'état de prise de vue a atteint un état terminal.
• Des fichiers mis en scène ont été trouvés dans le dossier de staging attendu.
• Les tailles des fichiers mis en scène se sont stabilisées avant la copie finale.
• L'application a copié chaque original mis en scène dans un fichier temporaire du chemin final.
• Le fichier temporaire a été renommé avec l'extension finale.
• Le fichier final existe et correspond à la taille de l'original mis en scène.
• Le manifeste de capture enregistre le résultat de l'audit.

Les originaux mis en scène sont conservés pour la récupération et le support. L'application ne supprime pas automatiquement les originaux mis en scène produits par Nikon après la copie finale du chemin.

Que se passe-t-il si la preuve échoue

Si l'application ne peut pas prouver qu'une capture requise côté ordinateur a été enregistrée correctement, elle considère cela comme un échec critique de l'enregistrement de la capture.

Lorsque cela se produit :

• Une alerte d'erreur de Guidance apparaît en haut de l'application.
• Le journal enregistre le mode SDK, le corps, le mode d'enregistrement, la phase échouée, les chemins pertinents et les comptes d'octets lorsque cela est disponible.
• Les commandes de flux de travail de capture en attente sont annulées afin qu'une séquence ne continue pas à tirer dans la même erreur.
• Les messages de préparation normale ou de progression ne doivent pas masquer l'alerte d'échec.
• Si activé, l'application déconnecte le corps après que l'alerte a été levée.

Lisez d'abord l'alerte de Guidance. Ensuite, ouvrez le journal si vous avez besoin des informations de diagnostic détaillées.

Déconnexion après une erreur critique d'enregistrement de capture

Paramètres  Corps  Transactions inclut Déconnexion après une erreur critique d'enregistrement de capture.

Activez cela lorsque continuer après un enregistrement échoué serait pire que d'arrêter la session. Pour un travail de production critique, se déconnecter est souvent le choix le plus sûr car cela rend le problème évident et empêche d'autres captures d'entrer dans le même chemin d'enregistrement échoué.

Laissez-le désactivé si vous souhaitez que l'appareil photo reste connecté pendant que vous lisez l'alerte et décidez quoi faire ensuite. L'application lève toujours l'alerte d'erreur de Guidance et écrit les détails du journal lorsque le paramètre est désactivé.

Tester le chemin d'échec

Les paramètres  Corps  Transactions incluent également des indicateurs de test de capture de débogage spécifiques au SDK. Ces indicateurs forcent délibérément des échecs de transaction de capture afin que vous puissiez confirmer que l'alerte, le journal, l'annulation du flux de travail et le comportement de déconnexion optionnel sont visibles avant de vous fier au flux de travail en production.

Utilisez-les uniquement pendant une session de test. Laissez-les désactivés pour la prise de vue normale.

Indicateurs de test de capture de débogage Legacy :

• Forcer l'erreur de capture SDK Legacy
• Forcer l'erreur de transfert Legacy
• Forcer l'échec de l'enregistrement final du PATH
• Forcer le désaccord de taille finale du PATH

Indicateurs de test de capture de débogage v2 :

• Forcer l'erreur de capture SDK v2
• Forcer l'échec de l'audit de staging v2
• Forcer l'échec de l'enregistrement final du PATH
• Forcer le désaccord de taille finale du PATH
• Forcer un chemin enregistré SDK inattendu

Après un échec forcé, confirmez que vous avez vu l'alerte d'erreur de Guidance, que le journal contient une entrée DEBUG TEST, et que le corps s'est déconnecté si Déconnexion après une erreur critique d'enregistrement de capture était activé. Ensuite, désactivez l'indicateur de test avant de continuer le travail de capture normal.

Que transmettre au support

Si vous contactez le support après un échec de transaction de capture, incluez :

• Le titre et le message de l'alerte de Guidance.
• Le fichier journal.
• Le mode SDK Nikon actif.
• Le modèle de corps connecté.
• Le mode d'enregistrement de capture.
• Le dossier final du chemin que vous attendiez.
• Le dossier de staging v2 ou le manifeste de capture lorsque le Unified Z SDK v2 a été utilisé.

Cette preuve rend généralement l'échec reconstructible sans deviner.