GA/T 1326-2017 安全防范 人脸识别应用 程序接口规范

ICS13.310

A91

中华人民共和国公共安全行业标准

/—

GAT13262017

安全防范人脸识别应用

程序接口规范

ㅤㅤㅤㅤ

——

SecuritrotectionFacereconitionalications

ypgpp

APIsecifications

p

2017-10-08发布2017-12-01实施

中华人民共和国公安部发布

/—

GAT13262017

目次

前言…………………………Ⅰ

1范围………………………1

2规范性引用文件…………………………1

3术语和定义………………1

4基本数据类型……………1

5应用程序接口……………10

6接口安全策略要求………………………36

()…………………

附录A规范性附录接口返回值代码37

()……………

附录B规范性附录动态链接库文件名称40

()…………

附录C规范性附录人脸识别应用服务结构41

()…………

附录D资料性附录示例代码53

参考文献……………………62

ㅤㅤㅤㅤ

/—

GAT13262017

安全防范人脸识别应用

程序接口规范

1范围

、、

本标准规定了安全防范系统人脸识别应用程序接口方面的人脸采集人脸识别算法应用服务接口

,、

的文件格式与接口规范规范了安防人脸识别应用系统人脸采集接口人脸识别算法接口以及人脸识别

服务接口。

、、

本标准适用于安全防范系统人脸识别应用中的图像采集数据处理网络服务等接口的技术方案设

计及系统的研发与应用等方面。

2规范性引用文件

。,

下列文件对于本文件的应用是必不可少的凡是注日期的引用文件仅注日期的版本适用于本文

。,()。

件凡是不注日期的引用文件其最新版本包括所有的修改单适用于本文件

/—安防生物特征识别应用术语

GAT8932010

3术语和定义ㅤㅤㅤㅤ

3.1术语和定义

/—界定的以及下列术语和定义适用于本文件。

GAT8932010

3.1.1

人脸采集设备facecaturedevice

p

用于采集人脸图像或视频的设备。

3.1.2

名单型人脸识别dfacereconition

watchlistbaseg

。,

判别一个未知身份的待测人脸样本是否在监视名单上如果判断待测人脸样本在监视名单上则

将确定该待测人脸样本的身份。

4基本数据类型

4.1基本数据类型描述

1)

,,

基本数据类型用于规范接口传递数据过程中的数据形式采用字节对齐方式当可无效成员无

8

,、,。

效时整型类浮点数类赋值为-1指针类赋值为NULL

4.2图像数据

,。

用于传递单张图像相关信息采用结构体形式

),。,。

1在接口传递数据过程中可以不生效的数据结构成员当可无效成员无效时该成员所赋值无实际意义

1

/—

GAT13262017

C语言描述:

tedefstructtaONEIMAGE{

ypg

lonlonid;

gg

intimaewidth_;

g

intimaeheiht_;

gg

intimaedeth_;

gp

intimaewidth_;

g

intimaeheiht_;

gg

intimaedeth_;

gp

intimaewidthste_;

gp

[];

charformat20

unsinedchar*data;

g

_;

intdatalen

_;

intcustomlen

void*custom;

};

ONEIMAGE

图像数据结构体成员说明见表1。

表1图像数据类型结构体成员

成员名数据类型说明

,

id64位整型图像编号可无效

ㅤㅤㅤㅤ

_

imaewidth32位整型图像水平像素数

g

_

imaeheiht32位整型图像垂直像素数

gg

_

imaedeth32位整型图像深度

gp

_

imaewidthste32位整型存储一行像素需要的字节数

gp

format字符型数组图像格式

data无符号字符型指针图像数据段

_

datalen32位整型图像数据段长度

_,

customlen32位整型自定义数据长度可无效

,

custom无类型指针自定义数据可无效

4.3多图像数据

,。

用于传递多个图像数据采用结构体形式

C语言描述:

tedefstructtaMULTIIMAGE{

ypg

intimnum_;

g

ONEIMAGE*img;

};

MULTIIMAGE

多图像数据结构体成员说明见表2。

2

/—

GAT13262017

表2多图像数据类型结构体成员

成员名数据类型说明

_

imgnum32位整型图像数据数量

img图像数据类型指针多个图像数据

4.4人脸位置数据

,。

用于传递一个人脸位置信息采用结构体形式

C语言描述:

{

tedefstructtaFACEROI

ypg

lonlonid;

gg

intxleft;

intleft;

y

intxriht;

g

intriht;

yg

floatualit;

qy

};

FACEROI

人脸位置数据结构成员说明见表3。

表3人脸位置数据类型结构体成员

ㅤㅤㅤㅤ

成员名数据类型说明

,

id64位整型人脸位置数据编号可无效

(

人脸所在区域左上角横坐标数值以

xleft32位整型

观测者视角为标准)

yleft32位整型人脸所在区域左上角纵坐标数值

xriht32位整型人脸所在区域右下角横坐标数值

g

riht32位整型人脸所在区域右下角纵坐标数值

yg

,

人脸质量分值越高人脸质量越好

ualit32位浮点数

qy

[,],

01可无效

4.5多人脸位置数据

,。

用于传递多个人脸位置数据采用结构体形式

C语言描述:

{

tedefstructtaMULTIROI

ypg

_;

introinum

;

FACEROI*roi

};

MULTIROI

多人脸位置数据结构成员说明见表4。

3

/—

GAT13262017

表4多人脸位置数据类型结构体成员

成员名数据类型说明

_

roinum32位整型人脸位置数据数量

roi人脸位置数据类型指针多个人脸位置数据

4.6人脸关键点数据

,。

用于传递一个人脸关键点位置信息采用结构体形式

C语言描述:

tedefstructtaORGANPOS{

ypg

lonlonid;

gg

intxleft;

intleft;

y

intxriht;

g

intriht;

yg

intxchin;

intchin;

y

_;

intointlen

p

int*oint;

p

_;

intcustomlen

ㅤㅤㅤㅤ

void*custom;

};

ORGANPOS

人脸关键点数据结构成员说明见表5。

表5人脸关键点数据类型结构体成员

成员名数据类型说明

,

id64位整型人脸关键点编号可无效

xleft32位整型左眼睛中心横坐标数值

yleft32位整型左眼睛中心纵坐标数值

xriht32位整型右眼睛中心横坐标数值

g

riht32位整型右眼睛中心纵坐标数值

yg

,

xchin32位整型下颌横坐标数值可无效

,

ychin32位整型下颌纵坐标数值可无效

_

pointlen32位整型其他人脸关键点数据长度

,

其他人脸关键点数据按每个点先横

point32位整型指针

坐标后纵坐标形式顺序排列

_,

customlen32位整型自定义数据长度可无效

,

custom无类型指针自定义数据可无效

4

/—

GAT13262017

4.7多人脸关键点数据

,。

用于传递多个人脸关键点数据采用结构体形式

C语言描述:

tedefstructtaMULTIPOS{

ypg

intosnum_;

p

ORGANPOS*os;

p

};

MULTIPOS

多人脸关键点数据结构成员说明见表6。

表6多人脸关键点数据类型结构体成员

成员名数据类型说明

_

posnum32位整型人脸关键点数据数量

pos人脸关键点数据指针多个人脸关键点数据

4.8人脸模板数据

,。

人脸模板数据类型用于传递一个人脸模板信息采用结构体形式

C语言描述:

tedefstructtaFACETEMPLATE{

ypg

lonlonid;

gg

ㅤㅤㅤㅤ

_;

inthomoloid

gy

_;

intfeaturelen

void*feature;

_;

intcustomlen

void*custom;

};

FACETEMPLATE

人脸模板数据结构成员说明见表7。

表7人脸模板数据类型结构体成员

成员名数据类型说明

,,

id64位整型人员编号用于区分不同人可无效

同一身份的人对应不同模板的编号,

_

homoloid32位整型

gy

可无效

_

featurelen32位整型人脸特征长度

feature无类型指针人脸特征数据

_,

customlen32位整型自定义数据长度可无效

,

custom无类型指针自定义数据可无效

4.9人脸相似度数据

,。

用于传递一个人脸相似度信息采用结构体形式

5

/—

GAT13262017

C语言描述:

tedefstructtaFACESIM{

ypg

_;

lonlonrobeid

ggp

__;

introbehomoloid

pgy

_;

lonlonallerid

gggy

__;

intallerhomoloid

gygy

lonlonrank;

gg

floatresult;

floatrobabilit;

py

_;

intcustomlen

void*custom;

};

FACESIM

人脸相似度数据结构成员说明见表8。

表8人脸相似度数据类型结构体成员

成员名数据类型说明

_

,

probeid64位整型探针模板编号可无效

__

,

robehomoloid32位整型同一身份的人对应不同模板的编号可无效

pgy

_

,

allerid64位整型已知人员编号可无效

gy

ㅤㅤㅤㅤ

__

,

allerhomoloid32位整型同一已知人对应不同模板的编号可无效

gygy

(

相似度排名在同一多人脸相似度数据中按相

rank64位整型

),

似度降序排序的位置可无效

,:[]

result32位浮点数人脸相似度取值范围0~1

,

同一人可能性数值越高为同一人的可能性越

robabilit32位浮点数

py

,:[],

大取值范围0~1可无效

_,

customlen32位整型自定义数据长度可无效

,

custom无类型指针自定义数据可无效

4.10多人脸相似度数据

,。

用于传递多个人脸相似度数据采用结构体形式

C语言描述:

tedefstructtaMULTISIM{

ypg

lonlonid;

gg

FACESIM*sim;

lonlonsimnum_;

gg

};

MULTISIM

多人脸相似度数据结构成员说明见表9。

6

/—

GAT13262017

表9多人脸相似度数据类型结构体成员

成员名数据类型说明

,

id64位整型多人脸相似度数据编号可无效

sim人脸相似度数据指针多个人脸相似度数据

_

simnum64位整型人脸相似度数据数量

4.11算法模块版本信息数据

,。

用于传递人脸识别算法模块版本信息数据采用结构体形式

C语言描述:

tedefstructtaSDKINFO{

ypg

intmodulete_;

yp

intaite_;

pyp

_[];

chardeveloerinfo255

p

_[];

charversioninfo255

};

SDKINFO

算法模块版本信息数据结构成员说明见表10。

表10算法模块版本信息数据类型结构体成员

ㅤㅤㅤㅤ

成员名数据类型说明

,,,

人脸识别算法模块支持的功能采用标志位形式1为有效0为

。;

无效从右向左依次为人脸检测接口标志位独立人脸关键点定

;,

位接口标志位集成人脸关键点定位接口标志位独立人脸归一

_

位整型,;

modulete32化接口标志位集成人脸归一化接口标志位独立人脸模板提取

yp

;;

接口标志位集成人脸模板提取接口标志位独立人脸相似度计

;,

算接口标志位集成人脸相似度计算接口标志位用户可据此规

则自行扩展

,,,。

人脸识别应用类型采用标志位形式为有效为无效从右

10

、、

向左依次为辨认型人脸识别标志位确认型人脸识别标志位名

_

aite32位整型

pyp

,

单型人脸识别标志位每种类型占用一位用户可据此规则自行

扩展

_()

develoerinfo字符型数组开发商信息无则赋零

p

_()

versioninfo字符型数组版本信息无则赋零

4.12网络地址信息数据

,。

用于传递网络地址信息数据采用结构体形式

C语言描述:

tedefstructtaADDRINFO{

ypg

7

/—

GAT13262017

_;

intite

pyp

[];

chari64

p

shortort;

p

};

ADDRINFO

网络地址信息数据结构成员说明见表11。

表11网络地址信息数据类型结构体成员

成员名数据类型说明

,:;:

_

ite32位整型IP协议类型0iv41iv6

pyppp

()

i字符型数组IP地址无则赋零

p

port16位整型端口号

4.13人脸采集设备信息数据

,。

用于传递人脸采集设备的信息数据采用结构体形式

C语言描述:

tedefstructtaDEVICEINFO{

ypg

_[];

chardevicename128

_[];

unsinedcharserialnumber48

g

_;ㅤㅤㅤㅤ

ADDRINFOaddrinfo

shortdevicete_;

yp

intworkmode_;

lonlonchannum_;

gg

[];

chardescrition256

p

};

DEVICEINFO

人脸采集设备信息数据结构成员说明见表12。

表12人脸采集设备信息数据类型结构体成员

成员名数据类型说明

_(,)

devicename字符型数组设备名称节点路径无则赋零

_