附　錄　C （資料性附錄） 協議接口

C.1　生物特征識別密鑰管理器接口定義

interface bap {

void discover (DiscoveryCallback completionCallback, ErrorCallback errorCallback);

void processBAPOperation (BAPMessage message, BAPResponseCallback completionCallback, ErrorCallback errorCallback);

void notifyBAPResult (int responseCode, BAPMessage BAPResponse);

};

C.2　發現方法

void discover (DiscoveryCallback completionCallback, ErrorCallback errorCallback)

身份鑒別服務器調用該方法，檢查用戶設備是否支持本協議，發現方法參數參見表1。

表1. 發現方法參數

| 參數 | 類型 | 可為空 | 可選 | 描述 |
| completionCallback | DiscoveryCallback（參見附錄C.5） | 否 | 否 | 用于接收生物特征識別密鑰管理器發現數據的回調 |

返回類型：void。

C.3　執行操作方法

void processBAPOperation (BAPMessage message, BAPResponseCallback completionCallback, ErrorCallback errorCallback)

身份鑒別服務器調用該方法，執行本協議的三種操作，如注冊操作、鑒別操作或者注銷操作，執行操作方法參數參見表2。

表2. 執行操作方法參數

| 參數 | 類型 | 可為空 | 可選 | 描述 |
| message | BAPMessage（參見附錄A.1） | 否 | 否 | 生物特征識別密鑰管理器將處理的BAPMessage |
| completionCallback | BAPResponseCallback（參見附錄C.6） | 否 | 否 | 用于接收生物特征識別密鑰管理器發送給IdP的身份鑒別服務器的響應消息 |

返回類型：void。

C.4　通知結果方法

void notifyBAPResult (int responseCode, BAPMessage bapResponse)

當身份鑒別服務器接收并處理協議消息后，應調用該方法，將身份鑒別服務器響應狀態碼返回給生物特征識別密鑰管理器，通知結果方法參數參見表3。

表3. 通知結果方法參數

| 參數 | 類型 | 可為空 | 可選 | 描述 |
| responseCode | int | 否 | 否 | 服務器響應狀態碼 |

返回類型：void。

C.5　DiscoveryCallback回調

DiscoveryCallback回調用于生物特征識別密鑰管理器在異步執行完成發現過程后將發現數據返回給身份鑒別服務器。

callback DiscoveryCallback = void (DiscoveryData data);

參數：

data：DiscoveryData類型（參見附錄B.11），描述當前身份鑒別服務器可使用的生物特征識別密鑰管理器和生物特征識別密鑰管理器當前的狀態。

C.6　BAPResponseCallback回調

BAPResponseCallback回調用于生物特征識別密鑰管理器在異步執行完成操作（例如注冊、鑒別）后將協議消息返回給身份鑒別服務器。

參數：

callback BAPResponseCallback = void (BAPMessage bapResponse);

參數：

bapResponse：BAPMessage類型（參見附錄A.1），生物特征識別密鑰管理器返回的響應消息。

C.7　ErrorCallback回調

ErrorCallback回調用于生物特征識別密鑰管理器在異步執行操作時返回錯誤碼和信息。

callback ErrorCallback = void (ErrorCode code);

參數：

code：ErrorCode類型，ErrorCode接口（參見附錄B.12）中的值，用于描述操作的結果。