(高清版)GBT 41903.2-2022 信息技术 面向对象的生物特征识别应用编程接口 第2部分：Java实现

国家市场监督管理总局国家标准化管理委员会I Ⅲ V 1 1 1 15BioAPIJava包的结构 2 2 25.3org.bioapi.data包 2 2 26.2BFPListElement类 36.3BFPSchema类 4 5 6.7DataTypes类 22 256.10GUIBitmap类 26 276.12PopulationMember类 28 28 29 6.16UnitListElement类 6.17UnitSchema类 7支持BioAPI_Unit的面向对象的接口 7.1通用要求 7.2存档接口 7.3比对接口 7.4处理接口 407.5传感器接口 42 43Ⅱ8.1BFP接口描述 438.2导入接口 438.3方法汇总 43 459.1BSP接口描述 459.2导入接口 469.3方法汇总 46 11.1BioAPIExcep 13.3BFPGUIProgressEventListener 附录B(资料性)调用序列示例和示例代码 B.1参考实现 B.2API体系结构 Ⅲ本文件是GB/T41903《信息技术面向对象的生物特征识别应用编程接口》的第2部分。本文件修改采用ISO/IEC30106-2:2020《信息技术面向对象的生物特征识别应用编程接——本文件的8.1对应ISO/IEC30106-2:2020的7.1;——本文件的9.1对应ISO/IEC30106-2:2020的8.1;——用规范性引用的GB/T41903.1—2022替换了ISO/IEC30106-1:2016,两个文件之间的对应——增加了规范性引用的GB18030,以便于适应我国的编码字符V面向对象的应用编程接口需要统一的体系结构，实现语言包括Java、C#和C+十等，因此 1GB/T13000—2010信息技术通用多八位编码字符集(UCS)(ISO/IEC10646:2003,IDT)GB18030信息技术中文编码字符集GB/T41903.1—2022信息技术面向对象的生物特征识别应用编程接口第1部分：体系结构2UUID通用唯一标识符(UniversallyUniqueIdentifier)BioAPIJava接口分为多个包。包的结构如下：此包的描述解释了一个自下而上的结构。第7章介绍了每种单元类型需要实现的接口。值得注意到已实现的BSP和/或BFP类中的方法和属性是通用的。接下来的是BFP接口(第8章)和BSP接口(第9章)的实现规范。这两种接口提供了较低层次的互操作性，等同于GB/T30267.1中的服务供方接口(ServiceProviderInterface,SPI)和功能供方接口(FunctionProviderInterfa框架(第10章，包括框架接口和组件注册表)和应用交互(第11章，包括异常和回调函数规范)提供5.3org.bioapi.data包此包包含实现面向对象的BioAPI(ObjectOrientedBioAPI,00BioAPI)所需的所有数据结构。提供了几种数据结构来满足本文件规定的要求。第6章规定了全部的org.bioapi.data的包，其中定义了所有需要的类和枚举。这是在GB/T41903.1—2022中第8章基础上增加的常量。6.1ACBioParameters类3说明当使用ACBio时，返回来自生物特征验证器的挑战。该值应设置为ACBio实例中ACBioContentInformation类型的字段c说明在生成ACBio实例时，返回分配给BioAPI_Unit、BFP或者BSP输出的BPU10索引的初始值。InitialBPUIOIndexOutput与SupremumBPUIOIndexOutput的区间应按照BSPUnit的数量和被BSP接受的BFP的数量划分成段，并分配给BSPUni说明返回BPUI0索引的上确界，当生成ACBio实例时，该值应分配给BioAPI_Unit、BFP或BSP的输出6.2BFPListElement类说明说明返回单元的类别单元的类别说明4voidsetUnitCategory(UnitCategoryTypeu说明设置单元的类别说明返回包含BFP文本描述的以NULL结束的字符串包含BFP文本描述的以NULL结束的字符串Vector(RegistryID)getBFPSupp说明说明Vector(BiometricType)getFactorsMask()说明byte[]getFWProperty()说明返回含有BFP属性的缓存区的地址和长度。BFP属性的格式和内容可以由供说明以下BFP属性格式的UUID5说明返回一个指向以NULL结束的字符串对象，该字符串包含BFP可执行代码的括文件名。路径可能是URL。该字符串由GB18030中的字符组成，并与GB/T13000—2010的附录D建立映射关系。当在函数调用中使用BFPSchema时，接受该调用的组件为Path模式元素一个指向以NULL结束的字符串对象，该字符串包含具有BFP可执行代文件名StringgetProd说明返回BFP软件的版本字符串BFP软件的版本字符串说明返回实现BFP的BioAPI规范的主/实现BFP的BioAPI规范的主/次版本号说明返回用BFPUUID标识的BFP的类别说明返回包含BFP供应商名称的以NULL结束的字符串包含BFP供应商名称的以NULL结束的字符串在GB/T41903.1—2022的第7章中给出。说明使用编码为CBEFF记录的字节数组填充BIR数据，如ISO/IEC19785-3和ISO/IEC19785-4的相6表(续)如果输入的参数无效，格式不被支持或者由于错误导致操作失败，则抛出BioAbyte[]birToByteArray()说明序列化BIR记录，以使其作为表示CBEF如果输入的参数无效，格式不被支持或者由于错误导致操作失败，则抛出说明移除当前BIR中所有信息，清空以备下次使用无BiometricSubtyp说明BiometricTyp说明byte[]getBDBChallengeResponse()说明DategetBDBCreationDat说明返回BDB创建日期7说明RegistryIDgetBDBFormat()说明说明返回BDB索引BDB索引说明返回BDB处理级别2PurposegetBDBPurpose()说明说明4Vector(Date)getBDBValidityPeriod()说明返回BDB有效期说明8说明7byte[]getBIRIndex()说明返回BIR索引BIR索引8byte[]getBIR说明说明0bytegetCB说明说明返回维护者格式。说明说明9说明说明6booleanhasBDBIntegrity()说明8booleanisQualitySupported()说明异常无说明设置BDB生物特征子类型bdbBiometricSubtype:BDB生1voidsetBDBBiomet说明bdbBiometricType:BDB2voidsetBDBChallengeResponse(bytebdbChall说明bdbChallengeResponse:B3voidsetBDBCreationDate(Datebd说明设置BDB创建日期4voidsetBDBEncri说明bdbEncription:如果BDB加密，则为TRUE,否则5voidsetBDBF说明6voidsetBDBData(byte[]bdbData)说明设置BDB数据7voidsetBDBIndex(byte[]bdb说明8voidsetBDBInt说明bdbIntegrity:如果BDB数据具有完整性，则为TRUE,否则说明0voidsetBDBProce说明设置BDB处理级别bdbProcessedLevel:B说明设置BDB用途说明设置BDB有效期说明设置BIR创建日期4voidsetBIRCr说明说明设置BIR索引birIndex:BIR索引说明birAdditionalData:BIRadditio说明设置BIR有效期说明说明说明patronHeaderVersion说明设置SB数据sbData:SB数据说明UUIDgetBSPA说明返回一个UUID,其在应用范围内是唯一的，应用可以使用该UUID来引用BSP,作为BSP产品UUID的替代。符合本文件的框架应忽略此参数，应用程序可以台计算机上存在的相同的BSP在应用范围内唯一的UUID,应用可以使用该UUID引用BSP,作为BSP产StringgetBSPD说明返回包含BSP文本描述的以NULL结束的字符串包含BSP文本描述的以NULL结束的字符串Vector(RegistryID)getBSPSupportedAlgorithms()说明返回BioAPI_ALGORITHM_ID结构的BioAPI_ALGORITHM_ID结构的数组，表明Vector(RegistryID>getBSPSupport说明说明返回BioAPI_UUID结构的数组，表明在BioAPI_Transform操BioAPI_UUID结构的数组，表明在BioAPI_Transform操作中支持的说明说明当应用未规定超时时，返回BSP使用的用于Calibrate操作的默认超时值(以毫秒为单位)intgetDefaultCaptureTime说明当应用未规定超时时，返回BSP使用的用于Capture操作的默认超时值(以毫秒为单位)intgetDefaultEnroITimeout()说明当应用未规定超时时，返回BSP使用的用于Enrol操作的默认超时值(以毫秒为单位)6.5.2.10intgetDefaultId说明当应用未规定超时时，返回BSP使用的用于Identify操作的默认超时值(以毫秒为单位)Identify操作的默认超时值1intgetDefaultVer说明当应用未规定超时时，返回BSP使用的用于Verify操作的默认超时值(以毫秒为单位)说明3byte[]getHostin说明返回一个标识框架的IRI,该框架的组件注册表包含BSP的注册。符合本文数，应用应将其设置为NULL。提供它是为了支持互操作标准，这些标准可以规定在相同或不同计算机上运行的应用程序中，使用多台计算机上返回一个标识框架的IRI,该框架的组件注册说明返回BSP控制的BIR数据库的最大容量。它仅适用于BSP只能直接管理值为0表示没有提供关于数据库容量的信息，原因有以下三个：a)不支持数据库；b)能够直接或通过BFP接口管理多个单元，每个单元可能具有不同的最大容量，的信息将作为插入通知的一部分(UnitSchema的一部分)提供；或c)支持一个存档单元，但这里不提供信息(它将在插入通知中提供)说明返回辨识函数支持的最大用户集。如果最大用户集没有限制，则表示为Unlimited=0说明返回在一次注册操作中，BSP可以为参考模板创建的的不同实例的最大数量使用应用控制的GUI特性的应用程序是有用的BSP可以在一次注册操作中为参考模板创建的不同实例的说明返回BSP可接受的additionalData的最大容量(以字节为单位)BSP可接受的additionalData的最大容量(以字节为单位)8Vector(BSPSchemaOperations)g说明9Vector(BSPSchemaOptions)getOptions()说明说明返回一个指向以NULL结束的字符串对象，该字符串包含BSP可执行代码文文件名。路径可能是URL。该字符串由GB18030中的字符组成，并与GB/T13录D建立映射关系。当在函数调用中使用BioAPI_BSP_SCHEMA时，接受该调一个指向以NULL结束的字符串对象，该字符串包含BSP可执行代码的件名说明返回设置的阈值(FMR最大值),用于决定验证成功后何时释放addi设置的阈值(FMR最大值),用于决定验证成功后何时释放ad说明返回BSP软件版本的字符串BSP软件版本的字符申说明返回实现BSP的BioAPI规范的主/次版本号实现BSP的BioAPI规定的主/次版本号说明返回包含BSP供应商名称的以NULL结束的字符串包含BSP供应商名称的以NULL结束的字符串定义从Identify功能中产生的每个候选者。说明返回一个整型值，表示候选者在Identi说明返回一个键值，定义了系统中(例如数据库中说明说明定义了本文件能够使用的多个数据类型，包含枚举和常量。本文件中未定义的常量值见GB/T41903.1—2022中第8章的规定。BiometricSubt说明使用的生物特征数据的子类型(例如指纹模态中使用的具体手指)。当此信息式时，应使用GB/T41903.1—2022的第8章中表(续)说明GB/T41903.1—2022的第枚举常量汇总说明枚举常量汇总——READ:只允许检索记录的访问模式；——READ_WRITE:允许添加、删除和检索记录的访问模式；——WRITE:允许添加和删除记录，但不支持检索说明枚举了BSP能够提供给生物特征识别应用的不同操作，见6.5枚举常量汇总—CALIBRATE_SENSOR(0x0 ——CREATE_TEMPLATE(0x0——CREATE_TEMPLATE_WITH_AUX_BIR(0x0—-GET_INDICATOR_STATUS(0x0——IDENTIFY_AGGREGATE(0x0—PRESET_IDENTIFY_POPULATION(0x0——PROCESS_WITH_AUX_BIR(0x0——SET_INDICATOR_STATUS(0x0——SET_POWER_MODE(0x0——VERIFY_AGGREGATED(0x0——VERIFY_WITH_AUX_BIR(0x0说明枚举BSP可以处理的不同选项，见6.5枚举常量汇总——CAPTURE_MULTIPLE(0x0——COARSE_SCORES(0x0——COMPARISON_BFP(0x0 ———GUI_PROGRESS_EVENTS(0x0——IDENTIFY_INDICATOR(0x0——0CC(0x00004000)(on-cardcomparison,原名叫卡上匹配(MatchonCard,MOC))—-PROCESSING_BFP(0x0—PROCESS_MULTIPLE(0x0——QUALITY_INTERMEDIATE(0x0——QUALITY_PROCESSED(0x0——SELF_CONTAINED_DEVICE(0x0——SOURCE_PRESENT(0x0——SUBTYPE_TO_CAPTURE(0x0——TEMPLATE_UPDATE(0x0说明定义了引发事件的不同来源种类枚举常量汇总——SOURCE_PRESENT(0x00——SOURCE_REMOVED(0x00说明定义异常事件中错误的引发者，见11.1枚举常量汇总——FRAMEWORK:由框架组件报告错——BSP:由生物特征识别服务供方报告错说明枚举常量汇总说明枚举常量汇总说明当调用GUI回调函数时，确定正在执行的操作，见11.2枚举常量汇总说明枚举常量汇总说明枚举常量汇总 说明确定BIR的处理级别枚举常量汇总说明定义BIR或过程的目的枚举常量汇总 —-ENROL_FOR_VERIFICATI——ENROLFOR_IDENTIFICACI说明定义对某些BioAPI方法的请求，以向最初定义的方法提供附枚举常量汇总——REQUEST_ADAPTED_BIR:请求创建一个BIR,即通过使用输入到生物特——REQUESTPAYLOAD:请求在验证成功后返回additionalData;—REQUESTADDITIONALDATA:请求使用附加数据，例如，在审计过程中说明定义BioAPI_Unit支持的安全选项枚举常量汇总——ENCRYPTION(Ox00000001):表示BioAPI_Unit支持加密；—MAC(Ox00000002):表示BioAPI_Unit支持MAC生成；——DIGITAL_SIGNTURE(Ox00000004):表示BioAPI_Unit支持数字签名；——AC_BIO_GENERATION_WITH_MAC(Ox00000010):表示BioAPI_Unit成ACBio;——AC_BIO_GENERATION_WITH_DIGITAL_SIGNTURE(Ox00000020):表示BioAPI_Unit说明列出BioAPI_Unit的不同类别枚举常量汇总——ARCHIVE:该单元管理BSP的BIR数据库(0x00000001);—COMPARISION:该单元是比对算法的集合(0x00000002);——PROCESSING:该单元是处理算法的集合(0x00000004);——SENSOR:该单元管理硬件传感器(0x00000008)说明枚举常量汇总 说明枚举常量汇总——DETECT:当单元能够检测到主体与传感器的交互时的模式；——NORMAL:所有功能都正常使用时的模式；表示日历日期和时间。日期和时间的编码与CBEFF相同，并且符合GB/T26237(所有部分)规定说明返回月中的某日返回月中的某日说明小时说明返回分钟分钟说明说明秒说明booleanisLowe说明将接口中对象的日期和时间与被调用方法的参数所表示的日期和时间进行比较。方法的名称引用了以下操作：——isLowerOrEqual:“参数中的日期和时间”〈=“对象的日期和时间”;—-isHigherOrEqual:“参数中的日期和时间”>=“对象的日期和时间”——day:与对象日期比较的月中某日；——month:与对象日期比较的月份；—year:与对象日期比较的年份；——hour:与对象日期比较的小时数；——minute:与对象日期比较的分钟数；—second;与对象日期比较的秒数；如果输入的参数无效，格式不被支持或者由于错误导致操作失败，则抛出BioA说明设置日dayOfMonth:日说明设置小时说明设置分钟说明说明说明UUIDgetFram说明StringgetFWDe说明返回包含框架文本描述的以NULL结束的字符串包含框架文本描述的以NULL结束的字符串byte[]getFWProperty说明返回包含框架属性的内存缓存区。框架属性的格式和内容可以由供应商指定中指定包含框架属性的内存缓存区UUIDgetFWP说明以下框架属性格式的UUIDbyte[]getPath()说明返回一个指向以NULL结束的字符串对象，该字符串包含框架可执行代码的括文件名。路径可能是URL。该字符串由GB18030中的字符组成，并与GB/T13000—2010的附录D建立映射关系。注：当在函数调用中使用FrameworkSchema时，接受该调用的组件为Path模式元素分配内一个指向以NULL结束的字符串对象，该字符串包含具有框架可执行代括文件名StringgetProductVersi说明返回框架软件的版本字符串框架软件的版本字符串说明实现框架的BioAPI规范的主/次版本号说明返回包含框架供应商名称的以NULL结束的字符串包含框架供应商名称的以NULL结束的字符串说明说明说明说明说明向用于辨识目的的用户集添加新成员。连续调用该方法以填充用户集成员列表member:添加的成员如果输入的参数无效或者由于错误导致操作失败，则抛出BioAPIException,见11.1说明清空用于辨识的用户集列表的所有信息BioAPIException,见11.1说明说明说明确保所有成员的BIR都是未绑定的如果操作失败，则抛出BioAPIException,见11.16.12PopulationMember类说明返回用户标识符，该标识符与数据库中用户的唯一标识符相关(或相同)说明说明设置用户标识符，该标识符与数据库中用户的唯一标识符相关(或相同)说明说明说明voidsetOwner(sh说明说明type:类型编码说明返回一个掩码，指示BioAPI_Unit支持或执行MAC或数BioAPI_Unit支持或执行的MAC或数字签名的安全说明说明说明byte[]g说明说明返回BioAPI_Unit支持的数字签名算法。在该BioAPI类型中，返回的应是分配给数字签名算法的抽象语法记法一(AbstractSyntaxNotationOne,ASN.1)标识符的可扩展置标语言(ExtensibleMarkupLanguage,XML)值表示，见GB/T16262.1byte[]getSI说明Vector(SecurityOptionsType)getSupportedSe说明用类别和ID标识选择的BioAPI_Unit的列表，其中每种类别只允许有一个单元。当为某个类别说明在所选的单元列表中添加一个新的BioAPI_Unit。如果列表中已存在同类单元，则用新单元替换它说明unitCategoryType;要查找的uni如果没有所选类别的单元，则抛出BioAErrUnitCategoryNotFound类型的BioA说明返回单元的类别单元的类别说明说明设置单元的类别说明说明StringgetFirmw说明返回一个包含固件版本的以NULL结束的字符串。若无法获得，则为Empty(空)包含固件版本的以NULL结束的字符串说明Empty(空)包含供应商定义的硬件组件的唯一序列号的以NULL结束的字符串说明返回一个包含硬件版本的以NULL结束的字符串。若无法获得，则为Empty(空)包含硬件版本的以NULL结束的字符串说明如果BioAPL_Unit为Archive单元，返回单元支持的数据库的最大容量。如果为零，则无数据库如果BioAPI_Unit为Archive单元，为单元支持的数据库的最大说明如果BioAPI_Unit为Comparison单元，则返回单元支持的最大辨识用户集。如果没有限制最大用说明说明返回包含软件版本的以NULL结束的字符串。若无法获得，则为Empty(空)包含软件版本的以NULL结束的字符串Vector<EventKind>getSup说明说明1intgetU说明说明返回直接管理BioAPI_Unit(BSP本身或者BFP)说明返回BioAPI_Unit的属性集的UUID。属性集可以由每个供应商指定，也说明返回包含描述BioAPI_Unit的单元属性的内存缓存区。单元属性的格式和内指定，也可以在相关标准中规定描述BioAPI_Unit单元属性的内存缓存区说明说明返回供应商专有信息供应商专有信息的字符串说明8voidsetBSPUUID(UUIDbspUUID)说明bspUUID:支持BioAPI_Unit的BS说明 ——byte[]AuxiliaryDat UnitIndicatorStatusIndicatorStatus。该接口表示生物特征识别应用或BSP的存档功能。存档系统的具体实现取决于开发者(例如文件目录或基于结构化查询语言(StructuredQueryLanguage,SQL)的数据库引擎等),只要接口遵循本文voidcloseDatabase(intunitID)说明关闭对开发单元的数据库的访问unitID:执行操作的BioAPI_U异常如果操作失败，则抛出BioAPIException,见11.1voiddeleteBIR(intunitID,UUIDkey)说明从数据库中删除BIR。——unitID:执行操作的BioAPI_Unit的ID;如果数据库已经关闭，或者数据库以只读模式打开，或者任何其他类型的错误，ception,见11.1BIRgetSingleBIR(intunitID,UUIDkey,Vector(ResultOptions)resultOp说明——unitID:执行操作的BioAPI_Unit的ID;——key:要检索的记录的UUID;——resultOptions:请求附加输出，例如自适应BIR和/或additio如果数据库已经关闭，或者数据库以只写模式打开，或者没有找到记录误，则抛出BioAPIException,见11.1Vector(UUID>l说明unitID:执行操作的BioAPI_U异常如果数据库关闭，或者数据库以只写模式打开，或者任何其他类型的错误，则抛出BioAPIException,见11.1说明数据库，应在调用OpenDatabase之前—unitID:执行操作的BioAPI_Unit的ID;么这个参数应有一个NULL值；—access:指定对打开的数据库的访问模式(读/写)异常如果数据库已被打开，或者出现任何其他类型的错误，则抛出BioAPIException,见11.1说明将指定的BIR添加到无UUID的数据库，允许单元返回——unitID:执行操作的BioAPI_Unit的ID;——biometricReference:要存储如果数据库关闭，或者数据库以只读模式打开，或者出现任何其他类型的错误，ception,见11.1UUIDstoreBIR(i说明将指定的无UUID的BIR添加到数据库，允许单元返回在AuxiliaryData(辅助数据)中提交一组附加信息的字节。该数据的格式应能被文件规定)。例如，这些信息可以是与BiometricReference(生物特征参考)相关的人口统计信息————unitID:执行操作的BioAPI_Unit的ID;——biometricReference:要存储的指定的BIR;—auxiliaryData:存储到数据库的，与所存储的BIR如果数据库关闭，或者数据库以只读模式打开，或者出现任何其他类型的错误，则ception,见11.1说明将指定的BIR添加到数据库，并为其分配提供的UUID。如果已经分配了UUID,果程序想要更新现有的UUID,应用程序宜首先删除它，然后重新使用U——unitID:执行操作的BioAPI_Unit的ID;——biometricReference:要存储的指定的BIR;——UUID:为BIR分配的UUID表(续)如果数据库关闭，或者数据库以只读模式打开，或者UUID已经被使用了误，则抛出BioAPIException,见11.1voidstoreBIR(intun说明将指定的BIR添加到数据库，并为其分配提供的UUID。如果已经分配了UUID,果程序想要更新现有的UUID,应用程序宜首先删除它，然后重新使用UUID。这样做是为了避免非有意的覆盖。在AuxiliaryData(辅助数据)中提交一组附加信息的字节。该数据的格式应能被文件中规定)。例如，这些信息可以是与BiometricReference(生物特征参考)相关的人口统计信息——unitID:执行操作的BioAPI_Unit的ID;——biometricReference:要存储的指定的BIR;—auxiliaryData:存储到数据库的，与所存储的BIR相关的附加数据；——UUID:分配给BIR的UUID如果数据库关闭，或者数据库以只读模式打开，或者UUID已经在使用中了，或者任何其他类型的错误，则抛出BioAPIException,见11.1说明将BSP或BFP使用的数据库设置为辨识操作的数据源。这也可以用来获取数据库列表unitID:执行操作的BioAPI_U异常如果数据库关闭，或者数据库以只写模式打开，或者任何其他类型的错误，则抛出BioAPIException,见11.1说明—unitID:执行操作的BioAPI_Unit的ID;异常误，则抛出BioAPIException,见11.1说明将BSP或BFP使用的数据库设置为辨识操作的数据源。这也可被调用，来获取——unitID:执行操作的BioAPI_Unit的ID;——uuidList:包含在新的辨识用户集ception,见11.1Vector<Candidate>identify(intunitID,intmaxFMRrequested,BIRprocessedBIR,boolean说明对现有的生物特征样本执行生物特征辨识。该函数在一个经过处理的BIR与对的用户集应通过调用PresetIdentifyPopul为了更好地适应比对算法，定义了重载方法，以允许—unitID:执行操作的BioAPI_Unit的ID;—maxFMRrequested:成功辨识所要求的FMR标准(即比对阈值);—processBIR:待辨识的BIR; —auxiliaryBIRs:可选项，用于提高比对算法性能的辅助BIR列表； 个应该包含但实际没有包含可匹配的BIR的分箱的情况); —maxResults:值为0,表示请求所有候选者；表(续)如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见11.1voidpresetIdentifyPopulation(intuni说明向比对单元提供BIR用户集。成功调用此方法后，BSP可以调用identify()。BSP将此设置保持有效，直到以不同的设置调用presetIdentifyPopulation——unitID:执行操作的BioAPI_Unit的ID;如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见11.1booleanverify(intunitID,intmaxFMRrequested,BIRprocessedBIR,BIRreferenceTemplate,booleanverify(intunitID,intmaxFMRrequested,BIRprocessedBIR,BIRreferenceTemplate,说明对现有的生物特征样本进行生物特征验证。该函数在两个BIR(输入BIR和生物行验证(一对一)比对。输入BIR是专门为验证而构造的经过处理的BIR。参考模板是在注册时创建的。应用应为成功比对请求一个最大FMR值标准(阈值)。是否被更新。通过设置RequestAdaptedBir选项，应用能够请求通过使用新参考模板来构造BIR。如果比对成功，可以尝试使用输入BIR的信息来更新参考模板(并非所有BSP都执行更新操作)。最终得到的、经过更新的BIR,宜被认为是最佳注册模板(使用还是或丢弃这些数据取决于应用需要注意的是，更新可能并非在所有情况下都发生。回additionalData。该接口的Get函数提供了对结果的不同访问方式。这样做是为了使结果不能在比对单元之外修改。该方法被一个附加参数重载，该参数声明一个辅助BIR列表，该列表能有—unitID:执行操作的BioAPI_Unit的ID;—maxFMRrequested:比对阈值；—processdBIR:待辨识的BIR;—auxiliaryBIRs:可选项，用于提高比对算法性能的辅助BIR列表；——referenceTemplate:用于验证的参考BIR;—-options:请求附加输出，例如更新的BIR和/或addtio如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见11.1说明一旦被比对结果更新(例如用户的生物特征参考自动更新的情况)unitID:执行操作的BioAPI_UintgetFMRAchieved(intunit说明unitID:执行操作的BioAPI_UBIRcreateTemplate(intunitID,BIRcapturedBIR,BIRreferenceTemplate,Vector<BIR)说明获取包含生物特征数据的BIR或BIR列表，用于创建新的注册模板。新的B构造，也可以基于现有的参考模板进行更新。如果BSP支持此功能，则表(续)—unitID:执行操作的BioAPI_Unit的ID;—capturedBIR:采集的BIR。——capturedBIRs:采集的BIR列表；—referenceTemplate:可选项，待更新的已存在的模板；——auxBIRs:可选项，辅助BIR列表。额外的BIR,可用于向模板创建操作提供信计操作更改它；——outputformat:如果BSP支持多种格式，则指定返回的已处理过的BIR使用哪种BDB格式。NULL值表示BSP要选择格式；——additionalData:BSP将要存储的additio如果输入的参数无效，格式不支持或者由于错误导致操作失败，则抛出BioAPIException,见11.1BIRprocess(intunitIDBIRprocess(intunitID,BIRcaptureBIR,Vector(说明处理采集的生物特征样本，以创建一个处理过的生物特征样本，用于使输入辅助数据处理操作得以实现。——unitID:执行操作的BioAPI_Unit的ID;—-capturedBIR:采集的BIR;——auxiliaryBIR:操作中使用的包含辅助数据的BIR;——outputformat:如果BSP支持多种格式，则指定返回的已处理的BIR使用哪种BDB格如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见11.1byteAnalyseQua说明——unitID:执行操作的BioAPI_Unit的ID;质量得分，可以是0(最低质量)到100(最高质量)之间的任何整数，如果质量算法未能提供评分，则为255如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见11.1voidcalibrate(intunitID说明—unitID:执行操作的BioAPIL_Unit的ID;——timeout:表示操作超时值的整数值(以毫秒为单位)。“-1”表示使用如果输入的参数无效，或者由于错误导致操作失败，则抛出BioAPIException,见11.1BIRcapture(intunitID,Vector<Purpo说明为指定目的采集样本，BSP返回中间类型的BIR或处理过的BIR。把目的头。如果指定了RequestAuditData选项，则可以在CaptureResult中返回原始类型的BIR。BSP负责序列化—unitID:执行操作的BioAPI_Unit的ID:—purpose:表示采集生物特征数据的目的；—biometricSubtype:表示采集的生物特征样本的子类型。NULL表示不提供子类型；——outputFormat:如果BSP支持多种格式，则指定返回的已处理过的BIR使用NULL表示BSP要选择格式：——timeout:表示操作超时值的整数值(以毫秒为单位):——resultOption:请求附加输出如果传感器设备正被占用，或者操作失败，则抛出BioAPIException,见11.1说明unitID:执行操作的BioAPI_UvoidsetIndicatorStatus(intunitID,Un说明如果BioAPI_Unit支持，则该函数将所选的BioAPI_Unit设置为所请求的指示器状态。在IndicatorStatus参数中设置Accept或Reject之后，直到应用设置另一个——unitID:执行操作的BioAPI_Unit的ID;——indicatorStatus:设置BioAPI_Unit如果出现任何错误，则抛出BioAPIException,见11.1表示生物特征识别功能供方。该接口由BFP功能和BFP支持的BioAPI_Unit的集合组成。在同一个BFP中，应只包含一个类别的BioAPI_Unit。它还可以为与BSP和组件注册表的当BSP支持相应的BioAPI_Unit时，BFP应导入以下接口之一，其次数与BSP支持的BioAPIUnit数量一样多：说明初始化BFP。初始化包括为指定的BFP注册BSP事件句柄并激活所有事件。B一个事件句柄函数来接收事件通知。许多BSP可以独立地、并发地加BSP可以建立自己的事件句柄。它们都将收到事件通知。如果一个BSP加载了多个BFP,则可以通过一次或多次调用BFPLoad,BSP可以为指定的BFP建立任意数量的事件当事件在BFP中发生时，BFP可以通过调用BSP的事件句柄向BSP发送事件通知BSP调用时。无论BSP何时接收回调，BSP开发者宜确保所有回调被BSPbfpNotifyCallback定义一个回调函数，用于向BSP通知BioAPI_EVENT类型的事件留此信息以备后续使用——bfpEventListener:定义一个回调，用于向BioAPI框架通知任—bfpGUIProgressListener:定义一个回调，用于向BioAPI框架通知任异常如果任何参数无效或者初始化过程中出现任何其他错误，则抛出BioAPIException,见byte[]controlUnit(intunitID,intcontrolCode,byte[]说明向BioAPI_Unit发送控制数据并从那里接收状态或操作数据。参数和输出的内容将在BioAPI——unitID:接收ControlUnit函数的单元的标识符；——controlCode:在BioAPI_Unit中被调用的函数编码；——inputData:包含将被发送到BioAPI_Unit的，与给定的ControlCode相关的数据的缓存区包含在处理了ControlCode所指示的函数之后，从BioAPI_Unit接收的数据函数没有分配内存区，则该值为NULL如果出现任何错误，则抛出BioAPIException,见11.1说明返回ACBioInstance。如果该单元支持ACBio,则该单元应使用最后生成的ACBio实例更新此属性。如果不支持ACBio,则应将此属性固定为NULL.注：ACBioInstance也可以作为BIR的一部分在SB字段中返回unitID:由先前操作定义的BioAPI_Unit的ID。UnitID已经填充到UnitSchemaUnitID字段中8.3.5byte[]getAuxiliaryData(intun说明unitID:由先前操作定义的BioAPI_Unit的ID。UnitID已经填充到UnitSchemaUnitID字段中辅助数据说明返回BFPSchema(BFP模式)说明该函数返回由给定的BFP管理的，并且当前处于插入状态的BioAPI_Un应只能在为指定的BFP调用BFPLoad之后调BFP中的所有单元应有定义的UnitSchema。对于给定的BioAPI_Unit,不要求该函数返回的单元ID由BSP以相同的单元ID值提供给框架。BSP可以自由的将BFP提供的任何单元ID值转化为不同的单元ID值，然后再提供给转换的目的是避免在BSP的范围内存在重复的单元ID。当BSP使用两个或更多相同类别的BFP;或者当BSP使用一个BSFP(BFP中的传感器单元),与此同时直接管理生物特征传感器时，重复可能发生UnitSchemas列表，其中每个元素描述当前会话中每个可用异常如果在BFP不再可用后调用该方法，则抛出BioAPIException,见11.1说明如果BioAPI_Unit支持，该函数将所引用的BioAPI_Un——unitID:接收ControlUnit函数的单元的标识符；——powerMode:设置的BioAPI_Unit电异常如果出现任何错误，则抛出BioAPIException,见11.1 9.3.2voidbspLoad(BSPEventListenerbspEventListener,BFPEventListenerbfpEventListener,BF-说明初始化BSP。如果没有对bspUnload()的相应调用，则对它的——bspEventListener:定义一个与BSP相关的订阅事件的回调函数；——bfpEventListener:定义一个回调函数，用于将任何正在进行的进程中的事件通知给BioAPI —bfpGUIProgressListener:定义一个回调函数，用于将任何正在进行的进程中BioAPI框架：—bfpEnumerationListener:定义一个回调函数，用于确定安装在如果任何参数无效，或者初始化过程中出现任何其他错误，则抛出BioAPIException,见11.1说明禁用事件并在应用中注销当前BSP的使用如果任何参数无效，或者初始化过程中任何其他错误，则抛出BioAPIException,见bytecheckQuality(BIRinp说明该函数对包含在输入BIR中的生物特征数据进行质量评如果指定了质量算法，并且BSP支持该算法，则应使用该算法。如果为NU用的质量算法。BSP可以通过调用BioAPI_EnumBSPs来确定支持哪些质不支持的算法，则应抛出BioAPIERR_UNSUPPORTED_ALGORITHMBio表(续)—inputBIR:包含需要评价质量的生物特征数据的BIR;-qualityAlgorithm:作为输入，表示BSP将要使用的质量算法；作为输出，表示B如果有任何错误，则抛出BioAPIException,见byte[]controlUnit(intunitID,intcontrolCode,byte[]in说明将控制数据发送给BioAPI_Unit,并从那里接收状态或操作数据。参数和输出的内容将在BioAPI——unitID:接收ControlUnit函数的单元的标识符；—controlCode:被调用的BioAPI_Unit中的函数编码；——inputData:包含要发送到BioAPI_Unit的，与给定的ControlCode相关的数据的缓存区包含在处理了ControlCode所指示的函数后，从BioAPI_Unit接收的数据的数据缓存区。如果函如果有任何错误，则抛出BioAPIException,见11.19.3.8UUIDenrol(UnitListunitList,Vector说明按照上述列表中出现的顺序，通过下列方法注册用——在该方法的第一个参数中提供用于注册的样本列表；——要求BSP中的传感器单元进行一定次数的采集。注册可以从头开始，或者通过使用referencelerenceld能够用于为新模板分配UUID。在第二种情况下，宜通过使用进行替换操作。在这种情况下，如果提供的referenceld对应的生物特征模板与新执行替换操作。否则，应抛出BioAPL.invalidUUID异常。——成功注册的结果是：给创建的生物特征参考分配的UUID,以及该生物特(可选)。BSP负责提供与注册操作相关的默认用户接口。应用可以通过BSP.subscribeToGUIEvent法提供GUI回调请求对GUI“外观”的控制。由于enrol()操作包括采集，所设备的使用。如果有两个或两个以上应用在争用该设备，则失败的应用期。这种序列化发生在所有采集数据的函数中。BSP负责序列化。它可以通过抛出异常来表明设备正忙，或者通过排队请求来实现这一点——(sensor/archive/processing)unitID:执行操作的单元ID;—numberOfPresentations:建立样本的最少图像数—numberOfAttempts:直到出现获取失败(FailuretoAcquire,FTA)错误时 —numberOfTransactions:当注册的样本在BSP内采集时，该参数决定从用户获—qualityThreshold:成功采集要求的质量阈值标准；—maxFmrRequested:成功注册要求的FMR标准(即比对阀值);—-maxFmrRequestedForUpdating:如果需要执行更新操作，该参数表示成功的重新注FMR值；—referenceld:分配的或更新的生物特征参考的UUID:—timeout:表示操作超时值的整数值(以毫秒为单位),如果达到误，并且不返回任何结果。这个值可以是任何正数。“-1”表示将使用BSP默认超时值：—capturedBIRs:用于注册的生物特征样本的BIR列表； —biometricSubtype:表示注册的生物特征子类型(例如左眼/右眼)。NULL值表示B的子类型： -outputFormat:如果BSP支持多种格式，该参数规定返回的NewTemplat式。NULL值表示BSP要选择格式：—additionalData:BSP将要存储的additionalData;的人类可识别的数据如果参数错误，或者处理过程中出现其他错误(例如不能访问数据库),则抛出BioAPI9.3.10byte[]getACBioInstance(int说明返回ACBio信息9.3.11byte[]getAddi说明unitID:先前操作定义的BioAPI_Unit的ID。UnitID已填充到UnitSchema的每个元素的字段中辅助数据说明9.3.15Vector(Candidate)identifyAggregated(UnitListunitList,Vec说明该方法提供聚合功能。它增加了Comparison(见7.3)中的Identify方法的的传感器单元直接采集生物特征样本时，或者通过以原始或处理过的格式提供输入BIR时，它允许进行辨识操作。在调用该方法之前，应先调用PresetldentifyPopulation,以便建立执行搜索的用户进一步说明请参考Comparison(7.3)中的Identify方法。BSP负责提供与注册操作相关的默认用户接口。应用程序可以通过BSP.subscribeToGUIEv()方法提供GUI回调来请求对GUI“外观”的控制。因为这个操作包括采集，所以它序列化了传感器设备的使用。如果有两个或两个以上应用在争用该设备，则失败的应用将等待操作完成或超时过期。这种序列化发生在所有采集数据的函数中。BSP负责序列化。它可明设备正忙，或者通过排队请求来实现这一点表(续)(sensor/archive/processing/comparision)unitID:执行操作的单元ID;——inputBIR:待辨识的原始的或处理过的BIR;—inputBIRs:用于执行辨识的采集的BIR列表，可以是原始的或处理过的格式；—maxFMRRequested:FMR阈值；——biometricSubtype:规定采集的子类型(例如左/右眼),NULL表示未提供该值：—-binning:指明分箱是否运行或关闭的布尔值。分箱是BSP可以采用的最优化生物特征数据的固有特性，它基于用户集的子集进行搜索。这样虽然能够提高比对操作的速度，但也增加了漏掉某些候选者的可能性(由于有分箱错误的可能性，结果可能是，搜索了一个应该包含但实际没有包含可匹配的BIR的分箱的情况);—maxResults:0表示请求所有候选者；—timeout:表示操作超时值的整数值(以毫秒为单位)。如果达到超时值，则抛可以是任何正数。“-1”表示将使用BSP默认超时值；——options:请求附加输出，例如审计数据。其余参数见Comparison(7.3)中的I如果出现任何Capture异常(7.5)或者Identify异常(7.3),则抛出BioAPIException,见11.1说明返回当前会话中BSP支持的可用的BFP的标识。注：对该函数的调用，BSP可以使用BFPEnumerationHandler回调来获取的信息，并可以通过检查回调返回的数组的每个条目创建所有支持的BFP列表，见11.2.2unitCategories:可选项，请求枚举的单元模当前BSP支持的BFP列表如果在BSP不再可用后调用此方法，或者任何其他错误，则抛出BioAPIException,见11.1说明返回当前会话中BSP可用的单元。BFP中的所有单元应有一个定义的UnitScunitCategories:可选项，请求枚举的单元模UnitSchemas列表，其每个元素描述当前会话中每个可用单如果在BSP不再可用后调用该方法，则抛出BioAPIException,见11.1说明如果BioAPIUnit支持，该函数将所引用的BioAPI_Uni——unitID:接收ControlUnit函数的单元的标识符；—powerMode:设置BioAPI_Unit电如果出现任何错误，则抛出BioAPIException,见11.1说明该方法为BSP提供Select、State和Progress事件的回调函数。如果不支事件提供NULL值。如果将三个事件都设置为NULL,则如果该方法是用先前已经分配回调函数的确定事件调用，则该方法只需简单用当前调用中提供的回调地址替换旧的回调地址—guiSelectEventListener:为SelectEvent的回调函数指定地址；—guiStateEventListener:为StateEvent的回—guiProgressEventListener:为ProgressEveBioAPIException,见11.1说明该方法清除了之前订阅的回调地址。调用该函数后，BSP应停止向框BioAPIException,见11.1说明该方法提供聚合功能。它从比对接口(见7.3)中增加了Verify方法的功行验证操作：——BSP通过调用自己的传感器单元直接采集生物特征样本。因此，不存在inp——以原始或处理过的格式提供生物特征样本；——由其UUID声明生物特征参考。因此，增加了referenceKey参数：——提供作为BIR的生物特征参考。因此，使用了referenceTemplate参数；——BSP本质上知道生物特征参考(例如单个用户、单个注册应用)。因此，调用将referenceTemplate或referenceKey。进一步的说明见Comparsion(7.3)中的Verify方法。BSP负责提供与注册操作相关的默认用户接口。应用程序可以通过BSP.subscribeToGUIEv()方法提供GUI回调来请求对GUI“外观”的控制。因为这个操作包括采集，所以它序列化了传感器设备的使用。如果有两个或两个以上应用在争用该设备，则失败的应用将过期。这种序列化发生在所有采集数据的函数中。BSP负责序列化。它可明设备正忙，或者通过排队请求来实现这一点——unitList:执行操作使用的unitListElements列表；——inputBIR:待验证的原始的或处理过的样本；——referenceKey:用于验证的生物特征参考的UUID;——referenceTemplate:与用于验证的生物特征参考相对应的BIR;—-maxFMRRequested:FMR阈值；—biometricSubtype:规定采集的子类型(例如左/右眼)。NULL值表——timeout:表示操作超时值的整数值(以毫秒为单位)。如果达到此超时值，则值可以是任何正数。“-1”表示将使用BSP默认超时值；—options:请求附加输出，例如审计数据。其他参数见Comparsion(7.3)中的如果出现任何Capture异常(7.5)或者Verify异常(7.3),则抛出BioAPIException,见11.1由于组件是由所提供的方法管理的，因此组件注册表的实现方式取决于开voidinstallBF说明在组件注册表中安装或更新对BFP的引用。该函数在BioAPI框架内部处理——bfpSchema:指定要安装或更新的BFP的信息；——update:如果为真，则执行现有BFP的更新(即，如果尚未安装此类BFP,则返回PONENT_NOT_REGISTEREDBioAPIException)。如果为假，则安装一个新B经安装了BFP,则抛出ERR_COMPONENT_ALREADY_REGISTEREDBioAPIException异常如果在安装过程中出现任何错误，则抛出BioAPIException,见11.1voidinstallBS说明在组件注册表中安装或更新对BSP的引用。该函数在BioAPI框架内部处理——bspSchema:指定要安装或更新的BSP的信息；—update:如果为真，则执行现有BSP的更新(即，如果尚未安装此类BSP,则返回PONENT_NOT_REGISTEREDBioAPIException)。如果为假，则安装一个新BSP。如果已经安装了BSP,则抛出ERR_COMPONENT_ALREADY_REGISTEREDBioAP异常如果在安装过程中出现任何错误，则抛出BioAPIException,见11.1说明该函数通过移除组件注册表中对BFP的引用来卸载BFP.异常如果出现任何错误，则抛出BioAPIException,见11.1说明该函数通过移除组件注册表中对BSP的引用来卸载BSP.异常如果出现任何错误，则抛出BioAPIException,见11.1表示生物特征识别系统。生物特征识别系统是一个层次结构系统，其根节点是框架组件。框架控及管理传感器硬件的代码。除了BSP,框架的另一部分是组件注册表，它存储关于BSP和BFP的说明对于给定的BSP,应用可以通过一次或多次调用BioAPIBSPLoad来为该BSP句柄。事件句柄由地址和上下文的组合来标当BSP中发生事件时，该BSP可以通过调用框架的事件句柄向框架发送事件通当框架接收到来自BSP的事件通知时，它应给每个应用创建的每个事件句柄发送一个通知，表明为该BSP启用了事件通知。因此，从BSP到框架的单一事件通知回调，可导致从框架到零个或多当框架接收到来自BSP的事件通知时，它应调用每个应用为该BSP所建立的全部事件句柄。如果应用建立了多个事件句柄，则应按照框架选择的顺序一次调用一个句柄，而不是同时调用事件通知可能在任何时刻发生，或者在BioAPI调用期间(与事件相关或无关BioAPI调用时。无论应用何时接收这些回调，应用开发者都宜确保所有回调能够被应用全的处理。注：这通常要求放置在事件句柄中的应用程序代码执行操作时使用线程同步技术和规创建事件句柄时会有一个“使用计数器”;通过bspUnload销毁事件句柄的次数相同。当BioAPI框架调用BSPLoad时，它从BSP接收每个类别的每个可用BioA入”事件通知。如果生物特征识别应用已经在bspLoad的调用中提供了一个事件只有当至少有一次对Init的调用且尚未进行相应的Terminate调用时，才会调用该函数除非使用installBSP安装了BSP,否则不应调用bspLoad函数。通过调用enumBSPs,能够确定已——bspID:标识要初始化的BSP; bfpGUIProgressListener:调用方提供的事件通知函数。定义了来自加载的生物供方的事件通知的回调；—bfpEnumerationListener:定义一个回调函数，用于标识安装在框架中的BFP; -context:上下文信息的对象。当所选的生物特征识别服务供方引发事件时，如果框架被终止或者出现任何其他错误，则抛出BioAPIException,见11.1说明为bspUUID标识的调用方注销事件通知回对bspUnload的调用与对bspLoad的调用类似。如果向BioAPI注册的所有回调被移除API将为该生物特征识别应用卸载通过调用bspLoad加载的BSP。BioAPI框架使用三个输入参数来唯一标识已注册的回调。对于给定的BSPUUID,仅在至少有一次对bspLoad的调用且尚未对该函数进行会调用该函数。这包括BioAPI框架在terminate调用期间隐式地执行与缺少对应的bspUnload调用相关的操作的—bsplD:标识要初始化的BSP;——context:上下文信息的对象。当所选的生物特征识别服务供方引发事件时，如果框架被终止或者出现任何其他错误，则抛出BioAPIException,见11.1voidenableEventNotifications(UU说明启用Events参数标识的，并且来自于BSPUUID标识的BSP的事件，仅对调用该函数的应用启用或禁用事件。如果有其他应用同时使用该BioAPI框架或指定的BSP,这些应用将不会受到调用enableEventNotification的影响。该函数可以在BioAPI_Init之后的任何时候调用，甚至在加载指定的BSP之前。对该函数的调用所建立的事件参数将一直有效，直到相同的BSP再次调用该函数为止。只有当至少有一次对Init的调用且尚未进行相应的Terminate调用时，才会调用该函——bspID:标识要初始化的BSP;异常如果框架已终止或者出现任何其他错误，则抛出BioAPIException,见11.1说明该函数提供组件注册表中现已安装的所有BFP的信息。只有当至少有一次对Init的调用且尚未进行相应的Terminate调用时，才会调用该函系统中可用的BFP的BFPSchema列表异常如果在框架终止后调用该方法，则抛出BioAPIException,见11.1说明该函数提供组件注册表中现已安装的所有BSP的信息。它使用所有已安只有当至少有一次对Init的调用且尚未进行相应的Terminate调用时，才会调用该函数。bspSchemas列表，其每个元素描述了生物特征识别系统中一个可用的如果在框架终止后调用该方法或出现任何其他错误时，则抛出BioAPIException,见11.1说明voidinit(Stringversio说明初始化BioAPI框架，并验证应用预期的BioAPI框架版本与系统上已有的BioAversion:与生物特征识别应用相兼容的BioAPI规BioAPIException,见11.1Vector<(BFPListElement>quer说明返回当前安装在组件注册表中，并由给定BSPUUID标识的BSP支持的Ba)确定当前所有已经安装的BFP中哪些是被BSP支持的：b)用a)中确定的BFP的标识信息(类别和UUID)填充数注：该方法调用相应的BSP.queryBFPs方法。通过调用enumBFPs并在匹配的BFPUUID上分析BFPSchemaArray,能只有在为指定的BSP调用了BSPLoad之后，才能调用该函数，而在为此BSP调用了bspUnload之bspUUID:要返回其BFP信息的B异常如果出现任何错误，则抛出BioAPIException,见11.1Vector(UnitSchema说明提供由给定BSPUUID标识的BSP直接或间接管理且当前处于插入状态(即bs有BioAPI_Unit的信息。它按顺序执行以下操作：a)确定由BSP直接或间接管理且当前处于插入状态的BioAPI_Unit的集合；b)用a)中确定的所有BioAPI_Unit的单元模式填充列表。注：该方法为引用的BSP调用BSP.querryUnit。只有在为指定的BSP调用了BSPLoad之后，才能调用该函数，而在为此BSP调用了bspUnload之BFP中的所有Unit都应定义一个UnitS异常如果出现任何错误，则抛出BioAPIException,见11.1说明异常BioAPIException,见11.1说明根据指定的错误来源和错误代码创建一个新的BioAPIException实例—source:产生错误的来源；publicBioAPIEx说明根据指定的错误来源、错误代码和要显示的消息创建一