人工智能 音視頻及圖像分析算法接口

ICS35.240

L77

中華人民共和國國家標(biāo)準(zhǔn)

GB/TXXXXX—XXXX

人工智能音視頻及圖像分析算法接口

Artificialintelligence-Audio,videoandimageanalysisalgorithminterface

點(diǎn)擊此處添加與國際標(biāo)準(zhǔn)一致性程度的標(biāo)識(shí)

文稿版次選擇

XXXX-XX-XX發(fā)布XXXX-XX-XX實(shí)施

GB/TXXXXX—XXXX

前??言

本文件按照GB/T1.1-2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》給出的規(guī)

則起草。

請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別這些專利的責(zé)任。

本文件由提出并歸口。

本文件起草單位：

本文件主要起草人：

II

GB/TXXXXX—XXXX

人工智能音視頻及圖像分析算法接口

1范圍

本文件規(guī)定了音視頻與圖像分析算法接口，涵蓋了解析算法和比對(duì)算法在算法包和算法服務(wù)形式下

的接口規(guī)范，包括接口的應(yīng)用環(huán)境、數(shù)據(jù)格式定義和接口交互過程等。

本文件適用于音視頻與圖像的分析算法的接入與應(yīng)用，也可用于指導(dǎo)智能應(yīng)用系統(tǒng)與算法包、算法

服務(wù)的系統(tǒng)集成與開發(fā)。

2術(shù)語和定義

下列術(shù)語和定義適用于本文件。

2.1

算法包algorithmpackage

實(shí)現(xiàn)對(duì)音視頻、圖像數(shù)據(jù)進(jìn)行解析以及比對(duì)等功能的一系列算法庫的集合。

2.2

算法服務(wù)algorithmservice

基于音視頻及圖像分析算法，提供對(duì)媒體數(shù)據(jù)解析和特征比對(duì)功能的網(wǎng)絡(luò)服務(wù)。

2.3

算法引擎algorithmengine

算法包及其基礎(chǔ)運(yùn)行環(huán)境（取流、解碼、API調(diào)用、結(jié)果處理等過程）的完整框架。

2.4

特征feature

從音視頻及圖像樣本中提取出的、用于代表該樣本的特定的物理量。

2.5

特征相似度featuresimilarity

表示兩個(gè)特征之間的相似性，數(shù)值越大表示相似性越高。

3縮略語

下列縮略語適用于本文件。

API:應(yīng)用程序編程接口(ApplicationProgrammingInterface)

1

GB/TXXXXX—XXXX

CPU:中央處理器（CentralProcessingUnit）

GPU:圖形處理器（GraphicsProcessingUnit）

HTTP:超文本傳輸協(xié)議（HyperTextTransferProtocol）

HTTPS:安全的超文本傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）

JSON:JavaScript對(duì)象標(biāo)記語言（JavaScriptObjectNotation）

NPU:嵌入式神經(jīng)網(wǎng)絡(luò)處理器（Neural-networkProcessingUnit）

PCM:脈沖編碼調(diào)制（PulseCodeModulation)

REST:表述性狀態(tài)轉(zhuǎn)移（RepresentationalStateTransfer）

URI:全局資源標(biāo)識(shí)符（UniversalResourceIdentifier）

4應(yīng)用環(huán)境和接口分類

4.1應(yīng)用環(huán)境

音視頻及圖像分析算法接口涉及的內(nèi)容包括算法包接口和算法服務(wù)接口。根據(jù)功能不同，算法包分

為解析算法包和比對(duì)算法包，算法服務(wù)分為解析算法服務(wù)和比對(duì)算法服務(wù)。算法包和算法服務(wù)的應(yīng)用環(huán)

境見圖1。

圖1音視頻及圖像分析接口應(yīng)用環(huán)境示意圖

應(yīng)用環(huán)境的功能如下：

a)智能應(yīng)用系統(tǒng)提供面向用戶與業(yè)務(wù)的功能集合；

b)解析分析提供對(duì)圖像、音視頻等媒體數(shù)據(jù)的檢測(cè)、分類、特征提取等功能，實(shí)現(xiàn)方式為算法引

擎和算法服務(wù)。解析算法引擎包含解析算法包以及基礎(chǔ)環(huán)境（包括取流、解碼、API調(diào)用、結(jié)

果處理等功能）；

2

GB/TXXXXX—XXXX

c)比對(duì)分析提供特征比對(duì)、檢索等功能，實(shí)現(xiàn)方式為算法引擎和算法服務(wù)。比對(duì)算法引擎包含比

對(duì)算法包以及基礎(chǔ)環(huán)境（包括API調(diào)用、結(jié)果處理等功能）；

d)智能應(yīng)用系統(tǒng)可根據(jù)實(shí)際情況通過算法引擎或者算法服務(wù)的形式調(diào)用解析分析算法，分析結(jié)果

統(tǒng)一保存到存儲(chǔ)服務(wù)；比對(duì)分析算法從存儲(chǔ)服務(wù)中獲取特征數(shù)據(jù)集合，實(shí)現(xiàn)智能應(yīng)用系統(tǒng)指定

的比對(duì)邏輯。

4.2接口分類

按照分析算法功能和實(shí)現(xiàn)方式進(jìn)行分類，具體如下：

a)解析算法包接口，用于解析算法引擎的應(yīng)用邏輯對(duì)算法功能的調(diào)用；

b)比對(duì)算法包接口，用于比對(duì)算法引擎的應(yīng)用邏輯對(duì)算法功能的調(diào)用；

c)解析算法服務(wù)接口，用于智能應(yīng)用系統(tǒng)與解析分析之間的服務(wù)調(diào)用；

d)比對(duì)算法服務(wù)接口，用于智能應(yīng)用系統(tǒng)與比對(duì)分析之間的服務(wù)調(diào)用。

5算法包接口

5.1接口概述

5.1.1解析算法包接口

解析算法包接口環(huán)境見圖2。

圖2解析算法包接口環(huán)境示意圖

智能應(yīng)用系統(tǒng)向算法引擎推送任務(wù)配置信息，算法引擎的基礎(chǔ)環(huán)境模塊根據(jù)任務(wù)配置獲取音視頻、

圖像等媒體數(shù)據(jù)，與配置信息一起通過算法包接口推送到算法包分析，分析結(jié)果由基礎(chǔ)環(huán)境模塊輸出到

存儲(chǔ)服務(wù)。

5.1.2比對(duì)算法包接口

比對(duì)算法包接口環(huán)境見圖3。算法引擎通過該接口向算法包提供其必要的運(yùn)行環(huán)境支持和數(shù)據(jù)交互

支持。比對(duì)算法包提供對(duì)1:1、M:N等基礎(chǔ)比對(duì)邏輯，以及檢索比對(duì)、比對(duì)加速等高階比對(duì)功能的接口

支持。

3

GB/TXXXXX—XXXX

圖3比對(duì)算法包應(yīng)用環(huán)境示意圖

智能應(yīng)用系統(tǒng)向算法引擎推送比對(duì)規(guī)則與配置信息，算法引擎的基礎(chǔ)環(huán)境模塊根據(jù)配置從存儲(chǔ)服務(wù)

中獲取特征數(shù)據(jù)集合，與比對(duì)規(guī)則一起通過算法包接口推送到算法包。比對(duì)完成后，再通過基礎(chǔ)環(huán)境將

比對(duì)結(jié)果輸出給智能應(yīng)用系統(tǒng)。

5.2接口要求

算法包接口應(yīng)滿足以下要求：

a)接口函數(shù)應(yīng)開放給用戶開發(fā)；

b)函數(shù)可采用動(dòng)態(tài)鏈接庫形式發(fā)布，并于動(dòng)態(tài)鏈接庫中導(dǎo)出；對(duì)于不同的平臺(tái)，應(yīng)分別編譯成不

同的動(dòng)態(tài)鏈接庫發(fā)布；

c)單個(gè)算法句柄僅支持單線程串行調(diào)用；

d)算法包接口可用多種語言進(jìn)行實(shí)現(xiàn)，數(shù)據(jù)類型和函數(shù)參數(shù)實(shí)現(xiàn)應(yīng)符合相應(yīng)的編程規(guī)范和準(zhǔn)則。

C語言示例見附錄A與附錄B；

e)算法包接口描述見5.4、5.5。

5.3數(shù)據(jù)類型

5.3.1媒體數(shù)據(jù)類型

用于傳遞媒體數(shù)據(jù)類型信息，采用枚舉形式。

媒體數(shù)據(jù)類型枚舉成員說明見表1。

表1媒體數(shù)據(jù)類型枚舉成員說明表

數(shù)據(jù)類型枚舉成員列表

音視頻流

媒體數(shù)據(jù)類型

圖像

5.3.2分析幀類型

4

GB/TXXXXX—XXXX

用于傳遞幀數(shù)據(jù)類型信息，采用枚舉形式。

分析幀類型枚舉成員說明見表2。

表2分析幀類型枚舉成員說明表

數(shù)據(jù)類型枚舉成員列表

視頻幀/圖像

分析幀類型

音頻幀

5.3.3音視頻格式類型

用于描述音視頻格式類型信息，支持以下格式：

a)音視頻流編碼格式應(yīng)符合GB/T28181-2016的相關(guān)要求；

b)宜支持H.265視頻編碼格式；

c)應(yīng)支持灰度、YV12、I420、NV12、NV21、BGR、BGRA等無編碼視頻格式及PCM無編碼音頻格式。

5.3.4圖像格式類型

用于描述圖像格式類型信息，支持以下格式：

a)應(yīng)支持JPEG、JPEG2000、BMP、PNG等編碼格式的圖像；

b)應(yīng)支持灰度、YV12、I420、NV12、NV21、BGR、BGRA等無編碼格式的圖像。

5.3.5算法授權(quán)格式

用于描述算法授權(quán)格式，采用結(jié)構(gòu)化形式。

算法授權(quán)格式結(jié)構(gòu)主要成員說明見表3。

表3算法授權(quán)格式結(jié)構(gòu)主要成員說明表

數(shù)據(jù)類型結(jié)構(gòu)主要成員列表必選/可選取值說明

支持不授權(quán)、本地授權(quán)、中心授權(quán)等多種

授權(quán)類型必選

授權(quán)方式

授權(quán)類型為“不授權(quán)”時(shí)，此項(xiàng)可不填；

算法授權(quán)格式本地授權(quán)時(shí)，該項(xiàng)可取值為本地License

授權(quán)路徑條件必選路徑或者USBPort號(hào)；

中心授權(quán)時(shí)，該項(xiàng)可取值為授權(quán)服務(wù)遠(yuǎn)端

地址

5.3.6系統(tǒng)資源描述格式

用于描述系統(tǒng)資源信息，采用結(jié)構(gòu)化形式。

系統(tǒng)資源描述格式結(jié)構(gòu)主要成員說明見表4。

5

GB/TXXXXX—XXXX

表4系統(tǒng)資源描述格式結(jié)構(gòu)主要成員說明表

數(shù)據(jù)類型結(jié)構(gòu)主要成員列表必選/可選取值說明

對(duì)未開啟超線程的CPU，取值為CPU實(shí)際核

心數(shù)；對(duì)開啟超線程的CPU，取值為模擬

CPU核數(shù)必選

核心數(shù)；對(duì)多路CPU，取值為所有CPU的核

心數(shù)之和

CPU主頻必選單位：兆赫茲（MHz）

系統(tǒng)資源描述格式

可用內(nèi)存必選單位：兆字節(jié)（MB）

若存在算法關(guān)聯(lián)資源（如模型文件），應(yīng)

算法關(guān)聯(lián)資源信息可選

描述其信息（如存放地址）

若存在協(xié)處理器（如GPU、NPU等），應(yīng)描

協(xié)處理器信息可選

述相關(guān)信息

5.3.7視頻和圖像輸入格式

用于傳遞視頻和圖像輸入信息，采用結(jié)構(gòu)化形式。

視頻和圖像輸入格式結(jié)構(gòu)主要成員說明見表5。

表5視頻和圖像輸入格式結(jié)構(gòu)主要成員說明表

數(shù)據(jù)類型結(jié)構(gòu)主要成員列表必選/可選取值說明

格式類型必選見5.3.3和5.3.4

一幀完整的無編碼視頻/圖像數(shù)據(jù)、或一

輸入數(shù)據(jù)必選張完整的靜態(tài)圖像數(shù)據(jù)、或一段流式視頻

數(shù)據(jù)

寬度條件必選輸入無編碼視頻/圖像數(shù)據(jù)時(shí)必填

視頻和圖像輸入格式高度條件必選輸入無編碼視頻/圖像數(shù)據(jù)時(shí)必填

輸入無編碼視頻數(shù)據(jù)時(shí)選填，圖像分析時(shí)

幀率可選

該參數(shù)不生效

時(shí)間信息可選包含年、月、日、時(shí)、分、秒、毫秒

自定義數(shù)據(jù)描述信息，在數(shù)據(jù)回調(diào)中透?jìng)?/p>

數(shù)據(jù)描述信息可選

出來

5.3.8音頻輸入格式

用于傳遞音頻輸入信息，采用結(jié)構(gòu)化形式。

音頻輸入格式結(jié)構(gòu)主要成員說明見表6。

6

GB/TXXXXX—XXXX

表6音頻輸入格式結(jié)構(gòu)主要成員說明表

數(shù)據(jù)類型結(jié)構(gòu)主要成員列表必選/可選取值說明

格式類型必選見5.3.3

輸入數(shù)據(jù)必選一幀完整的音頻數(shù)據(jù)

采樣率必選每秒鐘采樣多少次，單位：赫茲(Hz)

位深度必選每個(gè)采樣點(diǎn)的bit數(shù)

字節(jié)序必選大端存儲(chǔ)、小端存儲(chǔ)

音頻輸入格式

聲道數(shù)必選音頻聲道數(shù)

數(shù)據(jù)類型必選有符號(hào)整數(shù)、無符號(hào)整數(shù)、浮點(diǎn)數(shù)

時(shí)間信息可選包含年、月、日、時(shí)、分、秒、毫秒

自定義數(shù)據(jù)描述信息，在數(shù)據(jù)回調(diào)中透?jìng)?/p>

數(shù)據(jù)描述信息可選

出來

5.3.9回調(diào)函數(shù)類型

用于傳遞回調(diào)函數(shù)類型信息，采用枚舉形式。

回調(diào)函數(shù)類型的枚舉成員說明見表7。

表7回調(diào)函數(shù)類型枚舉成員說明表

數(shù)據(jù)類型枚舉成員列表

日志回調(diào)

回調(diào)函數(shù)類型

數(shù)據(jù)回調(diào)

5.3.10特征數(shù)據(jù)格式

用于傳遞特征信息，采用結(jié)構(gòu)化形式。

特征數(shù)據(jù)格式結(jié)構(gòu)成員說明見表8。

表8特征數(shù)據(jù)格式結(jié)構(gòu)成員說明表

數(shù)據(jù)類型結(jié)構(gòu)成員列表取值說明

特征數(shù)據(jù)格式特征數(shù)據(jù)二進(jìn)制特征數(shù)據(jù)

5.3.11檢索結(jié)果數(shù)據(jù)格式

用于傳遞檢索比對(duì)結(jié)果，采用結(jié)構(gòu)化形式。

檢索結(jié)果數(shù)據(jù)格式結(jié)構(gòu)成員說明見表9。

表9檢索結(jié)果數(shù)據(jù)格式結(jié)構(gòu)成員說明表

數(shù)據(jù)類型結(jié)構(gòu)成員列表取值說明

特征標(biāo)識(shí)

檢索結(jié)果數(shù)據(jù)格式

特征相似度取值范圍[0,1]

5.4解析算法包接口函數(shù)

5.4.1解析算法包接口函數(shù)列表

7

GB/TXXXXX—XXXX

解析算法包接口函數(shù)列表見表10。

表10解析算法包接口函數(shù)列表

接口函數(shù)章條號(hào)

算法初始化函數(shù)

算法授權(quán)函數(shù)

算法句柄創(chuàng)建函數(shù)

算法句柄銷毀函數(shù)

同步分析函數(shù)

異步分析數(shù)據(jù)輸入函數(shù)

設(shè)置回調(diào)函數(shù)

數(shù)據(jù)回調(diào)函數(shù)

日志回調(diào)函數(shù)

參數(shù)配置函數(shù)0

獲取參數(shù)配置函數(shù)1

算法版本號(hào)獲取函數(shù)2

算法資源釋放函數(shù)3

5.4.2解析算法包接口函數(shù)

算法初始化函數(shù)

用于初始化算法的函數(shù)，調(diào)用參數(shù)見表11。

在算法操作前，首先調(diào)用初始化函數(shù)。

表11算法初始化函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

系統(tǒng)資源信息輸入?yún)?shù)見5.3.6

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

算法授權(quán)函數(shù)

用于設(shè)置算法授權(quán)信息的函數(shù)，調(diào)用參數(shù)見表12。

表12算法授權(quán)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法授權(quán)信息輸入?yún)?shù)見5.3.5

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

算法句柄創(chuàng)建函數(shù)

用于創(chuàng)建算法句柄的函數(shù)，調(diào)用參數(shù)見表13。

一個(gè)算法包可創(chuàng)建多個(gè)句柄。創(chuàng)建時(shí)，算法包根據(jù)初始化時(shí)傳入的系統(tǒng)資源信息，判斷是否有足夠

的剩余資源。

8

GB/TXXXXX—XXXX

表13算法句柄創(chuàng)建函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸出參數(shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

媒體數(shù)據(jù)類型輸入?yún)?shù)見5.3.1

創(chuàng)建句柄攜帶參數(shù)輸入?yún)?shù)自定義類型參數(shù)，無參數(shù)時(shí)可為空

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

算法句柄銷毀函數(shù)

用于銷毀算法分析句柄的函數(shù)，調(diào)用參數(shù)見表14。

表14算法分析句柄銷毀函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法分析句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

同步分析函數(shù)

用于同步方式下算法分析的函數(shù)，調(diào)用參數(shù)見表15。

同步分析的分析結(jié)果由該函數(shù)中的輸出參數(shù)傳出。

表15同步分析函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法分析句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

分析幀信息輸入?yún)?shù)圖像或音頻信息，見5.3.7、5.3.8

規(guī)則信息輸入?yún)?shù)自定義類型算法分析規(guī)則

分析結(jié)果輸出參數(shù)自定義類型算法分析結(jié)果

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

異步分析數(shù)據(jù)輸入函數(shù)

用于異步方式下輸入待分析數(shù)據(jù)的函數(shù)，調(diào)用參數(shù)見表16。

異步分析的分析結(jié)果由數(shù)據(jù)回調(diào)函數(shù)傳出。

表16異步分析數(shù)據(jù)輸入函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法分析句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

分析幀信息輸入?yún)?shù)圖像或音頻信息，見5.3.7、5.3.8

規(guī)則信息輸入?yún)?shù)自定義類型算法分析規(guī)則，無參數(shù)時(shí)可為空。

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

設(shè)置回調(diào)函數(shù)

9

GB/TXXXXX—XXXX

用于設(shè)置回調(diào)的函數(shù)，調(diào)用參數(shù)見表17。

表17設(shè)置回調(diào)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象，設(shè)置日志回調(diào)

算法分析句柄輸入?yún)?shù)

時(shí)可為空

回調(diào)類型輸入?yún)?shù)見5.3.9

回調(diào)函數(shù)輸入?yún)?shù)回調(diào)函數(shù)對(duì)象

回調(diào)函數(shù)透?jìng)餍畔⑤斎雲(yún)?shù)透?jìng)鞯交卣{(diào)函數(shù)中的自定義信息

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

數(shù)據(jù)回調(diào)函數(shù)

用于獲取分析結(jié)果數(shù)據(jù)的函數(shù)，調(diào)用參數(shù)見表18。

表18數(shù)據(jù)回調(diào)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

描述信息輸入?yún)?shù)與音視頻和圖像輸入格式對(duì)應(yīng)的數(shù)據(jù)描述信息

分析幀類型輸入?yún)?shù)見5.3.2

算法分析結(jié)果輸入?yún)?shù)自定義類型算法分析結(jié)果

透?jìng)餍畔⑤斎雲(yún)?shù)與設(shè)置回調(diào)函數(shù)對(duì)應(yīng)的透?jìng)餍畔?/p>

函數(shù)返回值：無。

日志回調(diào)函數(shù)

用于獲取算法運(yùn)行日志的函數(shù)，調(diào)用參數(shù)見表19。

表19日志回調(diào)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

重要性等級(jí)輸入?yún)?shù)表示當(dāng)前狀態(tài)的重要性，數(shù)值越大重要性越高

日志信息輸入?yún)?shù)狀態(tài)詳細(xì)描述信息，字符串形式

透?jìng)餍畔⑤斎雲(yún)?shù)與設(shè)置回調(diào)函數(shù)對(duì)應(yīng)的透?jìng)餍畔?/p>

函數(shù)返回值：無。

0參數(shù)配置函數(shù)

用于配置參數(shù)的函數(shù)，調(diào)用參數(shù)見表20。

表20參數(shù)配置函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法分析句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

參數(shù)信息輸入?yún)?shù)自定義的參數(shù)信息

10

GB/TXXXXX—XXXX

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

1獲取參數(shù)配置函數(shù)

用于獲取配置參數(shù)的函數(shù)，調(diào)用參數(shù)見表21。

表21獲取參數(shù)配置函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法分析句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的自定義類型

參數(shù)信息輸出參數(shù)自定義參數(shù)信息

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

2算法版本號(hào)獲取函數(shù)

用于獲取算法版本號(hào)的函數(shù)，調(diào)用參數(shù)見表22。

表22算法版本號(hào)獲取函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

版本信息輸出參數(shù)自定義算法版本信息內(nèi)容

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

3算法資源釋放函數(shù)

用于釋放算法相關(guān)資源的函數(shù)。

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

5.4.3算法包輸出結(jié)果

算法包輸出應(yīng)符合所在系統(tǒng)的數(shù)據(jù)格式規(guī)范。

5.5比對(duì)算法包接口函數(shù)

5.5.1比對(duì)算法包接口函數(shù)列表

比對(duì)算法包接口函數(shù)列表見表23。

11

GB/TXXXXX—XXXX

表23比對(duì)算法包接口函數(shù)列表

說明章條號(hào)

算法初始化函數(shù)

算法授權(quán)函數(shù)

算法句柄創(chuàng)建函數(shù)

算法句柄銷毀函數(shù)

設(shè)置回調(diào)函數(shù)

日志回調(diào)函數(shù)

特征數(shù)據(jù)校驗(yàn)函數(shù)

1:1比對(duì)函數(shù)

M:N比對(duì)函數(shù)

添加特征數(shù)據(jù)函數(shù)0

刪除特征數(shù)據(jù)函數(shù)1

查詢特征數(shù)量函數(shù)2

檢索比對(duì)函數(shù)3

算法版本號(hào)獲取函數(shù)4

算法資源釋放函數(shù)5

5.5.2比對(duì)接口函數(shù)

算法初始化函數(shù)

用于初始化比對(duì)算法的函數(shù)，調(diào)用參數(shù)見表24。

在算法操作前，首先調(diào)用初始化函數(shù)。

表24算法初始化函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

系統(tǒng)資源信息輸入?yún)?shù)見5.3.6

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

算法授權(quán)函數(shù)

用于設(shè)置算法授權(quán)信息的函數(shù)，調(diào)用參數(shù)見表25。

表25算法授權(quán)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法授權(quán)信息輸入?yún)?shù)算法授權(quán)信息，見5.3.5

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

算法句柄創(chuàng)建函數(shù)

用于創(chuàng)建算法分析句柄的函數(shù)，調(diào)用參數(shù)見表26。

一個(gè)算法包可創(chuàng)建多個(gè)句柄。創(chuàng)建時(shí)，算法包根據(jù)初始化時(shí)傳入的系統(tǒng)資源信息，判斷是否有足夠

12

GB/TXXXXX—XXXX

的剩余資源。

表26算法句柄創(chuàng)建函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸出參數(shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

創(chuàng)建句柄攜帶參數(shù)輸入?yún)?shù)自定義類型參數(shù)

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

算法句柄銷毀函數(shù)

用于銷毀算法分析句柄的函數(shù)，調(diào)用參數(shù)見表27。

表27算法句柄銷毀函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的自定義類型

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

設(shè)置回調(diào)函數(shù)

用于設(shè)置回調(diào)的函數(shù)，調(diào)用參數(shù)見表28。

比對(duì)算法包僅支持設(shè)置日志回調(diào)函數(shù)。

表28設(shè)置回調(diào)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象，設(shè)置日志回調(diào)

算法分析句柄輸入?yún)?shù)

時(shí)可為空

回調(diào)類型輸入?yún)?shù)見5.3.9

回調(diào)函數(shù)輸入?yún)?shù)回調(diào)函數(shù)對(duì)象

回調(diào)函數(shù)透?jìng)餍畔⑤斎雲(yún)?shù)透?jìng)鞯交卣{(diào)函數(shù)中的自定義信息

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

日志回調(diào)函數(shù)

用于獲取算法運(yùn)行日志的函數(shù)，調(diào)用參數(shù)見表29。

表29日志回調(diào)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

重要性等級(jí)輸入?yún)?shù)表示當(dāng)前狀態(tài)的重要性，數(shù)值越大重要性越高

日志信息輸入?yún)?shù)狀態(tài)詳細(xì)描述信息，字符串形式

透?jìng)餍畔⑤斎雲(yún)?shù)與設(shè)置回調(diào)函數(shù)對(duì)應(yīng)的透?jìng)餍畔?/p>

函數(shù)返回值：無。

特征數(shù)據(jù)校驗(yàn)函數(shù)

13

GB/TXXXXX—XXXX

用于校驗(yàn)特征數(shù)據(jù)的合法性，便于上層進(jìn)行異常規(guī)避，調(diào)用參數(shù)見表30。

表30特征數(shù)據(jù)校驗(yàn)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

特征集合輸入?yún)?shù)待校驗(yàn)特性集合，單個(gè)特征數(shù)據(jù)類型見5.3.10

函數(shù)返回值：校驗(yàn)成功，返回0；校驗(yàn)失敗，返回非0。

1:1比對(duì)函數(shù)

用于對(duì)輸入的兩個(gè)特征進(jìn)行相似度計(jì)算的函數(shù)，調(diào)用參數(shù)見表31。

表311:1比對(duì)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

第一個(gè)特征輸入?yún)?shù)見5.3.10

第二個(gè)特征輸入?yún)?shù)見5.3.10

特征相似度輸出參數(shù)兩個(gè)特征的比對(duì)相似度，值域范圍[0,1]

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

M:N比對(duì)函數(shù)

用于輸入的M個(gè)特征與基礎(chǔ)N個(gè)特征進(jìn)行相似度計(jì)算的函數(shù)，調(diào)用參數(shù)見表32。

表32M:N比對(duì)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

待比對(duì)特征集合輸入?yún)?shù)單個(gè)特征數(shù)據(jù)類型見5.3.10

基礎(chǔ)特征集合輸入?yún)?shù)單個(gè)特征數(shù)據(jù)類型見5.3.10

返回值是一個(gè)矩陣，第i行j列的值對(duì)應(yīng)待比對(duì)特

特征相似度結(jié)果集合輸出參數(shù)征的第i個(gè)元素和基礎(chǔ)特征的第j個(gè)元素的特征

相似度，每個(gè)相似度結(jié)果的值域范圍[0,1]

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

0添加特征數(shù)據(jù)函數(shù)

用于添加特征數(shù)據(jù)的函數(shù)，調(diào)用參數(shù)見表33。

表33添加特征數(shù)據(jù)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的自定義類型

支持一次調(diào)用添加多個(gè)特征，單個(gè)特征數(shù)據(jù)類型

待添加的特征集合輸入?yún)?shù)

見5.3.10

14

GB/TXXXXX—XXXX

輸出每個(gè)特征的標(biāo)識(shí)，與添加集合中特征位置一

特征標(biāo)識(shí)集合輸出參數(shù)

一對(duì)應(yīng)，調(diào)用前需要分配好內(nèi)存，不能傳空指針

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

1刪除特征數(shù)據(jù)函數(shù)

用于刪除特征數(shù)據(jù)的函數(shù)，調(diào)用參數(shù)見表34。

表34刪除特征數(shù)據(jù)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的自定義類型

待刪除的特征標(biāo)識(shí)集合輸入?yún)?shù)支持一次調(diào)用刪除多個(gè)特征

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

2查詢特征數(shù)量函數(shù)

用于查詢指定句柄中特征數(shù)量的函數(shù)，調(diào)用參數(shù)見表35。

表35查詢特征數(shù)量函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的對(duì)象

特征數(shù)量輸出參數(shù)整型值，已加載的特征數(shù)量

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

3檢索比對(duì)函數(shù)

用于對(duì)輸入的待檢索特征集合進(jìn)行比對(duì)和相似度排序計(jì)算的函數(shù)，調(diào)用參數(shù)見表36。

表36檢索比對(duì)函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

算法句柄輸入?yún)?shù)用于標(biāo)識(shí)一個(gè)算法上下文的自定義類型

待比對(duì)特征集合輸入?yún)?shù)單個(gè)特征數(shù)據(jù)類型見5.3.10

檢索過濾條件內(nèi)容輸入?yún)?shù)自定義類型檢索條件

整形值，檢索返回的結(jié)果數(shù)量上限，結(jié)果按相似

結(jié)果返回?cái)?shù)量上限輸入?yún)?shù)

度值從高至低排序

返回值是一個(gè)二維矩陣，矩陣第i行與待比對(duì)特

征集合中第i個(gè)特征對(duì)應(yīng)，表示該特征的檢索結(jié)

檢索結(jié)果內(nèi)容輸出參數(shù)

果列表，結(jié)果按照相似度從高到低排列

單個(gè)檢索結(jié)果數(shù)據(jù)類型見5.3.11

檢索結(jié)果數(shù)量輸出參數(shù)待檢索特征實(shí)際輸出的檢索結(jié)果數(shù)量

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

4算法版本號(hào)獲取函數(shù)

15

GB/TXXXXX—XXXX

用于獲取算法版本號(hào)的函數(shù)，調(diào)用參數(shù)見表37。

表37算法版本號(hào)獲取函數(shù)參數(shù)列表

參數(shù)輸入/輸出類型參數(shù)說明

版本信息內(nèi)容輸出參數(shù)自定義算法版本信息內(nèi)容

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

5算法資源釋放函數(shù)

用于釋放算法相關(guān)資源的函數(shù)。

函數(shù)返回值：調(diào)用成功，返回0；調(diào)用失敗，返回非0。

6算法服務(wù)接口

6.1接口概述

算法服務(wù)接口環(huán)境見圖4。智能應(yīng)用系統(tǒng)通過該接口實(shí)現(xiàn)對(duì)算法服務(wù)的調(diào)用維護(hù)。