机身元数据

直接设置尼康机身元数据，或在拍摄过程中编写配置文件保存的ASK模板

机身元数据位于设置 > 机身。它控制存储在连接的尼康机身中的元数据字段。

注意：在使用尼康远程SDK v2时，机身元数据当前不可用。请使用旧版SDK模式来处理艺术家名称、版权、用户评论和元数据ASK模板。

可见控件组织如下：

包含艺术家名称和版权文本的版权卡。
用户评论卡。

某些尼康机身在相机菜单中将用户评论显示为图像评论。该应用使用用户评论，因为这是尼康远程SDK的功能名称。

元数据支持因机身、固件和当前相机状态而异。它也可能因尼康SDK模式而异。例如，某个机身的LCD上可以有元数据菜单项，而当前活动的SDK模式并未向应用程序公开这些字段。在旧版SDK模式下，这些字段保持可见，以便您在连接之前准备令牌模板，但连接的尼康模块决定在运行时可以读取或写入什么。在尼康远程SDK v2模式下，当测试的v2支持不可用时，机身元数据控件可能会被隐藏。保存的元数据模板会被保留，因此切换回旧版SDK模式可以恢复配置的模板。

字面模式

当元数据字段的文本不包含@ASK或@SCASK令牌时，该字段处于字面模式。字面文本属于相机机身。当应用程序连接时，从机身读取该值，按下设置时，当连接的模块报告该字段可设置时，将当前字面值写入机身。

版权卡有一个设置按钮，用于艺术家名称和版权。在字面模式下，按下设置会验证两个字段，并在连接的模块报告字段可设置时写入两个机身值。

字面机身元数据不会保存在应用程序配置文件中。如果您切换配置文件，应用程序不会将相机拥有的字面值存储或恢复为配置文件数据。

令牌模式

当元数据字段仅包含@ASK或@SCASK令牌时，该字段处于令牌模式。路径计数器、时间戳、运行时间戳、扩展令牌和机身文件名令牌不会被解析为机身元数据。如果您在元数据字段中输入这些路径令牌之一，应用程序会警告它不会被用作元数据占位符。

在令牌模式下，设置按钮被隐藏，因为文本是模板，而不是立即写入机身。令牌模板是配置文件数据。保存配置文件时，您希望模板稍后再次加载。

令牌化的捕获元数据写入被实现为临时机身元数据。在捕获之前，应用程序从捕获存储快照中解析令牌模板，并将解析的值写入机身。正常静态捕获和脉冲或工作流捕获使用相同的捕获时间元数据行为。在静态文件保存后，应用程序会尽力清除为该捕获写入的任何令牌化机身元数据字段。

版权卡有一个附加或忽略开关，用于尼康版权元数据块。该块包括在确认的机身（如Z50和D800）上的艺术家名称和版权文本。当艺术家名称或版权被令牌化时，解析的值仅在版权卡设置为附加时在捕获之前写入。当版权卡设置为忽略时，模板仍然可以创建ASK字段并保存在配置文件中，但版权元数据块不会在捕获时写入机身。

用户评论有自己的附加或忽略开关。当用户评论被令牌化时，解析的值仅在用户评论设置为附加时在捕获之前写入。当用户评论设置为忽略时，令牌模板仍然可以创建ASK字段并保存在配置文件中，但用户评论不会在捕获时写入机身。

ASK和SCASK元数据模板

您可以在元数据模板中包含@ASK和@SCASK令牌。这些令牌以与路径模板相同的方式创建ASK字段。ASK令牌必须使用完整描述符形式，带有两个#分隔符。例如，@ASK1#1:School#是有效的，但@ASK1不是元数据占位符。围绕格式不正确的类似ASK令牌的字面文本并不会使其有效。例如，A@ASK1仍然是格式不正确的，因为缺少完整描述符。

示例：

@ASK1#Client#
@SCASK1#*1:Item#
Job @ASK1#1:Job# - Item @SCASK1#*2:Item#

不是元数据占位符的示例：

A@GCT3
@YYYY
@BFN
A@ASK1

对于输入值使用ASK。对于通常由串行条形码扫描仪提供的值使用SCASK。SCASK字段仍然可以手动输入。

ASK和SCASK值可能是敏感的，因为它们可能包含客户名称、样本ID、学生ID、订单号、证据标识符或条形码有效载荷。应用程序的ASK日志记录是隐私意识的，不会记录输入的ASK值或扫描仪有效载荷。

如果相机在清理完成之前关闭、断开连接或变得不可用，ASK和SCASK元数据清理只能尽力而为。应用程序避免记录输入的ASK或SCASK值，并避免记录解析的元数据有效载荷。

有关完整的令牌语法、字段顺序、必填字段、占位符、扫描仪可用字段和提交行为，请打开ASK帮助页面。

配置文件持久性

配置文件边界很简单：

字面元数据值是相机拥有的机身数据，不会保存在配置文件中。
ASK元数据模板是应用程序/配置文件数据，并与配置文件一起保存。
路径模板是路径页面上的单独配置文件数据。
在捕获过程中输入的ASK值是运行时数据，而不是配置文件设置。

这防止配置文件意外覆盖字面机身元数据，同时仍允许可重用的ASK元数据模板用于捕获工作流。

ASCII和长度限制

尼康机身元数据字符串仅支持ASCII。请勿使用Unicode文本，例如带重音的字母、汉字、表情符号或排版标点。

尼康模块PDF在每个元数据字段存在的字节限制方面是一致的：

艺术家名称：36个ASCII字节。
版权：54个ASCII字节。
用户评论：36个ASCII字节。

由于这些字段仅支持ASCII，一个允许的字符占用一个字节。

这些PDF在确切的可打印ASCII集方面并不完全一致。一些模块描述了一个ASCII 90字符集，而较新的措辞通常描述ASCII 95。为了避免相机拒绝，应用程序使用保守的ASCII 90集验证字面设置值。

允许的字面字符包括：

空格。
数字0到9。
英文字母A到Z和a到z。
标点符号：! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ ] _ { }

在该保守集之外的可打印ASCII字符不被接受为字面设置。这包括反斜杠、插入符号、反引号、竖线和波浪号。

如果字面值过长或包含不支持的字符，应用程序会在匹配的元数据卡中显示警告，并且不会将该值发送到相机。

ASK模板文本框可以比最终相机值更长，因为模板可能包含令牌语法。当令牌化捕获写入运行时，解析的值仍必须符合相同的ASCII和长度规则，才能写入机身。如果解析的令牌值过长或包含不支持的字符，捕获将在临时值写入机身之前被拒绝。状态行显示特定字段的拒绝消息，例如艺术家名称、版权或用户评论元数据过长。

运行时权限

连接的尼康模块是元数据支持的权威。应用程序不依赖于硬编码的机身支持表来控制实时设置按钮。旧版尼康SDK模式和尼康远程SDK v2模式可能会报告同一相机的不同元数据支持。如果当前SDK模式未公开艺术家名称、版权、用户评论或其附加开关，应用程序无法读取、写入或应用捕获时间的ASK元数据。

当机身连接时，应用程序询问尼康模块哪些功能是可用的，以及它们当前是否可设置。结果控制每个字段的设置按钮和卡片消息。

字段可以处于以下一种实际状态：

断开连接或未知：字段保持可编辑，但字面设置不可用。
功能缺失：连接的机身未报告该元数据功能。
存在但当前不可设置：机身报告该功能，但当前相机状态不允许写入。
可设置：字面模式可以通过设置写入值。

如果功能缺失或不可设置，应用程序会显示安静的特定字段消息，而不是隐藏该字段。

当元数据不可设置时

元数据字段可以在机身上存在，但在当前相机状态下不可写。确切原因由相机和尼康模块控制。

尼康模块文档中列出的常见原因包括：

电影录制。
点测白平衡模式。
某些旧机身的实时视图。
某些机身的镜头升起状态。
相机忙碌状态。

应用程序不会猜测确切原因，除非运行时SDK路径公开它。如果字段不可设置，请停止电影录制或其他活动相机工作，等待机身变为空闲状态，或在相机状态似乎过时时重新连接。

字段说明

艺术家名称和版权共享一个版权元数据卡。该卡有一个附加或忽略开关和一个设置按钮，用于尼康版权元数据块。在Z50和D800上的运行时验证显示，艺术家名称依赖于相机的版权附加状态，以出现在捕获的文件元数据中。如果令牌化的艺术家名称写入机身但未出现在保存的图像中，请将版权卡设置为附加并重新测试。这反映了相机的版权屏幕模型：附加状态属于版权元数据块，而不仅仅是版权文本字段。

用户评论在文本字段旁边有一个附加或忽略开关。在某些相机菜单中，这显示为图像评论。令牌化的用户评论值仅在此开关设置为附加时在捕获之前写入。

附加或忽略开关取决于运行时能力状态。如果连接的模块报告匹配的附加能力缺失或不可设置，则该开关不可用。