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

ICS35.240

L77

中華人民共和國國家標準

GB/TXXXXX—XXXX

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

Artificialintelligence-Audio,videoandimageanalysisalgorithminterface

點擊此處添加與國際標準一致性程度的標識

文稿版次選擇

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

GB/TXXXXX—XXXX

前??言

本文件按照GB/T1.1-2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》給出的規(guī)

則起草。

請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別這些專利的責任。

本文件由提出并歸口。

本文件起草單位：

本文件主要起草人：

II

GB/TXXXXX—XXXX

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

1范圍

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

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

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

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

2術語和定義

下列術語和定義適用于本文件。

2.1

算法包algorithmpackage

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

2.2

算法服務algorithmservice

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

2.3

算法引擎algorithmengine

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

2.4

特征feature

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

2.5

特征相似度featuresimilarity

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

3縮略語

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

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

1

GB/TXXXXX—XXXX

CPU:中央處理器（CentralProcessingUnit）

GPU:圖形處理器（GraphicsProcessingUnit）

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

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

JSON:JavaScript對象標記語言（JavaScriptObjectNotation）

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

PCM:脈沖編碼調制（PulseCodeModulation)

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

URI:全局資源標識符（UniversalResourceIdentifier）

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

4.1應用環(huán)境

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

為解析算法包和比對算法包，算法服務分為解析算法服務和比對算法服務。算法包和算法服務的應用環(huán)

境見圖1。

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

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

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

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

擎和算法服務。解析算法引擎包含解析算法包以及基礎環(huán)境（包括取流、解碼、API調用、結

果處理等功能）；

2

GB/TXXXXX—XXXX

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

對算法包以及基礎環(huán)境（包括API調用、結果處理等功能）；

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

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

的比對邏輯。

4.2接口分類

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

a)解析算法包接口，用于解析算法引擎的應用邏輯對算法功能的調用；

b)比對算法包接口，用于比對算法引擎的應用邏輯對算法功能的調用；

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

d)比對算法服務接口，用于智能應用系統(tǒng)與比對分析之間的服務調用。

5算法包接口

5.1接口概述

5.1.1解析算法包接口

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

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

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

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

存儲服務。

5.1.2比對算法包接口

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

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

支持。

3

GB/TXXXXX—XXXX

圖3比對算法包應用環(huán)境示意圖

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

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

比對結果輸出給智能應用系統(tǒng)。

5.2接口要求

算法包接口應滿足以下要求：

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

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

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

c)單個算法句柄僅支持單線程串行調用；

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

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)音視頻流編碼格式應符合GB/T28181-2016的相關要求；

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

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

5.3.4圖像格式類型

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

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

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

5.3.5算法授權格式

用于描述算法授權格式，采用結構化形式。

算法授權格式結構主要成員說明見表3。

表3算法授權格式結構主要成員說明表

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

支持不授權、本地授權、中心授權等多種

授權類型必選

授權方式

授權類型為“不授權”時，此項可不填；

算法授權格式本地授權時，該項可取值為本地License

授權路徑條件必選路徑或者USBPort號；

中心授權時，該項可取值為授權服務遠端

地址

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

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

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

5

GB/TXXXXX—XXXX

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

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

對未開啟超線程的CPU，取值為CPU實際核

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

CPU核數(shù)必選

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

心數(shù)之和

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

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

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

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

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

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

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

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

述相關信息

5.3.7視頻和圖像輸入格式

用于傳遞視頻和圖像輸入信息，采用結構化形式。

視頻和圖像輸入格式結構主要成員說明見表5。

表5視頻和圖像輸入格式結構主要成員說明表

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

格式類型必選見5.3.3和5.3.4

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

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

數(shù)據(jù)

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

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

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

幀率可選

該參數(shù)不生效

時間信息可選包含年、月、日、時、分、秒、毫秒

自定義數(shù)據(jù)描述信息，在數(shù)據(jù)回調中透傳

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

出來

5.3.8音頻輸入格式

用于傳遞音頻輸入信息，采用結構化形式。

音頻輸入格式結構主要成員說明見表6。

6

GB/TXXXXX—XXXX

表6音頻輸入格式結構主要成員說明表

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

格式類型必選見5.3.3

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

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

位深度必選每個采樣點的bit數(shù)

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

音頻輸入格式

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

數(shù)據(jù)類型必選有符號整數(shù)、無符號整數(shù)、浮點數(shù)

時間信息可選包含年、月、日、時、分、秒、毫秒

自定義數(shù)據(jù)描述信息，在數(shù)據(jù)回調中透傳

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

出來

5.3.9回調函數(shù)類型

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

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

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

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

日志回調

回調函數(shù)類型

數(shù)據(jù)回調

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

用于傳遞特征信息，采用結構化形式。

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

表8特征數(shù)據(jù)格式結構成員說明表

數(shù)據(jù)類型結構成員列表取值說明

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

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

用于傳遞檢索比對結果，采用結構化形式。

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

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

數(shù)據(jù)類型結構成員列表取值說明

特征標識

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

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

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

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

7

GB/TXXXXX—XXXX

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

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

接口函數(shù)章條號

算法初始化函數(shù)

算法授權函數(shù)

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

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

同步分析函數(shù)

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

設置回調函數(shù)

數(shù)據(jù)回調函數(shù)

日志回調函數(shù)

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

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

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

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

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

算法初始化函數(shù)

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

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

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

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

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

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

算法授權函數(shù)

用于設置算法授權信息的函數(shù)，調用參數(shù)見表12。

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

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

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

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

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

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

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

的剩余資源。

8

GB/TXXXXX—XXXX

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

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

算法句柄輸出參數(shù)用于標識一個算法上下文的對象

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

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

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

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

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

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

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

算法分析句柄輸入?yún)?shù)用于標識一個算法上下文的對象

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

同步分析函數(shù)

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

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

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

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

算法分析句柄輸入?yún)?shù)用于標識一個算法上下文的對象

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

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

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

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

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

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

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

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

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

算法分析句柄輸入?yún)?shù)用于標識一個算法上下文的對象

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

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

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

設置回調函數(shù)

9

GB/TXXXXX—XXXX

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

表17設置回調函數(shù)參數(shù)列表

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

用于標識一個算法上下文的對象，設置日志回調

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

時可為空

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

回調函數(shù)輸入?yún)?shù)回調函數(shù)對象

回調函數(shù)透傳信息輸入?yún)?shù)透傳到回調函數(shù)中的自定義信息

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

數(shù)據(jù)回調函數(shù)

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

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

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

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

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

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

透傳信息輸入?yún)?shù)與設置回調函數(shù)對應的透傳信息

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

日志回調函數(shù)

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

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

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

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

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

透傳信息輸入?yún)?shù)與設置回調函數(shù)對應的透傳信息

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

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

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

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

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

算法分析句柄輸入?yún)?shù)用于標識一個算法上下文的對象

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

10

GB/TXXXXX—XXXX

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

5.4.3算法包輸出結果

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

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

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

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

11

GB/TXXXXX—XXXX

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

說明章條號

算法初始化函數(shù)

算法授權函數(shù)

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

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

設置回調函數(shù)

日志回調函數(shù)

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

1:1比對函數(shù)

M:N比對函數(shù)

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

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

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

檢索比對函數(shù)3

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

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

5.5.2比對接口函數(shù)

算法初始化函數(shù)

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

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

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

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

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

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

算法授權函數(shù)

用于設置算法授權信息的函數(shù)，調用參數(shù)見表25。

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

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

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

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

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

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

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

12

GB/TXXXXX—XXXX

的剩余資源。

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

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

算法句柄輸出參數(shù)用于標識一個算法上下文的對象

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

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

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

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

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

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

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

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

設置回調函數(shù)

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

比對算法包僅支持設置日志回調函數(shù)。

表28設置回調函數(shù)參數(shù)列表

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

用于標識一個算法上下文的對象，設置日志回調

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

時可為空

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

回調函數(shù)輸入?yún)?shù)回調函數(shù)對象

回調函數(shù)透傳信息輸入?yún)?shù)透傳到回調函數(shù)中的自定義信息

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

日志回調函數(shù)

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

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

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

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

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

透傳信息輸入?yún)?shù)與設置回調函數(shù)對應的透傳信息

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

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

13

GB/TXXXXX—XXXX

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

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

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

算法句柄輸入?yún)?shù)用于標識一個算法上下文的對象

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

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

1:1比對函數(shù)

用于對輸入的兩個特征進行相似度計算的函數(shù)，調用參數(shù)見表31。

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

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

算法句柄輸入?yún)?shù)用于標識一個算法上下文的對象

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

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

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

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

M:N比對函數(shù)

用于輸入的M個特征與基礎N個特征進行相似度計算的函數(shù)，調用參數(shù)見表32。

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

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

算法句柄輸入?yún)?shù)用于標識一個算法上下文的對象

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

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

返回值是一個矩陣，第i行j列的值對應待比對特

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

相似度，每個相似度結果的值域范圍[0,1]

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

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

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

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

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

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

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

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

見5.3.10

14

GB/TXXXXX—XXXX

輸出每個特征的標識，與添加集合中特征位置一

特征標識集合輸出參數(shù)

一對應，調用前需要分配好內存，不能傳空指針

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

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

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

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

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

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

待刪除的特征標識集合輸入?yún)?shù)支持一次調用刪除多個特征

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

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

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

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

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

算法句柄輸入?yún)?shù)用于標識一個算法上下文的對象

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

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

3檢索比對函數(shù)

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

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

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

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

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

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

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

結果返回數(shù)量上限輸入?yún)?shù)

度值從高至低排序

返回值是一個二維矩陣，矩陣第i行與待比對特

征集合中第i個特征對應，表示該特征的檢索結

檢索結果內容輸出參數(shù)

果列表，結果按照相似度從高到低排列

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

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

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

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

15

GB/TXXXXX—XXXX

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

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

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

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

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

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

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

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

6算法服務接口

6.1接口概述

算法服務接口環(huán)境見圖4。智能應用系統(tǒng)通過該接口實現(xiàn)對算法服務的調用維護。