Metadatos del cuerpo
Los metadatos del cuerpo están en Configuración > Cuerpo. Controla los campos de metadatos que se almacenan en el cuerpo Nikon conectado.
Nota: Los metadatos del cuerpo no están disponibles actualmente al usar Nikon Remote SDK v2. Utilice el modo Legacy SDK para el Nombre del Artista, Copyright, Comentario del Usuario y plantillas de metadatos ASK.
Los controles visibles están organizados de la siguiente manera:
- Una tarjeta de Copyright con el Nombre del Artista y el texto de Copyright.
- Una tarjeta de Comentario del Usuario.
Algunos cuerpos Nikon muestran el Comentario del Usuario como Comentario de Imagen en el menú de la cámara. La aplicación utiliza el Comentario del Usuario porque ese es el nombre de la capacidad del Nikon Remote SDK.
El soporte de metadatos varía según el cuerpo, el firmware y el estado actual de la cámara. También puede variar según el modo del SDK de Nikon. Por ejemplo, un cuerpo puede tener elementos de menú de metadatos en su LCD mientras que el modo SDK activo no expone esos campos a la aplicación. En el modo Legacy SDK, los campos permanecen visibles para que pueda preparar plantillas de tokens antes de conectar, pero el módulo Nikon conectado decide qué se puede leer o escribir en tiempo de ejecución. En el modo Nikon Remote SDK v2, los controles de Metadatos del cuerpo pueden estar ocultos cuando el soporte v2 probado no está disponible. Las plantillas de metadatos guardadas se preservan, por lo que volver al modo Legacy SDK puede restaurar las plantillas configuradas.
Modo literal
Un campo de metadatos está en modo literal cuando el texto no contiene un @ASK o @SCASK token. El texto literal pertenece al cuerpo de la cámara. Se lee del cuerpo cuando la aplicación se conecta, y al presionar Establecer se escribe el valor literal actual en el cuerpo cuando el módulo conectado informa que el campo es escribible.
Utilice el modo literal cuando el mismo valor deba permanecer en el menú de la cámara, como un Nombre de Artista de estudio o un aviso de copyright fijo.
La tarjeta de Copyright tiene un botón Establecer para el Nombre del Artista y el Copyright. En modo literal, al presionar Establecer se validan ambos campos y se escriben ambos valores en el cuerpo cuando el módulo conectado informa que los campos son escribibles.
Los metadatos literales del cuerpo no se guardan en los perfiles de la aplicación. Si cambia de perfil, la aplicación no almacena ni restaura el valor literal de propiedad de la cámara como datos del perfil.
Modo de token
Un campo de metadatos está en modo de token solo cuando contiene un @ASK o @SCASK token. Los contadores de ruta, las marcas de tiempo, las marcas de tiempo de ejecución, los tokens de extensión y los tokens de nombre de archivo del cuerpo no se resuelven para los Metadatos del cuerpo. Si escribe uno de esos tokens de ruta en un campo de metadatos, la aplicación advierte que no se utilizará como un marcador de posición de metadatos.
En modo de token, Establecer está oculto porque el texto es una plantilla, no una escritura inmediata en el cuerpo. Las plantillas de tokens son datos del perfil. Guarde el perfil cuando desee que la plantilla se cargue nuevamente más tarde.
Las escrituras de metadatos de captura tokenizados se implementan como metadatos del cuerpo transitorios. Inmediatamente antes de la captura, la aplicación resuelve las plantillas de tokens de la instantánea de almacenamiento de captura y escribe el valor resuelto en el cuerpo. La captura normal de fotos fijas y la captura de Pulse o flujo utilizan el mismo comportamiento de metadatos en el momento de la captura. Después de que se guarda el archivo fijo, la aplicación borra cualquier campo de metadatos del cuerpo tokenizados que escribió para esa captura como mejor esfuerzo.
La tarjeta de Copyright tiene un interruptor Adjuntar o Ignorar para el bloque de metadatos de copyright de Nikon. Ese bloque incluye el Nombre del Artista y el texto de Copyright en cuerpos confirmados como el Z50 y D800. Cuando el Nombre del Artista o el Copyright están tokenizados, los valores resueltos se escriben antes de la captura solo cuando la tarjeta de Copyright está configurada en Adjuntar. Cuando la tarjeta de Copyright está configurada en Ignorar, las plantillas aún pueden crear campos ASK y permanecer guardadas en el perfil, pero el bloque de metadatos de copyright no se escribe en el cuerpo para la captura.
En términos del menú del cuerpo Nikon, el Copyright es un bloque de metadatos. El Artista identifica al creador, y el Copyright contiene el aviso de copyright. Por ejemplo, use el Nombre del Artista para Russ y Copyright para (c) 2026, en lugar de poner todo el aviso en el campo de Copyright.
El Comentario del Usuario tiene su propio interruptor Adjuntar o Ignorar. Cuando el Comentario del Usuario está tokenizado, el valor resuelto se escribe antes de la captura solo cuando el Comentario del Usuario está configurado en Adjuntar. Cuando el Comentario del Usuario está configurado en Ignorar, la plantilla de token aún puede crear campos ASK y permanecer guardada en el perfil, pero el Comentario del Usuario no se escribe en el cuerpo para la captura.
Plantillas de metadatos ASK y SCASK
Puede incluir tokens @ASK y @SCASK en las plantillas de metadatos. Esos tokens crean campos ASK de la misma manera que lo hacen en las plantillas de ruta. Los tokens ASK deben usar la forma de descriptor completo con ambos delimitadores #. Por ejemplo, @ASK1#1:School# es válido, pero @ASK1 no es un marcador de posición de metadatos. El texto literal alrededor de un token similar a ASK mal formado no lo hace válido. Por ejemplo, A@ASK1 sigue siendo mal formado porque falta el descriptor completo.
Ejemplos:
@ASK1#Client#@SCASK1#*1:Item#Job @ASK1#1:Job# - Item @SCASK1#*2:Item#
Ejemplos que no son marcadores de posición de metadatos:
A@GCT3@YYYY@BFNA@ASK1
Utilice ASK para valores escritos. Utilice SCASK para valores que son comúnmente proporcionados por un escáner de código de barras en serie. Los campos SCASK aún se pueden escribir manualmente.
Los valores ASK y SCASK pueden ser sensibles porque pueden contener nombres de clientes, identificaciones de especímenes, identificaciones de estudiantes, números de pedido, identificadores de evidencia o cargas de código de barras. El registro de ASK de la aplicación es consciente de la privacidad y no registra los valores ASK ingresados o las cargas del escáner.
La limpieza de metadatos ASK y SCASK solo puede ser un mejor esfuerzo si la cámara se apaga, se desconecta o se vuelve no disponible antes de que se complete la limpieza. La aplicación evita registrar los valores ASK o SCASK ingresados y evita registrar las cargas de metadatos resueltas.
Para la sintaxis completa de tokens, el orden de los campos, los campos requeridos, los marcadores de posición, los campos capaces de escáner y el comportamiento de envío, abra la página de ayuda de ASK.
Persistencia del perfil
El límite del perfil es simple:
- Los valores de metadatos literales son datos de cuerpo de propiedad de la cámara y no se guardan en los perfiles.
- Las plantillas de metadatos ASK son datos de aplicación/perfil y se guardan con el perfil.
- La plantilla de ruta es un dato de perfil separado en la página de ruta.
- Los valores ASK ingresados durante la captura son datos de tiempo de ejecución, no configuraciones de perfil.
Esto evita que los perfiles sobrescriban accidentalmente los metadatos literales del cuerpo, mientras que aún permite plantillas de metadatos ASK reutilizables para flujos de trabajo de captura.
Límites de ASCII y longitud
Las cadenas de metadatos del cuerpo Nikon son solo ASCII. No utilice texto Unicode como letras acentuadas, caracteres en mandarín, emoji o puntuación tipográfica.
Los PDFs del módulo Nikon son consistentes sobre los límites de bytes donde cada campo de metadatos está presente:
- Nombre del Artista: 36 bytes ASCII.
- Copyright: 54 bytes ASCII.
- Comentario del Usuario: 36 bytes ASCII.
Debido a que estos campos son solo ASCII, un carácter permitido es un byte.
Los PDFs no son perfectamente consistentes sobre el conjunto exacto de ASCII imprimible. Algunos módulos describen un conjunto de 90 caracteres ASCII, mientras que una redacción más nueva a menudo describe ASCII 95. Para evitar rechazos de cámara evitables, la aplicación valida los valores literales de Establecer con el conjunto conservador de ASCII 90.
Los caracteres literales permitidos son:
- Espacio.
- Dígitos
0a9. - Letras en inglés
AaZyaaz. - Puntuación:
! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ ] _ { }
Los caracteres ASCII imprimibles fuera de ese conjunto conservador no son aceptados para Establecer literal. Esto incluye barra invertida, acento circunflejo, comillas invertidas, barra vertical y tilde.
Si un valor literal es demasiado largo o contiene caracteres no admitidos, la aplicación muestra la advertencia en la tarjeta de metadatos correspondiente y no envía el valor a la cámara.
Los cuadros de texto de la plantilla ASK pueden ser más largos que el valor final de la cámara porque la plantilla puede contener sintaxis de token. Cuando se ejecutan las escrituras de captura tokenizadas, el valor resuelto aún debe ajustarse a las mismas reglas de ASCII y longitud antes de que se pueda escribir en el cuerpo. Si un valor de token resuelto es demasiado largo o contiene caracteres no admitidos, la captura se rechaza antes de que el valor transitorio se escriba en el cuerpo. La línea de estado muestra un mensaje de rechazo específico del campo, como que el Nombre del Artista, Copyright o Comentario del Usuario son demasiado largos.
Autoridad de tiempo de ejecución
El módulo Nikon conectado es la autoridad para el soporte de metadatos. La aplicación no se basa en tablas de soporte de cuerpo codificadas de forma rígida para los botones de Establecer en vivo. El modo Legacy Nikon SDK y el modo Nikon Remote SDK v2 pueden informar diferentes soportes de metadatos para la misma cámara. Si el modo SDK actual no expone el Nombre del Artista, Copyright, Comentario del Usuario o sus interruptores de adjunto, la aplicación no puede leer, escribir o aplicar metadatos ASK en el momento de la captura para esos campos en esa conexión. Cuando el modo v2 no expone estos campos en cuerpos probados, ControlMyNikon oculta los controles de Metadatos del cuerpo y muestra una nota de disponibilidad v2 en su lugar.
Cuando un cuerpo está conectado, la aplicación pregunta al módulo Nikon qué capacidades están presentes y si son actualmente escribibles. El resultado controla el botón Establecer de cada campo y el mensaje de la tarjeta.
Un campo puede estar en uno de estos estados prácticos:
- Desconectado o desconocido: el campo permanece editable, pero Establecer literal no está disponible.
- Capacidad faltante: el cuerpo conectado no informa que tiene esa capacidad de metadatos.
- Presente pero no escribible ahora: el cuerpo informa la capacidad, pero el estado actual de la cámara no permite escribirlo.
- Escribible: el modo literal puede escribir el valor con Establecer.
Si falta una capacidad o no es escribible, la aplicación muestra un mensaje específico del campo en lugar de ocultar el campo.
Cuando los metadatos no son escribibles
Un campo de metadatos puede estar presente en un cuerpo pero no ser escribible en el estado actual de la cámara. La razón exacta es controlada por la cámara y el módulo Nikon.
Las razones comunes enumeradas en la documentación del módulo Nikon incluyen:
- Grabación de video.
- Modo de Balance de Blancos puntual.
- Live View en algunos cuerpos más antiguos.
- Estado de espejo levantado en algunos cuerpos.
- Estados de cámara ocupada.
La aplicación no adivina la razón exacta a menos que la ruta del SDK de tiempo de ejecución la exponga. Si un campo no es escribible, detenga la grabación de video u otro trabajo activo de la cámara, espere a que el cuerpo se vuelva inactivo o reconéctese si el estado de la cámara parece obsoleto.
Notas de campo
El Nombre del Artista y el Copyright comparten una tarjeta de metadatos de Copyright. La tarjeta tiene un interruptor Adjuntar o Ignorar y un botón Establecer para el bloque de metadatos de copyright de Nikon. La validación en tiempo de ejecución en el Z50 y D800 muestra que el Nombre del Artista depende del estado de Adjuntar del Copyright de la cámara para aparecer en los metadatos del archivo capturado. Si el Nombre del Artista tokenizado se escribe en el cuerpo pero no aparece en la imagen guardada, configure la tarjeta de Copyright en Adjuntar y pruebe nuevamente. Esto refleja el modelo de pantalla de Copyright de la cámara: el estado de adjunto pertenece al bloque de metadatos de copyright, no solo al campo de texto de Copyright.
El Comentario del Usuario tiene un interruptor Adjuntar o Ignorar junto al campo de texto. En algunos menús de cámara, esto aparece como Comentario de Imagen. Los valores de Comentario del Usuario tokenizados por ASK se escriben antes de la captura solo cuando este interruptor está configurado en Adjuntar.
Los interruptores Adjuntar o Ignorar dependen del estado de capacidad en tiempo de ejecución. Si el módulo conectado informa que falta la capacidad de adjunto correspondiente o no es escribible, el interruptor no está disponible.
Configuración relacionada
Utilice ASK cuando las plantillas de metadatos necesiten valores escritos o escaneados. Utilice Ruta cuando las carpetas de destino y los nombres de archivo necesiten contadores, fechas, nombres de archivo del cuerpo u otros tokens de Ruta. Utilice Perfiles para guardar y recargar plantillas de metadatos ASK. Utilice la configuración del Cuerpo para conexión, inicio de vista en vivo, bloqueo del cuerpo, temporización de comunicación y opciones de medidor de exposición.