1 of 37

ユーザーマニュアル

本マニュアルでは本デバイスに搭載されたファームウェア最新バージョンでの説明を記載しております。

リリースノート

ノート

日付

バージョン

リリース内容

M20/M20S AIビジョンモジュール

M20/M20S AIビジョンモジュールの使用方法について説明します。

M20/M20S AIビジョンモジュールは、高精度のディープラーニング顔認識アルゴリズムを搭載した、双眼式（RGBカメラ＋赤外線カメラ）生体検知技術をはじめ、顔の特徴点抽出、認識アルゴリズムSDK、金属製ケーシングなどを統合した新世代のインテリジェント顔認識AIビジョンモジュールです。

生体検知、顔認証による本人確認などの機能を備えており、各種端末機器に組み込むことで、端末機器のセキュリティー性能を飛躍的に向上させることができます。

改訂履歴

1 本製品について

M20/M20S AI Vision Moduleについて説明します。

1.1 取付設置方法

1.2 廃棄方法

1.1 取付設置について

本製品にお客様のシステムに組み込みご使用いただくユースケースを想定しております。

具体的は設置方法につきましては、2.1 ホスト機器との接続方法をご確認ください。

組み込まずにスタンドアロンでご使用いただく場合は、三脚等に固定いただき、各カメラの向きが地面と垂直となるように固定します。

本デバイスを不正アクセスから保護し、デバイスが改竄される、破壊される、機能を停止される、内部のデータを抽出されることを防ぐために、USBポートは露出しないように設置してください。

1.2 廃棄方法

本製品が不要となり廃却される場合は以下の内容に沿ってご対応ください。

産業廃棄物として各地方自治体の条例に従って適切に処理して下さい。また、本製品の一部または全部を再利用しないでください。

1.3 セキュリティ関連情報：安全にご利用頂くために

以下の注意事項を守ってご使用ください。

Micro-USB端子に対する外部からの予期せぬ物理的なアクセスを防ぐため、当該端子部分は剥き出しにならないように管理してください。

2 使用方法

本デバイスの使用方法について説明します。

2.1 ホスト機器との接続方法

下記のようなMicroUSB端子を備えたUSBケーブルを用意します。

ご用意いただくケーブルの詳細につきましては以下をご確認ください。

長さが0.5m未満の場合：26AWGのケーブルをご使用ください
長さが1m未満の場合：22AWGのケーブルをご使用ください

以下の各ホスト機器に応じた手順で接続します。

ホスト機器に接続後、デバイス自体の動作を安定させるために40秒程度お待ちください。

1 WindowsOSのホスト機器との接続

1 以下のようにWindowsOSホスト機器とUSBケーブルで接続します。

2 Plug and Playによりドライバーは自動でインストールされ接続が完了します。

2 LinuxOSのホスト機器との接続

1 以下のようにUSBケーブルで接続します。

2 以下のようにttyACM0が検出できれば接続が完了します。

3 AndroidOSのホスト機器との接続

1 以下のようにUSBケーブルで接続します。

3 デモアプリケーション操作方法

以下の対応するSDKにおけるデモアプリケーションにおいて、基本機能となる顔認証と生体検知機能の操作方法について説明します。

デモアプリケーションはダウンロードされたSDKのデータに含まれています。SDKのデータをダウンロードしてご利用ください。

・デモアプリケーションを動作させることで本製品の利用例をご確認いただくことができます。

・デモアプリケーションは本製品の利用例を確認する用途以外の目的で使用しないようお願いします。

・デモアプリケーションで使用した顔認証用のIDデータは、使用後に消去することをお勧めします。

ホスト機器と接続された本デバイスの動作を安定させるために、接続した後40秒程度経過後にホスト機器側でデモアプリケーションを実行してください。

この項目で説明する内容はSDKで作成されたアプリケーションの一例であり、SDKで作成されるアプリケーションはこの例に限定されるものではありません。

3.1 WindowsSDK用デモアプリケーション

3.2 LinuxSDK用デモアプリケーション

3.3 AndroidSDK用デモアプリケーション

3.4 ARM LinuxSDK用デモアプリケーション

3.1 WindowsSDK用デモアプリケーション

1 デモ用アプリケーションをからダウンロードしてください

2 zipファイルを解凍し、"Windows"フォルダ内の"uvcCamera.exe"を実行します。

3 以下の画面が表示されることを確認しDevicesからSettingを選択します。

4 以下の画面が表示されることを確認し、以下のようにUVC CameraとWindowsのUSBポートの接続した際の接続ポートを選択し、Applyボタンを押下します。

接続Portは通常自動で選択されます。

5 以下の画面が表示されRGBカメラで捉えた被写体が表示されていることを確認します。

3.1.1 カメラから登録した画像で顔認証を行う場合

1 被写体の画像に顔検出枠が表示されその上にStrangerと表示されていることを確認します。

2 Add base library by Cameraを選択します。

3 現在画面に表示されている画像を顔認証用の画像として登録するために、Image IDに任意のIDを入力します。

入力するIDに現在撮影している顔を画像として登録するため、カメラで顔を撮影した状態のままID入力を実施してください。

4 以下のダイアログが表示されたらOKボタンを選択します。

5 10秒程度経過するとStrangerの表示が3で登録したImage IDに変更されることを確認します。

ここからは顔認証画像の登録を解除する方法について説明します。登録解除を行うにはImage IDを削除します。

以下ではIDごとに個別に削除する方法を説明します。

6 Delete項目を選択します。

7 削除するImage IDを入力し、OKを選択します。

8 以下のダイアログが表示されたらOKを選択し、顔画像へのImage IDの登録が解除されます。

以下では全てのIDを削除する方法を説明します。

9 Delete All項目を選択します。

10 以下のダイアログが表示されたらYesを選択します。

11 以下のダイアログが表示されたらOKを選択し、全顔画像へのImage IDの登録が解除されます。

3.1.2 ローカルストレージから登録した画像で顔認証を行う場合

1 Add base libraryを選択します。

2 ローカルストレージから顔認証用の画像ファイルを選択します。

ファイル形式はjpgです。また、登録可能となる画像サイズは300KB以下となります。

3 画像読み込み時に対応するImage IDを入力しOKを選択します。

4 以下のダイアログが表示されたらOKボタンを選択します。

5 10秒程度経過後に顔認証を行うと3で設定したImage IDに変更されることを確認します。

ここからは顔認証画像の登録を解除する方法について説明します。登録解除を行うにはImage IDを削除します。

以下ではIDごとに個別に削除する方法を説明します。

6 Delete項目を選択します。

7 削除するImage IDを入力し、OKを選択します。

8 以下のダイアログが表示されたらOKを選択し、顔画像へのImage IDの登録が解除されます。

以下では全てのIDを削除する方法を説明します。

9 Delete All項目を選択します。

10 以下のダイアログが表示されたらYesを選択します。

11 以下のダイアログが表示されたらOKを選択し、全顔画像へのImage IDの登録が解除されます。

3.1.3 生体検知を行う場合

1 以下のMulti LivingまたはSingle Livingの項目を選択します。

2 カメラで顔を検知した際検知枠の上にNONLIVENESS以外が表示されていることを確認します。

以下のようにNONLIVENESSと表示される場合は生体検知ができていない状態です。

3.2 LinuxSDK用デモアプリケーション

1 デモ用アプリケーションをからダウンロードしてください

2 LinuxDemoディレクトリが配置されているところまで移動します。

本説明ではデスクトップに配置されています

3 root権限でrun.shファイルを実行し、デモアプリケーションuvcCameaを実行します。

4 アプリケーションの画面が表示されることを確認します。

5 DevicesからSettingを選択します。

6 以下のようにUVC CameraとLinuxのUSBポートの選択を行いApplyボタンを押下します。

7 以下の画面が表示されRGBカメラで捉えた被写体が表示されていることを確認します。

3.2.1 カメラから登録した画像で顔認証を行う場合

1 被写体の画像に顔検出枠が表示されその上にStrangerと表示されていることを確認します。

2 Add base library by Cameraを選択します。

3 現在画面に表示されている画像を顔認証用の画像として登録するために、Image IDに任意のIDを入力します。

入力するIDに現在撮影している顔を画像として登録するため、カメラで顔を撮影した状態のままID入力を実施してください。

4 以下のダイアログが表示されたらOKボタンを選択します。

5 10秒程度経過するとStrangerの表示が3で登録したImage IDに変更されることを確認します。

ここからは顔認証画像の登録を解除する方法について説明します。登録解除を行うにはImage IDを削除します。

以下ではIDごとに個別に削除する方法を説明します。

6 Delete項目を選択します。

8 削除するImage IDを入力し、OKを選択します。

9 以下のダイアログが表示されたらOKを選択し、顔画像へのImage IDの登録が解除されます。

以下では全てのIDを削除する方法を説明します。

10 Delete All項目を選択します。

11 以下のダイアログが表示されたらYesを選択します。

12 以下のダイアログが表示されたらOKを選択し、全顔画像へのImage IDの登録が解除されます。

3.2.2 ローカルストレージから登録した画像で顔認証を行う場合

1 Add base libraryを選択します。

2 ローカルストレージから顔認証用の画像ファイルを選択します。

ファイル形式はjpgです。また、登録可能となる画像サイズは300KB以下となります。

3 画像読み込み時に対応するImage IDを入力しOKを選択します。

4 以下のダイアログが表示されたらOKボタンを選択します。

5 10秒程度経過後に顔認証を行うと3で設定したImage IDに変更されることを確認します。

ここからは顔認証画像の登録を解除する方法について説明します。登録解除を行うにはImage IDを削除します。

以下ではIDごとに個別に削除する方法を説明します。

6 Delete項目を選択します。

7 削除するImage IDを入力し、OKを選択します。

8 以下のダイアログが表示されたらOKを選択し、顔画像へのImage IDの登録が解除されます。

以下では全てのIDを削除する方法を説明します。

9 Delete All項目を選択します。

10 以下のダイアログが表示されたらYesを選択します。

11 以下のダイアログが表示されたらOKを選択し、全顔画像へのImage IDの登録が解除されます。

3.2.3 生体検知を行う場合

1 以下のMulti LivingまたはSingle Livingの項目を選択します。

2 カメラで顔を検知した際検知枠の上にNONLIVENESS以外が表示されていることを確認します。

以下のようにNONLIVENESSと表示される場合は生体検知ができていない状態です。

3.3.1 カメラから登録した画像で顔認証を行う場合

1 被写体の画像に顔検出枠が表示されその上にStrangerと表示されていることを確認します。

2 ADD USERを選択します。

3 現在画面に表示されている画像を顔認証用の画像として登録するために、Image IDに任意のIDを入力します。

入力するIDに現在撮影している顔を画像として登録するため、カメラで顔を撮影した状態のままID入力を実施してください。

4 入力後、SUREを選択します。

5 画面にSUCESSと表示された10秒程度経過するとStrangerの表示が3で登録したImage IDに変更されることを確認します。

ここからは顔認証画像の登録を解除する方法について説明します。登録解除を行うにはImage IDを削除します。

以下ではIDごとに個別に削除する方法を説明します。

6 SETTINGを選択します。

7 DELETE USER項目を選択します。

8 削除するImage IDを入力します。

9 Success.と表示されたら顔画像へのImage IDの登録が解除されます。

以下の戻るボタンを選択し顔認証画面に戻ります。

以下では全てのIDを削除する方法を説明します。

10 DELETE ALL USERS項目を選択します。

11 以下のダイアログが表示されたらSUREを選択します。

12 Success.と表示されたら顔画像へのImage IDの登録が解除されます。

以下の戻るボタンを選択し顔認証画面に戻ります。

3.3.2 生体検知を行う場合

1 1:Nを選択します。

2 以下の画面が表示されたことを確認し、

1:N Single face and open checking livenessまたは1:N Multi face and open checking livenessを選択します。

3 カメラで顔を検知した際検知枠の上にNONLIVENESS以外が表示されていることを確認します。

以下のようにNONLIVENESSと表示される場合は生体検知ができていない状態です。

3.4 ARM LinuxSDK用デモアプリケーション

本SDKをご利用いただくにはファームウェアV2.6.13へのアップデートが必要です。アップデート手順につきましてはを参照ください。

1 以下のフォルダまで移動します。

/senseenginelib-release4B-v4.1.5/release/arm32pi4

2 コマンドsudo ./run.shを実行しデモアプリケーションuvcCameraを起動します。

3 アプリケーションの画面が表示されることを確認します。

4 DevicesメニューからSettingを選択します。

5 以下のようにUVC Cameraと Raspberry Pi 4BのUSBポートの選択を行いApplyボタンを押下します。

5 以下の画面が表示されRGBカメラで捉えた被写体が表示されていることを確認します。 DevicesメニューからSettingを選択します。

3.4.1 カメラから登録した画像で顔認証を行う場合

1 被写体の画像に顔検出枠が表示されその上にStrangerと表示されていることを確認します。

2 Add base library by Cameraを選択します。

3 現在画面に表示されている画像を顔認証用の画像として登録するために、Image IDに任意のIDを入力します。

入力するIDに現在撮影している顔を画像として登録するため、カメラで顔を撮影した状態のままID入力を実施してください。

4 以下のダイアログが表示されたらOKボタンを選択します。

5 10秒程度経過するとStrangerの表示が3で登録したImage IDに変更されることを確認します。

ここからは顔認証画像の登録を解除する方法について説明します。登録解除を行うにはImage IDを削除します。

以下ではIDごとに個別に削除する方法を説明します。

6 Delete項目を選択します。

7 削除するImage IDを入力し、OKを選択します。

8 以下のダイアログが表示されたらOKを選択し、顔画像へのImage IDの登録が解除されます。

以下では全てのIDを削除する方法を説明します。

9 Delete All項目を選択します。

10 以下のダイアログが表示されたらYesを選択します。

11 以下のダイアログが表示されたらOKを選択し、全顔画像へのImage IDの登録が解除されます。

3.4.2 ローカルストレージから登録した画像で顔認証を行う場合

1 Add base libraryを選択します。

2 ローカルストレージから顔認証用の画像ファイルを選択します。

ファイル形式はjpgです。また、登録可能となる画像サイズは300KB以下となります。

3 画像読み込み時に対応するImage IDを入力しOKを選択します。

4 以下のダイアログが表示されたらOKボタンを選択。

5 10秒程度経過後に顔認証を行うと3で設定したImage IDに変更されることを確認します。

ここからは顔認証画像の登録を解除する方法について説明します。登録解除を行うにはImage IDを削除します。

以下ではIDごとに個別に削除する方法を説明します。

6 Delete項目を選択します。

7 削除するImage IDを入力し、OKを選択します。

8 以下のダイアログが表示されたらOKを選択し、顔画像へのImage IDの登録が解除されます。

以下では全てのIDを削除する方法を説明します。

9 Delete All項目を選択します。

10 以下のダイアログが表示されたらYesを選択します。

11 以下のダイアログが表示されたらOKを選択し、全顔画像へのImage IDの登録が解除されます。

3.4.3 生体検知を行う場合

1 以下のMulti LivingまたはSingle Livingの項目を選択します。

2 カメラで顔を検知した際検知枠の上にNONLIVENESS以外が表示されていることを確認します。

3.4.4 ファームウェアアップデート方法

以下の手順でM20のファームウェアをアップデートいただけます。

1 デモアプリケーションのToolsのメニューからUpgradeを選択します。

2 表示された以下の画面からselect Filesを選択します。

3 アップデートするファームウェアのファイルを選択しOpenを選択します。

例）ファームウェアのファイル名がm20V2.6.13update_tar.binの場合

4 アップグレードボタンを選択します。

5 アップデートが開始されプログレスバーにてアップデートが進んでいることを確認します。

6 アップデートが完了すると以下の画面が表示されるため、完了後40秒経過したらOKボタンを選択します。

7 再度DevicesメニューからSettingを選択します。

8 UVC CameraとRaspberry Pi 4BのUSBポートの選択を行いApplyボタンを押下します。

9 ConfigメニューからGet Versionを選択します。

10 表示されたダイアログのsoftware_versionがアップデートされていることを確認します。

例）ファームウェアのファイル名がm20V2.6.13update_tar.binの場合

4 製品仕様

本デバイスの製品仕様について説明します。

4.1 各部名称

本デバイスの各部名称について説明します。

4.2 デバイスの仕様 (M20)

本デバイスの仕様について説明します。

5 SDK動作対象OS

各SDK用APIは以下のバージョンで動作します。

6 SDK仕様

以下の各種SDKの仕様について説明します。

6.1 Windows/Linux SDK

現状リリースしているWindows SDKのみ、M20とホストWindowsマシーンとのUSBによるシリアル通信機能の実装のためにQTの機能を使用しているため、QT環境でご利用いただく必要があります。なお、次のバージョンからはこの制限がなくなる予定です。

ここでは、Windows/Linux SDKで使用可能なAPIについて説明します。

本SDKの開発環境はQT/C#/VC++/CLIを想定しています。また下記APIの戻り値については特に指定がない場合はint型です。

WindowsSDKでアプリケーションを開発するにはQtの開発環境で開発いただく必要があります。Qtの開発環境のインストール方法についてはのQtのインストールを参照ください。

6.1.1 Equipment control section

init( )

alias: initDev

parameter: null

return: handle*

deInit( )

alias: deInitDev

parameter: handle*

return: null

enumDevice( )

parameter:

return:

検出されたデバイスの総数（ビデオデバイスの数+シリアルデバイスの数）を返します。

connectSerial( )

parameter:

return code:

connectCamera( )

parameter:

return code:

disconnectSerial( )

parameter:

return:

disconnectCamera( )

parameter:

return:

Data instruction section

addImageByCamera( )

スナップショットにより画像を追加します。

parameter:

return:

addImageByCameraImage( )

キャプチャとベース画像のエクスポートします。

parameter:

return:

addImageByPc( )

ホストコンピューターから画像を本デバイス側にアップロードします。

parameter:

return:

uploadAddImageSlice( )

スライス（1スライスあたり最大8080バイト）の手法によって、大きな画像データを転送するために使用されます。

parameter:

return:

getDeviceFaceID( )

一番下のデータベースのFaceIDを取得しJSON形式で返します。

parameter:

return:

deleteImage( )

parameter:

return:

queryId( )

parameter:

return:

setRecognizeCount( )

parameter:

return:

getRecognizeCount( )

parameter:

return:

setTemplateUpdate( )

※設定を更新するたびに、モジュールを再起動して有効にする必要があります。

parameter:

return:

getTemplateUpdate ( )

parameter:

return:

inputImage( )

parameter:

return:

addFeature( )

parameter:

return:

queryFeature( )

parameter:

return:

startOnetoNumRecognize( )

1: Nの顔認証を開始します。

parameter:

return:

startOnetoOneRecognize( )

1: 1の顔認証を開始します。

parameter:

return:

resumeRecognize( )

認証を再開します。

parameter:

return:

pauseRecognize( )

認証を停止します。

parameter:

return:

queryRecognize( )

顔認識ステータスの照会を行います。

parameter:

return:

setReoconfig( )

顔認証の設定を行います。

parameter:

return:

getReoconfig( )

顔認証の設定情報をします。

parameter:

return:

openAutoUploadAiInfo( )

認証結果のシリアルポートデータのアクティブレポートスイッチをオンにします（このAPIを呼び出すと、顔認識データレポートが利用可能になります。登録されたコールバック関数registerRecoReportCb、registerTrackReportCb、registerImageReportCb、registerFeatureReportCbに対応します）。

※画像認識と特徴値が取得できない場合は、アクティブレポートをオンにしないことをお勧めします。

後述するopenAutoUploadFaceInfoInFrameを使用するには、フレームデータレポートのみを有効にする必要があります。

parameter:

return:

closeAutoUploadAiInfo( )

認証結果シリアルポートデータアクティブレポートスイッチをオフにします（このAPIを呼び出すと、参照登録コールバック関数registerRecoReportCb、registerTrackReportCb、registerImageReportCb、registerFeatureReportCbに対応する顔認識データレポートがオフになります）。

parameter:

return:

registerRecoReportCb( )

コールバックレポート認証関数を登録します（この関数は、要件をアクティブにレポートし、コールバックして認証結果データを取得します）。

parameter:

return:

void

registerTrackReportCb( )

コールバックレポート追跡関数を登録します（この関数は、需要をアクティブに報告し、コールバックして追跡結果データを取得します）。

parameter:

return:

void

registerImageReportCb( )

画像をレポートするコールバック関数を登録します（この関数は画像をアクティブにレポートし、コールバックして認識画像の結果データを取得します）。

parameter:

return:

void

registerFeatureReportCb( )

コールバックレポート固有値関数を登録します（この関数は要件アクティブレポートです。コールバックは固有値結果を識別するデータを取得します）。

※モジュール認識結果が多すぎる場合、一部の認識機能の値は報告されません。

parameter:

return:

void

registerReOpenCameraCb( )

登録コールバックが再度開かれると、上位のコンピューターとの接続が切断されます。そのため、新規接続を開始した際、モジュールの自己起動に対応します。最後の接続に関するアクティブなレポートを有効にする場合、新規の接続状態を維持することもできます。

parameter:

return:

void

openAutoUploadFaceInfoInFrame( )

認証結果をフレームデータに挿入するスイッチをオンにします（このインターフェイスを呼び出して顔認識データを取得し、getFrame関数を呼び出して顔認識情報を取得します）。

parameter:

return:

closeAutoUploadFaceInfoInFrame( )

認識結果をフレームデータに挿入するスイッチをオフにします。

parameter:

return:

ping( )

parameter:

return:

uploadPackageSlice( )

parameter:

return:

applyUpgrade( )

parameter:

return:

getSysVer( )

parameter:

return:

reboot( )

reboot

parameter:

return:

setUmodeToEngin( )

システムの再起動（USBメモリ以外によるファクトリーモードでの再起動と同様）します。

parameter:

return:

reset( )

システム再起動（ダイレクトリスタートと同様）します。

parameter:

return:

recovery( )

ファクトリー設定を復元します。

parameter:

return:

getDevSn( )

デバイスのシリアルナンバーを取得します。

parameter:

return:

getDevModel( )

デバイスモデルを取得します。

parameter:

return:

setCameraStream( )

カメラを切り替えます。

parameter:

return:

getCameraStream( )

カメラスイッチの状態を取得します。

parameter:

return:

switchCamRgbIr( )

parameter:

return:

setIRlight()

IRライトの輝度を設定します。

parameter:

return:

setIRlightAndTime( )

IRライトを自動でOFFにする時間を設定します。

parameter:

return:

getIRlight( )

IRライトの輝度を取得します。

parameter:

return:

setFrameRate( )

フレームレートを設定します。

parameter:

return:

getFrameRate( )

フレームレートを取得します。

parameter:

return:

setResolution( )

画面サイズを設定します（360pに変更する際はご注意ください）。USB電源をすぐにオフにしないで、モジュールが同期して設定されるまで5秒間待ちます。

parameter:

return:

getScreenDirection( )

スクリーンモードの取得

parameter:

return:

setDeviceNoFlickerHz( )

アンチフリッカー状態を設定します。

parameter:

return:

getDeviceNoFlickerHz( )

アンチフリッカー状態を取得します。

parameter:

return:

getLuminousSensitivityThreshold( )

現在の感光性の値を取得します。

parameter:

return:

getModuleAppVersion( )

デバイスにインストールされたアプリケーションのバージョン情報を取得します。

parameter:

return:

6.1.2 Media section

SetDecoding( )

ビデオデコーダーの設定に使用します。 connectCameraを実行した後、カメラは自動的に再接続します。異なるデコーダーの効率は異なる場合があります。実際の状況に応じて選択してください。現在のインターフェースは無効に設定されており、MJPEGのみをサポートします。

parameter:

getFrameWidth( )

フレームの幅を取得します。バッファサイズは幅 x 高さ x 4です。

parameter:

getFrameHeight( )

フレームの高さを取得します。バッファサイズは幅 x 高さ x 4です。

parameter:

getFrame( )

画像のフレームと検証情報を取得します。画像の保存形式はビットマップで、順序はBBGGRRAAです。呼び出し元は、最新の画像を取得するためにAPIをポーリングする必要があります。これらのアイテムの1つについて、バッファサイズをゼロに設定して、1つのアイテムのみが取得されるようにできます。たとえば、imageBufとimageSizeが0の場合、verifyBufが通常渡されると、画像の代わりに顔認識情報を取得できます。

parameter:

return:

Verifybufはデバイスから送信された検証情報をJSONの形式で保存します。

Verifybufのデータ構造における各フィールド名称とその説明は以下の通りです。

Verifybufの例:

{
   "trackinfo": [ 
    { "recognize_score": 0.986865,
      "liveness_score": 0.967434,
      "recognition_id": "fanzhao",
      "recognition_status": 0,
      "mask_sign": -1,
      "safety_hat": -1,
      "face_info": { "rect": 
                              { "bottom": 1113,
                                "left": 30,
                                "right": 442,
                                "top": 637 },
                                "track_id": 1196 } } ]
 }

trackinfoとして説明すると以下となります。

setReoconfig jsonDataについて

AIサービスの構成情報を設定するjsonDataのデータ構造について説明します。具体的には以下の構造となります。

{ 
"work_mode": 0, 
"recognize_mode" : 1, 
"face_mode" : 1, 
"enable_qr_code" : false, 
"enable_track_box" : true, 
"liveness_thresh" : 0.98, 
"recognition_thresh" : 0.92, 
"verify_thresh" : 0.91, 
"recognition_interval" : 5, 
"report_interval" : 5, 
"max_face_cnt" : 4, 
"face_size" : 10, 
"enable_feature_export" : true, 
"enable_image_export" : true, 
"ae_mode" : 1, 
"ae_flicker_freq" : 0, 
"enable_safety_hat" : false,
 "enable_mask_sign" : false
 }

各々のパラメーターについては以下で説明します。

6.2 Android SDK

ここではAndroid SDKで使用可能なAPIについて説明します。

6.2.1 MTC Basic Control Interface

MTC protocol初期化

API – mtcInit

MTC通信プロトコルオブジェクトを初期化するには、シリアルノードパスを渡す必要があります。モジュールがマウントされていない場合、呼び出しは失敗します。このとき、上位層はリトライ処理を実装いただく必要があります。

インターフェースの定義

public int mtcInit(String path)

parameter:

path：シリアル通信用の接続ノード。デバイスに複数のシリアルポートノードがある場合は、初期化の前に、使用するノードがSenseEngineが配置されているノードであるかどうかを確認する必要があります。例えば/dev/ttyACM0です。

return:

MCTプロトコルの接続検知

API – mtcPing

ホストコンピューターとSenseEngineAIModuleの間でmtcプロトコルが正常かどうかを確認します。

インターフェースの定義

public int mtcPing( )

parameter:

なし

return:

MTCの破棄

API – mtcDestroy

再初期化する場合は、既存のインスタンスを破棄する必要があります。これは安全な命令であり、インスタンスが初期化されずに破棄されても異常ではありません。

インターフェースの定義

public void mtcDestroy( )

parameter:

なし

return:

なし

Output Video From Specified Camera

API – mtcDeviceCameraSwitch

特定のカメラからのビデオストリーム出力

インターフェースの定義

public int mtcDeviceCameraSwitch(int cammraId)

parameter:

return:

FPSの設定

API – mtcDeviceFpsSet

FPSのデータ幅は10から25です。

インターフェースの定義

public int mtcDeviceFpsSet (int fps)

parameter:

return:

FPSの取得

API – mtcDeviceFpsGet

FPSのデータ幅は10から25です。

インターフェースの定義

public int mtcDeviceFpsGet ()

parameter:

なし

return:

スクリーンサイズの設定

API – mtcDeviceScreenSizeSet

インターフェースの定義

public int mtcDeviceScreenSizeSet(int screenSize)

parameter:

return:

UVCの設定

API – mtcDeviceUvcSet

インターフェースの定義

public int mtcDeviceUvcSet(int mode)

parameter:

return:

IR LED 輝度の設定

API – mtcDeviceIrLedSet

IR フィルライトは熱を発するため、30秒間顔を検出しないと自動的にOFFになります。

インターフェースの定義

public int mtcDeviceIrLedSet(int brightness)

parameter:

return:

IR LEDの輝度取得

API – mtcDeviceIrLedGet

インターフェースの定義

public int mtcDeviceIrLedGet( )

parameter:

なし

return:

Set Working LED Status

API – mtcDeviceStatusLedSet

LEDライトの状態をONまたはOFFに設定します。ライト自体は電源のライトです。

インターフェースの定義

public int mtcDeviceStatusLedSet (int brightness)

return:

Get Working LED Status

API – mtcDeviceCameraStatusGet

カメラの動作状態を取得します。

インターフェース定義

public int mtcDeviceCameraStatusGet(int cameraId)

parameter:

return:

カメラの動作状態の設定

API – mtcDeviceCameraStatusSet

カメラ動作状態を設定します。

インターフェースの定義

public int mtcDeviceCameraStatusSet(int mode, int cameraId)

parameter:

return:

センサーの値の取得

API – mtcDeviceBrightnessSensorGet

現在の感光性の値を取得します。

インターフェースの定義

public int mtcDeviceBrightnessSensorGet( )

parameter:

なし

return:

2. 認証アルゴリズム制御の設定

アルゴリズムの設定

API – mtcAiConfig

アルゴリズムを設定します。

インターフェースの定義

public static String mtcAiConfig (MREOConfig mREOConfig)

parameter:

return:

アルゴリズムの認証状態の取得

API – mtcAiStatusGet

インターフェースの定義

public int mtcAiStatusGet ( )

parameter:

なし

return:

ID数の取得

API – mtcAiIDCountGet

インターフェースの定義

public int mtcAiIDCountGet( )

parameter:

なし

return:

1:N認証を有効にする

API – mtcAiStartRecognize

インターフェースの定義

public int mtcAiStartRecognize(int reco_mode, int face_mode)

parameter:

return:

1:1認証を有効にする

API – mtcAiStartVerify

インターフェースの定義

public int mtcAiStartVerify(int reco_mode, int face_mode, byte[ ] imageBytes, String Id)

parameter:

return:

認証の再開

API – mtcAiResume

mtcAiPauseで停止させた認証を再開します。

インターフェースの定義

public static int mtcAiResume ()

parameter:

なし

return:

認証の停止

API – mtcAiPause

インターフェースの定義

public static int mtcAiPause ( )

parameter:

なし

return:

認証情報の自動アップロード

API – mtcAiControlAutoUploadAiInfo

インターフェースの定義

public int mtcAiControlAutoUploadAiInfo(int mode)

parameter:

return:

フレームデータによる認証情報のアップロード

API – mtcUploadFrameAiInfo

インターフェースの定義

public int mtcUploadFrameAiInfo (int mode)

parameter:

return:

カメラによるユーザー追加

API – mtcAiAddImageByCamera

インターフェースの定義

public static int mtcAiAddImageByCamera (String Id)

parameter:

return:

転送画像からのユーザー追加

API – mtcAiAddImageFromExternal

インターフェースの定義

public static int mtcAiAddImageFromExternal (byte[ ] imageBytes,String Id)

parameter:

return:

IDによる特定ユーザーの消去

API – mtcAiDelUserImageById

インターフェースの定義

public static int mtcAiDelUserImageById (String Id)

parameter:

return:

全ユーザーの消去

API – mtcAiClearAllImage

インターフェースの定義

public static int mtcAiClearAllImage ( )

parameter:

なし

return:

IDの照会

API – mtcAiQueryId

ベースライブラリにIDが入っているかどうか確認します。

インターフェースの定義

public static int mtcAiQueryId (String Id)

parameter:

return:

Import Feature

API – mtcAiAddFeature

データベースへfeatureを取り込みます。

インターフェースの定義

public static int mtcAiAddFeature (byte[ ] featureDatas,String Id)

parameter:

return:

featureの取得

API – mtcAiQueryFeature

ID照会によりfeatureを取得します。 ※照会できなかった場合はnullが返却されます。

インターフェースの定義

public static byte[] mtcAiQueryFeature (String featureId)

parameter:

return:

静的な検証

API – mtcAiStaticVerify

特定の画像をライブラリ内の人物と比較することに使用し、データベース内でもっともマッチした顔データを返却します。

インターフェースの定義

public String mtcAiStaticVerify(int mode, byte[ ] imageBytes)

parameter:

return:

システムアップグレードパッケージのアップロード

API – mtcSystemUploadUpgradePackage

ファームウェアアップグレードパッケージを取り込みます。

※UART送信のバッファ制限により、アップグレードパッケージデータをセグメント単位でアップロードするには、このコマンドを周期的に呼び出す必要があります。

インターフェースの定義

public int mtcSystemUploadUpgradePackage (int position,byte [ ] data,int dataLength)

parameter:

return:

システムアップグレードパッケージの適用

API – mtcSystemApplyUpgradePackage

取り込んだファームウェアアップグレードパッケージを適用します。適用が成功するとデバイスは再起動します。

インターフェースの定義

public int mtcSystemApplyUpgradePackage (String fileMD5)

parameter:

return:

カメラの再起動

API – mtcSystemReboot

再起動モードが設定されます。 ※factoryモードを選択すると、カメラ再起動後にこのSDKでカメラに接続することはできません。

インターフェースの定義

public int mtcSystemReboot(int mode)

parameter:

return:

デバイスのシリアルナンバー照会

API – mtcDeviceSnGet

インターフェースの定義

public String mtcGetDeviceSN( )

parameter:

なし

return

システム情報の取得

API – mtcSystemVersionInfoGet

インターフェースの定義

public String mtcSystemVersionInfoGet( )

parameter:

なし

return:

2.4 データにより構造化された顔認証コールバックインターフェイス

認証コールバックインターフェース

API – setReceiveCallback

コールバックインターフェースを登録すると、認証結果がリアルタイムで返送されます。カスタムインターフェイス関数で独自の処理ロジックを実装できます。なお、認証結果が失われる可能性があるためコールバックの処理操作に時間がかかりすぎないように注意してください。

インターフェースの定義

public void setReceiveCallback(IReceiveCallback callback)

parameter:

コールバックに関するインターフェースプロトタイプは以下の通りです。

3. Note

3.1 ノード接続に対する許可がない場合

CAMERAをホストコンピューターに接続した後、デバイス自体をシリアルデバイスノードとして認証する必要があります。接続先となるホストコンピューターはACMをサポートする必要があります。デバイスマウント後のデフォルトノードパスは/ dev / ttyACM0です。アクセス後にデバイスが通信できない場合は、正常にマウントされているか、ノードに読み取り/書き込み/実行権限があるかどうかを確認してください。

以下は確認するための実行コマンドの一例です。

6.3 ARM Linux SDK

LOG

SetLogConfig()

1) 説明 : ログパラメータの設定

2) 関数 : int SetLogConfig(int nLogLever = 1, int nLogTarget = 2);

3) パラメータ :

名称

型

説明

名称

説明

4) 戻り値 :

GetLogConfig()

1) 説明 : ログパラメータの取得

2) 関数 : int GetLogConfig(int* pLogLever, int* pLogTarget);

3) パラメータ :

4) 戻り値 :

Device initialization

Init()

1) 説明 : デバイスの初期化。ログ出力機能が有効の場合、本関数を呼ぶとSDKのバージョンもログに出力される

2) 関数 : void* Init();

3) パラメータ : null

4) 戻り値 : null

DeInit()

1) 説明 : Init()の削除

2) 関数 : int DeInit(void* dev);

3) パラメータ : handle*

4) 戻り値 : null

EnumDevice()

1) 説明 : 現在システムに接続されているデバイスのリストを照会します。カメラのフレンドリ名はvideoDevBufに保存され、serialBufの主な保存形式は "|"で区切られます。たとえば、serialBufは "COM0 |COM1| COM4"で、Linuxの"ttyACM0| ttyACM1"に相当します。

2) 関数 : int EnumDevice(char *videoDevBuf, int videoDevSize, char *serialBuf, int serialSize);

3) パラメータ :

4) 戻り値 :

ConnectSerial()

1) 説明 : シリアルに接続

2) 関数 : int ConnectSerial(void* dev, const char* portName);

3) パラメータ :

4) 戻り値 :

ConnectCamera()

1) 説明 : カメラに接続

2) 関数 : int ConnectCamera(void* dev, const char* mediaName);

3) パラメータ :

4) 戻り値 :

DisconnectSerial()

1) 説明 : シリアル

2) 関数 : int DisconnectSerial(void* dev);

3) パラメータ :

4) 戻り値 :

DisconnectCamera()

1) 説明 : カメラを閉じる

2) 関数 : int DisconnectCamera(void* dev);

3) パラメータ :

4) 戻り値 :

Media

GetFrame()

1) 説明 : 画像のフレームと検証情報を取得します。画像の保存形式はビットマップで、順序はBBGGRRAAです。このAPIを呼ぶ場合は、最新の画像を取得するためにこのインターフェイスをポーリングする必要があります。それらの1つのバッファサイズをゼロに設定して、他の1つだけを取得できます。

例：imageBufとimageSizeを0とし、verifyBufを通常どおり渡すと、画像の代わりに顔認識情報のみを取得できます。

2) 関数 : int GetFrame(void* dev, char* imageBuf, int imageSize, char* verifyBuf, int verifySize);

3) パラメータ :

4) 戻り値 :

verifyBufは、デバイスから送信された検証情報を格納します。形式はjsonです。

各フィールドは以下を参照：

GetResolution()

1) 説明 : フレームの幅/高さを取得します。必要なバッファのサイズは次のとおりです。widthheight4

2) 関数 : int GetResolution(void* dev, int* width, int* height);

3) パラメータ :

4) 戻り値 :

SetUvcSwitch()

1) 説明 : UVCの切り替え

2) 関数 : int SetUvcSwitch(void* dev, char nMode);

3) パラメータ :

4) 戻り値 :

SetCameraStream()

1) 説明 : カメラの切り替え

2) 関数 : int SetCameraStream(void* dev, char isCloseCamera, char nCameraType);

3) パラメータ :

4) 戻り値 :

GetCameraStream()

1) 説明 : カメラの切り替え状態を取得

2) 関数 : int GetCameraStream(void* dev, char nCameraType, uchar* isOpenCamera);

3) パラメータ :

4) 戻り値 :

SwitchCamRgbIr()

1) 説明 : RGBとIRカメラの切り替え

2) 関数 : int SwitchCamRgbIr(void* dev, char nMode);

3) パラメータ :

4) 戻り値 :

SetStreamFormat()

1) 説明 : ストリームフォーマットの設定

2) 関数 : int SetStreamFormat(void* dev, char nMode);

3) パラメータ :

4) 戻り値 :

GetDeviceNoFlickerHz()

1) 説明 : アンチフリッカー状態の取得

2) 関数 : int GetDeviceNoFlickerHz(void* dev, char nCameraId, uchar* pHz, uchar* isEnable);

3) パラメータ :

4) 戻り値 :

SetDeviceNoFlickerHz()

1) 説明 : アンチフリッカー状態の設定

ai_configのae_modeフィールドの値が0の場合、ここでの設定が有効になります。ae_modeフィールドが1の場合、ai_config（setReoconfig関数）内でae_flicker_freqを構成する必要があります。

2) 関数 : int SetDeviceNoFlickerHz(void* dev, char nCameraId, char nHz, char isEnable);

3) パラメータ :

4) 戻り値 :

SetResolution()

1) 説明 : 画面サイズを設定し、360Pを切り替えた直後にUSB電源を抜き差ししないように注意し、モジュールが設定を同期するまで5秒間待ちます。

2) 関数 : int SetResolution(void* dev, char nMode);

3) パラメータ :

4) 戻り値 :

GetFrameRate()

1) 説明 : フレームレートの取得

2) 関数 : int GetFrameRate(void* dev, uint* pFrameRate);

3) パラメータ :

4) 戻り値 :

SetFrameRate()

1) 説明 : フレームレートの設定

2) 関数 : int SetFrameRate(void* dev, int nFrameRate);

3) パラメータ :

4) 戻り値 :

GetIRlight()

1) 説明 : IRライトの明るさを取得します

2) 関数 : int GetIRlight(void* dev, uchar* pLuminance,uchar* pCloseTime);

3) パラメータ :

4) 戻り値 :

SetIRlight()

1) 説明 : IRライトの明るさを設定します。

2) 関数 : int SetIRlight(void* dev, uchar nLuminance, uchar nCloseTime);

3) パラメータ :

4) 戻り値 :

AI

AddFace()

1) 説明 : キャプチャとその結果をストレージへ保存

2) 関数 : int AddFace(void* dev, const void* pID, uint nIDLength);

3) パラメータ :

4) 戻り値 :

AddFaceByImage()

1) 説明 : ホストコンピュータからのベースマップをライブラリに転送

ベースマップの高さと幅は1080p未満である必要があります。

2) 関数 : int AddFaceByImage(void* dev, const void* pID, uint nIDLength, const void* pImage, uint nImageLength);

3) パラメータ :

4) 戻り値 :

AddFaceReturnImage()

1) 説明 : ライブラリにキャプチャを行いベースマップを出力する

retポインタが戻った後、上位のコンピュータはメモリを解放する必要があります

2) 関数 : int AddFaceReturnImage(void* dev, const void* pID, uint nIDLength, void** ppImage, uint *pImageLength);

3) パラメータ :

4) 戻り値 :

AddFaceSlice()

1) 説明 : uploadAddImageByPcSliceは、uploadPackageSliceと同様に、スライスでアップグレードパッケージをアップロードするようにスライス（スライスあたり最大8080バイト）を介して大きな画像データ（最大サポート4M）を送信します。画像にaddImageByPcを使用することはお勧めしません。

2) 関数 : int GetFrameRate(void* dev, uint* pFrameRate);

3) パラメータ :

4) 戻り値 :

DeleteFace()

1) 説明 : baseライブラリからの顔データ削除

2) 関数 : int DeleteFace(void* dev, int nMode, const void* pID = nullptr, uint nIDLength = 0);

3) パラメータ :

4) 戻り値

QueryFace()

1) 説明 : ベースデータベースのFaceIDを取得し、json形式で返します。 Char *は684K確保する必要があります。

2) 関数 : int QueryFace(void* dev, const void* pID, uint nIDLength, int nMode = 0);

3) パラメータ :

4) 戻り値

StaticFaceCompare()

1) 説明 : モジュールスナップショットによってインポートされた静的比較（断片化なし）

2) 関数 : int StaticFaceCompare(void* dev, void** ppResImage, uint* pResImageLength);

3) パラメータ :

4) 戻り値

StaticFaceCompareReturnImage()

1) 説明 : 静的比較（断片化なし）ホストコンピューターは画像をインポート

2) 関数 : int StaticFaceCompareReturnImage(void* dev, const void* pImage, uint nImageLength, void** ppResImage, uint* pResImageLength);

3) パラメータ :

4) 戻り値

StaticFaceCompareSlice()

1) 説明 : 製的比較

2) 関数 : int StaticFaceCompareSlice(void* dev, int nMode, uint nImageTotalLength, uint nPosition, int isLastSlice,const void* pSliceData, uint nSliceDataLength, void** ppResImage, uint* pResImageLength);

3) パラメータ :

4) 戻り値

AddFeature()

1) 説明 : 特徴値を使用してベースデータベースの顔データを追加し、ベースデータベースIDと顔の特徴値に従って顔情報をベースデータベースに入力します。

2) 関数 : int AddFeature(void* dev, const void* pID, uint nIDLength, const void* pFeature, uint nFeatureLength);

3) パラメータ :

4) 戻り値

QueryFeature()

1) 説明 : 基本データベースIDに従って特徴値を照会し、基本データベースIDを使用して、検索データベースの顔情報の顔特徴値を照会します。

2) 関数 : int QueryFeature(void* dev, const void* pID, uint nIDLength, void* pFeature, uint nFeatureLength);

3) パラメータ :

4) 戻り値

StartOnetoNumRecognize()

1) 説明 : 1:N 顔認証

2) 関数 : int StartOnetoNumRecognize(void* dev, int nRecMode, int nMulMode);

3) パラメータ :

4) 戻り値

StartOnetoNumRecognize()

1) 説明 : 1:N 顔認証

2) 関数 : int StartOnetoNumRecognize(void* dev, int nRecMode, int nMulMode);

3) パラメータ :

4) 戻り値

StartOnetoOneRecognize()

1) 説明 : 1:1の顔認識を開始します（断片化なし）

2) 関数 : int StartOnetoNumRecognize(void* dev, int nRecMode, int nMulMode);

3) パラメータ :

4) 戻り値

StartOnetoOneRecognizeSlice()

1) 説明 : 1：1の顔認識（断片化）を開始し、1：1の認識モードを開始すると、動的に切り替えることができます。

2) 関数 : int StartOnetoOneRecognizeSlice(void* dev, int nRecMode, int nMulMode, uint nImageTotalLength, uint nPosition,int isLastSlice, const void* pSliceData, uint nSliceDataLength);

3) パラメータ :

4) 戻り値

ResumeRecognize()

1) 説明 : 顔認識を継続する

2) 関数 : int ResumeRecognize(void* dev);

3) パラメータ :

4) 戻り値

PauseRecognize()

1) 説明 : 顔認識を一時停止します

2) 関数 : int PauseRecognize(void* dev);

3) パラメータ :

4) 戻り値

QueryRecognize()

1) 説明 : 顔認識ステータスの照会

2) 関数 : int QueryRecognize(void* dev);

3) パラメータ :

4) 戻り値

SetRecConfig()

1) 説明 : 顔認識の構成を設定する

2) 関数 : int SetRecConfig(void* dev, const void* pData, uint nDataLength, int nConfigType = 0);

3) パラメータ :

4) 戻り値

GetRecConfig()

1) 説明 : 顔認識構成を取得する

2) 関数 : int StartOnetoNumRecognize(void* dev, int nRecMode, int nMulMode);

3) パラメータ :

4) 戻り値

OpenAutoUploadFaceInfoInFrame()

1) 説明 : フレームデータに認識結果を挿入するスイッチをオンにする（顔認識データはこのインターフェースを呼び出すことで取得でき、顔認識情報はgetFrame関数で取得できます）

2) 関数 : int OpenAutoUploadFaceInfoInFrame(void* dev);

3) パラメータ :

4) 戻り値

CloseAutoUploadFaceInfoInFrame()

1) 説明 : フレームデータスイッチへの認識結果をオフにする

2) 関数 : int CloseAutoUploadFaceInfoInFrame(void* dev);

3) パラメータ :

4) 戻り値

GetDeviceFaceID()

1) 説明 : IDリストの出力

2) 関数 : int GetDeviceFaceID(void* dev, void* pIDList, uint nIDListLength);

3) パラメータ :

4) 戻り値

SetRecognizeCount()

1) 説明 : 顔認証回数を設定する

2) 関数 : int SetRecognizeCount(void* dev, uchar nRecCount, uchar nLivingCount);nRecCount

3) パラメータ :

4) 戻り値

SetTemplateUpdate()

1) 説明 : テンプレートの更新を設定する。

設定を更新するたびに、モジュールを再起動して有効にする必要があることに注意してください。

2) 関数 : int SetTemplateUpdate(void* dev, uchar isUpdate);

3) パラメータ :

4) 戻り値

GetTemplateUpdate()

1) 説明 : テンプレートアップデートの取得

2) 関数 : int GetTemplateUpdate(void* dev, uchar* isUpdate); 3)parameter:

3) パラメータ :

4) 戻り値

SetQRCodeSwitch()

1) 説明 : QRコード認証パラメータの設定

2) 関数 : int SetQRCodeSwitch(void* dev, uchar isOpen, uchar interval);

3) パラメータ :

4) 戻り値

GetDeviceFaceLibraryNum()

1) 説明 : ベースライブラリ数を取得する

2) 関数 : int GetDeviceFaceLibraryNum(void* dev, uint *nFaceNum);

3) パラメータ :

4) 戻り値

GetSingleRecognize()

1) 説明 : 単一の認識結果を取得する。

ビデオで顔が検出された場合、認識結果が返されます。ビデオで顔が検出されない場合、返される文字列は空です。

2) 関数 : int GetSingleRecognize(void* dev, void* pData, uint nDataLength);

3) パラメータ :

4) 戻り値

RegisterRecoReportCb()

1) 説明 : コールバックレポート識別関数を登録する。

（この関数は、アクティブにレポートするために必要です。コールバックは識別結果データを取得します。デモのgetReoReportDataHandleコールバック関数のソースコードを参照できることに注意してください。）

2) 関数 : void RegisterRecoReportCb(void* dev, CallBackPtr_t handler_func);

3) パラメータ :

4) 戻り値

RegisterTrackReportCb()

1) 説明 : コールバックレポート追跡関数を登録する。

（この関数は、追跡結果データを取得するためにコールバックをアクティブにレポートするために必要です。デモでgetReoTrackHandleコールバック関数のソースコードを参照できることに注意してください。）

2) 関数 : void RegisterTrackReportCb(void* dev, CallBackPtr_t handler_func);

3) パラメータ :

4) 戻り値

RegisterImageReportCb()

1) 説明 : コールバックを登録して画像関数を報告する。

（この関数はアクティブに報告するために必要であり、コールバックは認識画像の結果データを取得するために使用されます。デモでgetReoImageHandleコールバック関数のソースコードを参照できることに注意してください。）

2) 関数 : void RegisterImageReportCb(void* dev, CallBackPtr_t handler_func);

3) パラメータ :

4) 戻り値

RegisterFeatureReportCb()

1) 説明 : コールバックを登録して機能値関数をレポートする。

（この関数はアクティブにレポートするために必要です。コールバックは識別機能値の結果データを取得します。デモでgetReoFeatureHandleコールバック関数のソースコードを参照できることに注意してください）。

モジュール認識結果が多すぎると、認識機能値の一部が報告されません。したがって、アクティブレポートスイッチ機能のopenAutoUploadAiInfoパラメーターはモード0x02にすることをお勧めします。また、デモコール設定も同様です。

2) 関数 : void RegisterFeatureReportCb(void* dev, CallBackPtr_t handler_func);

3) パラメータ :

4) 戻り値

RegisterQRCodeReportCb()

1) 説明 : コールバックを登録してQRコード関数を報告する。

（この関数はアクティブに報告するために必要です。コールバックはQRコード認識の結果データを取得するために必要です。デモでgetQRCodeReportHandleコールバック関数のソースコードを参照できることに注意してください。）

SetQRCodeSwitch関数を呼び出してQRコードレポートスイッチをオンにすると、コールバック関数はQRコードの結果データを受信できます

2) 関数 : int GetSingleRecognize(void* dev, void* pData, uint nDataLength);

3) パラメータ :

4) 戻り値

ビデオフレーム検証情報の例：

{ "track_info": [ { "recognize_score": 0.986865, "liveness_score": 0.967434, "recognition_id": "fanzhao", "recognition_status": 0, "mask_sign": -1, "safety_hat": -1, "face_info": { "rect": { "bottom": 1113, "left": 30, "right": 442, "top": 637}, "track_id": 1196 } } ] }

Device

Ping()

1) 説明 : デバイスの接続性をテストする

2) 関数 : int Ping(void* dev, const void* pTestData, uint nTestDataLength);

3) パラメータ :

4) 戻り値

UploadPackageSlice()

1) 説明 : アップグレードパッケージのアップロードを開始する。

2) 関数 : int UploadPackageSlice(void* dev, uint nPosition, const void* pPacketData, uint nPacketDataLength);

3) パラメータ :

4) 戻り値

GetDevModelAppVer()

1) 説明 : モジュールハードウェアのバージョン番号を取得する。

2) 関数 : int GetDevModelAppVer(void* dev, void* pModelVersion, uint nModelVersionLength);

3) パラメータ :

4) 戻り値

ApplyUpgrade()

1) 説明 : md5値を16進数に変換し、小文字のままにしてください。そうでない場合、デバイスはそれを認識しません。

2) 関数 : int ApplyUpgrade(void* dev, const void* pHashData, uint nHashDataLength);

3) パラメータ :

4) 戻り値

GetDeviceVersion()

1) 説明 : システムバージョン情報を照会する。

2) 関数 : int GetDeviceVersion(void* dev, void* pVersion, uint nLength);

3) パラメータ :

4) 戻り値

Reboot()

1) 説明 : システムを再起動する。

2) 関数 : int Reboot(void* dev, int nMode);

3) パラメータ :

4) 戻り値

SetUmodeToEngin()

1) 説明 : システムを再起動する（再起動時の非Uディスクファクトリモードの再起動に対応します）

2) 関数 : int SetUmodeToEngin(void* dev);

3) パラメータ :

4) 戻り値

Reset()

1) 説明 : システムを再起動する（再起動時の直接再起動に対応します）

2) 関数 : Restart the system (corresponding to the direct restart in reboot):

3) パラメータ :

4) 戻り値

Recovery()

1) 説明 : リセットする。

2) 関数 : int Recovery(void* dev, int nMode);

3) パラメータ :

4) 戻り値

GetDevSn()

1) 説明 : デバイスのSNを取得する

2) 関数 : int GetDevSn(void* dev, char nMode, void* pDevSn, uint nDevsnLength);

3) パラメータ :

4) 戻り値

GetDevModel()

1) 説明 : デバイスのモデルを取得する

2) 関数 : int GetDevModel(void* dev, void* pDevModel, uint nDevModelLength);

3) パラメータ :

4) 戻り値

GetCpuTemperature()

1) 説明 : CUP温度を照会する。

2) 関数 : int GetCpuTemperature(void* dev, uint* nTemperature);

3) パラメータ :

4) 戻り値

CloseAutoUploadAiInfo()

1) 説明 : 認識結果のシリアルポートデータのアクティブなレポートスイッチをオフにする。

このインターフェイスを呼び出すと、登録コールバック関数registerRecoReportCb、registerTrackReportCb、registerImageReportCb、registerFeatureReportCbに対応する顔認識データレポートがオフになります。

2) 関数 : int CloseAutoUploadAiInfo(void* dev);

3) パラメータ :

4) 戻り値

OpenAutoUploadAiInfo()

1) 説明 : 認識結果のシリアルポートデータの自動レポートスイッチをオンにする。

このインターフェイスを呼び出すと、登録コールバック関数registerRecoReportCb、registerTrackReportCb、registerImageReportCb、registerFeatureReportCbに対応する顔認識データがレポートされます。

画像と認識機能値をレポートする必要がない場合は、アクティブレポートを有効にせず、フレームデータレポートopenAutoUploadFaceInfoInFrameのみを有効にして下さい。

2) 関数 : int OpenAutoUploadAiInfo(void* dev, char nUploadMode,char nImageMode);

3) パラメータ :

4) 戻り値

参考情報

Qtのインストール

Windows用SDK V3.0.0でアプリケーションを作成いただく場合はQTの開発環境で作成いただく必要があります。そのため、以下の手順を参照いただきQTの開発環境をインストールして下さい。

1. 予めC++で作成されたソースコードのビルドを行うためにMicrosoft Visual Studioをインストールしておきます（インストール時はC++によるデスクトップ開発を選択してインストールして下さい）。

2. Qtのアカウントをお持ちでない場合はアカウント作成を行います。

3. 以下のURLからQt V5.12.3のopen sourceバージョンをダウンロードします。

4. ダウンロードしたファイルをダブルクリックして、Qtのインストールを行います。

5. インストールが開始され、以下の画面が表示されることを確認し、Nextを選択します。

6. 事前に登録したアカウントのemailアドレスとパスワードを入力し、Nextを選択します。

7. 次へを選択します。

8. 次へを選択します。

9. MSVC 2017を選択します。WindowsOSの32bit版をお使いの場合はMSVC 2017 32-bitをチェックし、64bit版をお使いの場合はMSVC 2017 64-bitをチェックします。その後、次へを選択します。

10. 必要なライセンス形態を選択し、実際のインストールを行います。インストールが開始されると以下の画面が表示されます。

11. インストールが完了し、以下の画面が表示されることを確認したら、完了を選択します。

12. 続いて環境変数の設定を実施します。以下の画面で、変数pathにQtCreatorとMSVCのインストールパス情報を追加します。

13. インストールしたQtのアプリケーションの中からQt Creatorを起動し、以下のようにツールからオプションを選択します。

14. Kitsからキットを選択し、予めインストールされたMicosoft Visual Studioを以下のようにCompilerのC:/C++:の部分で指定します。そのOKを選択してインストール作業は完了です。

サンプルコードビルド方法

以下は、サンプルコードをビルドする際の方法となります。

1. Windows用のSDKのzipファイル：Windows_Linux_SDK_V3.0.0.zipを解凍して作成されたフォルダWindows_Linux_SDK_V3.0.0.にSource¥SenseEngineUVC¥uvcCamera.proが存在することを確認します。

確認後、uvcCamera.proをダブルクリックし、先の手順で選択したMSVC2017 64bit（または32bit）が選択されていることを確認し、以下の画面でConfigure Projectを選択します。

2. uvcCamera¥Headers¥qmtc¥mtcmanager.hの以下の赤枠のコメント内容を削除します。

3. WindowsOSの64bit版をお使いの場合はuvcCamera¥uvcCamera.proに、以下の赤枠の内容（DEFINES += WIN64）を追加します。

4. 以下の画面からビルドを選択し、「すべてビルド」を選択します。

5. 以下の通り、ビルドされたアプリケーションが作成されていることを確認します。確認できれば、ビルド作業は完了です。

6.1 Windows/Linux SDK

ここでは、Windows/Linux SDKで使用可能なAPIについて説明します。

本SDKの開発環境はQT/C#/VC++/CLIを想定しています。また下記APIの戻り値については特に指定がない場合はint型です。

6.1.1 Equipment control section

init( )

alias: initDev

parameter: null

return: handle*

deInit( )

alias: deInitDev

parameter: handle*

return: null

enumDevice( )

parameter:

return:

検出されたデバイスの総数（ビデオデバイスの数+シリアルデバイスの数）を返します。

connectSerial( )

parameter:

return code:

connectCamera( )

parameter:

return code:

disconnectSerial( )

parameter:

return:

disconnectCamera( )

parameter:

return:

Data instruction section

addImageByCamera( )

スナップショットにより画像を追加します。

parameter:

return:

addImageByCameraImage( )

キャプチャとベース画像のエクスポートします。

parameter:

return:

addImageByPc( )

ホストコンピューターから画像を本デバイス側にアップロードします。

parameter:

return:

uploadAddImageSlice( )

スライス（1スライスあたり最大8080バイト）の手法によって、大きな画像データを転送するために使用されます。

parameter:

return:

getDeviceFaceID( )

一番下のデータベースのFaceIDを取得しJSON形式で返します。

parameter:

return:

deleteImage( )

parameter:

return:

queryId( )

parameter:

return:

setRecognizeCount( )

parameter:

return:

getRecognizeCount( )

parameter:

return:

setTemplateUpdate( )

※設定を更新するたびに、モジュールを再起動して有効にする必要があります。

parameter:

return:

getTemplateUpdate ( )

parameter:

return:

inputImage( )

parameter:

return:

addFeature( )

parameter:

return:

queryFeature( )

parameter:

return:

startOnetoNumRecognize( )

1: Nの顔認証を開始します。

parameter:

return:

startOnetoOneRecognize( )

1: 1の顔認証を開始します。

parameter:

return:

resumeRecognize( )

認証を再開します。

parameter:

return:

pauseRecognize( )

認証を停止します。

parameter:

return:

queryRecognize( )

顔認識ステータスの照会を行います。

parameter:

return:

setReoconfig( )

顔認証の設定を行います。

parameter:

return:

getReoconfig( )

顔認証の設定情報をします。

parameter:

return:

openAutoUploadAiInfo( )

※画像認識と特徴値が取得できない場合は、アクティブレポートをオンにしないことをお勧めします。

後述するopenAutoUploadFaceInfoInFrameを使用するには、フレームデータレポートのみを有効にする必要があります。

parameter:

return:

closeAutoUploadAiInfo( )

parameter:

return:

registerRecoReportCb( )

コールバックレポート認証関数を登録します（この関数は、要件をアクティブにレポートし、コールバックして認証結果データを取得します）。

parameter:

return:

void

registerTrackReportCb( )

コールバックレポート追跡関数を登録します（この関数は、需要をアクティブに報告し、コールバックして追跡結果データを取得します）。

parameter:

return:

void

registerImageReportCb( )

parameter:

return:

void

registerFeatureReportCb( )

※モジュール認識結果が多すぎる場合、一部の認識機能の値は報告されません。

parameter:

return:

void

registerReOpenCameraCb( )

parameter:

return:

void

openAutoUploadFaceInfoInFrame( )

parameter:

return:

closeAutoUploadFaceInfoInFrame( )

認識結果をフレームデータに挿入するスイッチをオフにします。

parameter:

return:

ping( )

parameter:

return:

uploadPackageSlice( )

parameter:

return:

applyUpgrade( )

parameter:

return:

getSysVer( )

parameter:

return:

reboot( )

reboot

parameter:

return:

setUmodeToEngin( )

システムの再起動（USBメモリ以外によるファクトリーモードでの再起動と同様）します。

parameter:

return:

reset( )

システム再起動（ダイレクトリスタートと同様）します。

parameter:

return:

recovery( )

ファクトリー設定を復元します。

parameter:

return:

getDevSn( )

デバイスのシリアルナンバーを取得します。

parameter:

return:

getDevModel( )

デバイスモデルを取得します。

parameter:

return:

setCameraStream( )

カメラを切り替えます。

parameter:

return:

getCameraStream( )

カメラスイッチの状態を取得します。

parameter:

return:

switchCamRgbIr( )

parameter:

return:

setIRlight()

IRライトの輝度を設定します。

parameter:

return:

setIRlightAndTime( )

IRライトを自動でOFFにする時間を設定します。

parameter:

return:

getIRlight( )

IRライトの輝度を取得します。

parameter:

return:

setFrameRate( )

フレームレートを設定します。

parameter:

return:

getFrameRate( )

フレームレートを取得します。

parameter:

return:

setResolution( )

parameter:

return:

getScreenDirection( )

スクリーンモードの取得

parameter:

return:

setDeviceNoFlickerHz( )

アンチフリッカー状態を設定します。

parameter:

return:

getDeviceNoFlickerHz( )

アンチフリッカー状態を取得します。

parameter:

return:

getLuminousSensitivityThreshold( )

現在の感光性の値を取得します。

parameter:

return:

getModuleAppVersion( )

デバイスにインストールされたアプリケーションのバージョン情報を取得します。

parameter:

return:

6.1.2 Media section

SetDecoding( )

parameter:

getFrameWidth( )

フレームの幅を取得します。バッファサイズは幅 x 高さ x 4です。

parameter:

getFrameHeight( )

フレームの高さを取得します。バッファサイズは幅 x 高さ x 4です。

parameter:

getFrame( )

parameter:

return:

Verifybufはデバイスから送信された検証情報をJSONの形式で保存します。

Verifybufのデータ構造における各フィールド名称とその説明は以下の通りです。

Verifybufの例:

{
   "trackinfo": [ 
    { "recognize_score": 0.986865,
      "liveness_score": 0.967434,
      "recognition_id": "fanzhao",
      "recognition_status": 0,
      "mask_sign": -1,
      "safety_hat": -1,
      "face_info": { "rect": 
                              { "bottom": 1113,
                                "left": 30,
                                "right": 442,
                                "top": 637 },
                                "track_id": 1196 } } ]
 }

trackinfoとして説明すると以下となります。

setReoconfig jsonDataについて

AIサービスの構成情報を設定するjsonDataのデータ構造について説明します。具体的には以下の構造となります。

{ 
"work_mode": 0, 
"recognize_mode" : 1, 
"face_mode" : 1, 
"enable_qr_code" : false, 
"enable_track_box" : true, 
"liveness_thresh" : 0.98, 
"recognition_thresh" : 0.92, 
"verify_thresh" : 0.91, 
"recognition_interval" : 5, 
"report_interval" : 5, 
"max_face_cnt" : 4, 
"face_size" : 10, 
"enable_feature_export" : true, 
"enable_image_export" : true, 
"ae_mode" : 1, 
"ae_flicker_freq" : 0, 
"enable_safety_hat" : false,
 "enable_mask_sign" : false
 }

各々のパラメーターについては以下で説明します。

6.3 ARM Linux SDK

LOG

SetLogConfig()

1) 説明 : ログパラメータの設定

2) 関数 : int SetLogConfig(int nLogLever = 1, int nLogTarget = 2);

3) パラメータ :

名称

型

説明

名称

説明

4) 戻り値 :

GetLogConfig()

1) 説明 : ログパラメータの取得

2) 関数 : int GetLogConfig(int* pLogLever, int* pLogTarget);

3) パラメータ :

4) 戻り値 :

Device initialization

Init()

1) 説明 : デバイスの初期化。ログ出力機能が有効の場合、本関数を呼ぶとSDKのバージョンもログに出力される

2) 関数 : void* Init();

3) パラメータ : null

4) 戻り値 : null

DeInit()

1) 説明 : Init()の削除

2) 関数 : int DeInit(void* dev);

3) パラメータ : handle*

4) 戻り値 : null

EnumDevice()

2) 関数 : int EnumDevice(char *videoDevBuf, int videoDevSize, char *serialBuf, int serialSize);

3) パラメータ :

4) 戻り値 :

ConnectSerial()

1) 説明 : シリアルに接続

2) 関数 : int ConnectSerial(void* dev, const char* portName);

3) パラメータ :

4) 戻り値 :

ConnectCamera()

1) 説明 : カメラに接続

2) 関数 : int ConnectCamera(void* dev, const char* mediaName);

3) パラメータ :

4) 戻り値 :

DisconnectSerial()

1) 説明 : シリアル

2) 関数 : int DisconnectSerial(void* dev);

3) パラメータ :

4) 戻り値 :

DisconnectCamera()

1) 説明 : カメラを閉じる

2) 関数 : int DisconnectCamera(void* dev);

3) パラメータ :

4) 戻り値 :

Media

GetFrame()

例：imageBufとimageSizeを0とし、verifyBufを通常どおり渡すと、画像の代わりに顔認識情報のみを取得できます。

2) 関数 : int GetFrame(void* dev, char* imageBuf, int imageSize, char* verifyBuf, int verifySize);

3) パラメータ :

4) 戻り値 :

verifyBufは、デバイスから送信された検証情報を格納します。形式はjsonです。

各フィールドは以下を参照：

GetResolution()

1) 説明 : フレームの幅/高さを取得します。必要なバッファのサイズは次のとおりです。widthheight4

2) 関数 : int GetResolution(void* dev, int* width, int* height);

3) パラメータ :

4) 戻り値 :

SetUvcSwitch()

1) 説明 : UVCの切り替え

2) 関数 : int SetUvcSwitch(void* dev, char nMode);

3) パラメータ :

4) 戻り値 :

SetCameraStream()

1) 説明 : カメラの切り替え

2) 関数 : int SetCameraStream(void* dev, char isCloseCamera, char nCameraType);

3) パラメータ :

4) 戻り値 :

GetCameraStream()

1) 説明 : カメラの切り替え状態を取得

2) 関数 : int GetCameraStream(void* dev, char nCameraType, uchar* isOpenCamera);

3) パラメータ :

4) 戻り値 :

SwitchCamRgbIr()

1) 説明 : RGBとIRカメラの切り替え

2) 関数 : int SwitchCamRgbIr(void* dev, char nMode);

3) パラメータ :

4) 戻り値 :

SetStreamFormat()

1) 説明 : ストリームフォーマットの設定

2) 関数 : int SetStreamFormat(void* dev, char nMode);

3) パラメータ :

4) 戻り値 :

GetDeviceNoFlickerHz()

1) 説明 : アンチフリッカー状態の取得

2) 関数 : int GetDeviceNoFlickerHz(void* dev, char nCameraId, uchar* pHz, uchar* isEnable);

3) パラメータ :

4) 戻り値 :

SetDeviceNoFlickerHz()

1) 説明 : アンチフリッカー状態の設定

2) 関数 : int SetDeviceNoFlickerHz(void* dev, char nCameraId, char nHz, char isEnable);

3) パラメータ :

4) 戻り値 :

SetResolution()

1) 説明 : 画面サイズを設定し、360Pを切り替えた直後にUSB電源を抜き差ししないように注意し、モジュールが設定を同期するまで5秒間待ちます。

2) 関数 : int SetResolution(void* dev, char nMode);

3) パラメータ :

4) 戻り値 :

GetFrameRate()

1) 説明 : フレームレートの取得

2) 関数 : int GetFrameRate(void* dev, uint* pFrameRate);

3) パラメータ :

4) 戻り値 :

SetFrameRate()

1) 説明 : フレームレートの設定

2) 関数 : int SetFrameRate(void* dev, int nFrameRate);

3) パラメータ :

4) 戻り値 :

GetIRlight()

1) 説明 : IRライトの明るさを取得します

2) 関数 : int GetIRlight(void* dev, uchar* pLuminance,uchar* pCloseTime);

3) パラメータ :

4) 戻り値 :

SetIRlight()

1) 説明 : IRライトの明るさを設定します。

2) 関数 : int SetIRlight(void* dev, uchar nLuminance, uchar nCloseTime);

3) パラメータ :

4) 戻り値 :

AI

AddFace()

1) 説明 : キャプチャとその結果をストレージへ保存

2) 関数 : int AddFace(void* dev, const void* pID, uint nIDLength);

3) パラメータ :

4) 戻り値 :

AddFaceByImage()

1) 説明 : ホストコンピュータからのベースマップをライブラリに転送

ベースマップの高さと幅は1080p未満である必要があります。

2) 関数 : int AddFaceByImage(void* dev, const void* pID, uint nIDLength, const void* pImage, uint nImageLength);

3) パラメータ :

4) 戻り値 :

AddFaceReturnImage()

1) 説明 : ライブラリにキャプチャを行いベースマップを出力する

retポインタが戻った後、上位のコンピュータはメモリを解放する必要があります

2) 関数 : int AddFaceReturnImage(void* dev, const void* pID, uint nIDLength, void** ppImage, uint *pImageLength);

3) パラメータ :

4) 戻り値 :

AddFaceSlice()

2) 関数 : int GetFrameRate(void* dev, uint* pFrameRate);

3) パラメータ :

4) 戻り値 :

DeleteFace()

1) 説明 : baseライブラリからの顔データ削除

2) 関数 : int DeleteFace(void* dev, int nMode, const void* pID = nullptr, uint nIDLength = 0);

3) パラメータ :

4) 戻り値

QueryFace()

1) 説明 : ベースデータベースのFaceIDを取得し、json形式で返します。 Char *は684K確保する必要があります。

2) 関数 : int QueryFace(void* dev, const void* pID, uint nIDLength, int nMode = 0);

3) パラメータ :

4) 戻り値

StaticFaceCompare()

1) 説明 : モジュールスナップショットによってインポートされた静的比較（断片化なし）

2) 関数 : int StaticFaceCompare(void* dev, void** ppResImage, uint* pResImageLength);

3) パラメータ :

4) 戻り値

StaticFaceCompareReturnImage()

1) 説明 : 静的比較（断片化なし）ホストコンピューターは画像をインポート

2) 関数 : int StaticFaceCompareReturnImage(void* dev, const void* pImage, uint nImageLength, void** ppResImage, uint* pResImageLength);

3) パラメータ :

4) 戻り値

StaticFaceCompareSlice()

1) 説明 : 製的比較

3) パラメータ :

4) 戻り値

AddFeature()

2) 関数 : int AddFeature(void* dev, const void* pID, uint nIDLength, const void* pFeature, uint nFeatureLength);

3) パラメータ :

4) 戻り値

QueryFeature()

1) 説明 : 基本データベースIDに従って特徴値を照会し、基本データベースIDを使用して、検索データベースの顔情報の顔特徴値を照会します。

2) 関数 : int QueryFeature(void* dev, const void* pID, uint nIDLength, void* pFeature, uint nFeatureLength);

3) パラメータ :

4) 戻り値

StartOnetoNumRecognize()

1) 説明 : 1:N 顔認証

2) 関数 : int StartOnetoNumRecognize(void* dev, int nRecMode, int nMulMode);

3) パラメータ :

4) 戻り値

StartOnetoNumRecognize()

1) 説明 : 1:N 顔認証

2) 関数 : int StartOnetoNumRecognize(void* dev, int nRecMode, int nMulMode);

3) パラメータ :

4) 戻り値

StartOnetoOneRecognize()

1) 説明 : 1:1の顔認識を開始します（断片化なし）

2) 関数 : int StartOnetoNumRecognize(void* dev, int nRecMode, int nMulMode);

3) パラメータ :

4) 戻り値

StartOnetoOneRecognizeSlice()

1) 説明 : 1：1の顔認識（断片化）を開始し、1：1の認識モードを開始すると、動的に切り替えることができます。

2) 関数 : int StartOnetoOneRecognizeSlice(void* dev, int nRecMode, int nMulMode, uint nImageTotalLength, uint nPosition,int isLastSlice, const void* pSliceData, uint nSliceDataLength);

3) パラメータ :

4) 戻り値

ResumeRecognize()

1) 説明 : 顔認識を継続する

2) 関数 : int ResumeRecognize(void* dev);

3) パラメータ :

4) 戻り値

PauseRecognize()

1) 説明 : 顔認識を一時停止します

2) 関数 : int PauseRecognize(void* dev);

3) パラメータ :

4) 戻り値

QueryRecognize()

1) 説明 : 顔認識ステータスの照会

2) 関数 : int QueryRecognize(void* dev);

3) パラメータ :

4) 戻り値

SetRecConfig()

1) 説明 : 顔認識の構成を設定する

2) 関数 : int SetRecConfig(void* dev, const void* pData, uint nDataLength, int nConfigType = 0);

3) パラメータ :

4) 戻り値

GetRecConfig()

1) 説明 : 顔認識構成を取得する

2) 関数 : int StartOnetoNumRecognize(void* dev, int nRecMode, int nMulMode);

3) パラメータ :

4) 戻り値

OpenAutoUploadFaceInfoInFrame()

2) 関数 : int OpenAutoUploadFaceInfoInFrame(void* dev);

3) パラメータ :

4) 戻り値

CloseAutoUploadFaceInfoInFrame()

1) 説明 : フレームデータスイッチへの認識結果をオフにする

2) 関数 : int CloseAutoUploadFaceInfoInFrame(void* dev);

3) パラメータ :

4) 戻り値

GetDeviceFaceID()

1) 説明 : IDリストの出力

2) 関数 : int GetDeviceFaceID(void* dev, void* pIDList, uint nIDListLength);

3) パラメータ :

4) 戻り値

SetRecognizeCount()

1) 説明 : 顔認証回数を設定する

2) 関数 : int SetRecognizeCount(void* dev, uchar nRecCount, uchar nLivingCount);nRecCount

3) パラメータ :

4) 戻り値

SetTemplateUpdate()

1) 説明 : テンプレートの更新を設定する。

設定を更新するたびに、モジュールを再起動して有効にする必要があることに注意してください。

2) 関数 : int SetTemplateUpdate(void* dev, uchar isUpdate);

3) パラメータ :

4) 戻り値

GetTemplateUpdate()

1) 説明 : テンプレートアップデートの取得

2) 関数 : int GetTemplateUpdate(void* dev, uchar* isUpdate); 3)parameter:

3) パラメータ :

4) 戻り値

SetQRCodeSwitch()

1) 説明 : QRコード認証パラメータの設定

2) 関数 : int SetQRCodeSwitch(void* dev, uchar isOpen, uchar interval);

3) パラメータ :

4) 戻り値

GetDeviceFaceLibraryNum()

1) 説明 : ベースライブラリ数を取得する

2) 関数 : int GetDeviceFaceLibraryNum(void* dev, uint *nFaceNum);

3) パラメータ :

4) 戻り値

GetSingleRecognize()

1) 説明 : 単一の認識結果を取得する。

ビデオで顔が検出された場合、認識結果が返されます。ビデオで顔が検出されない場合、返される文字列は空です。

2) 関数 : int GetSingleRecognize(void* dev, void* pData, uint nDataLength);

3) パラメータ :

4) 戻り値

RegisterRecoReportCb()

1) 説明 : コールバックレポート識別関数を登録する。

2) 関数 : void RegisterRecoReportCb(void* dev, CallBackPtr_t handler_func);

3) パラメータ :

4) 戻り値

RegisterTrackReportCb()

1) 説明 : コールバックレポート追跡関数を登録する。

2) 関数 : void RegisterTrackReportCb(void* dev, CallBackPtr_t handler_func);

3) パラメータ :

4) 戻り値

RegisterImageReportCb()

1) 説明 : コールバックを登録して画像関数を報告する。

2) 関数 : void RegisterImageReportCb(void* dev, CallBackPtr_t handler_func);

3) パラメータ :

4) 戻り値

RegisterFeatureReportCb()

1) 説明 : コールバックを登録して機能値関数をレポートする。

2) 関数 : void RegisterFeatureReportCb(void* dev, CallBackPtr_t handler_func);

3) パラメータ :

4) 戻り値

RegisterQRCodeReportCb()

1) 説明 : コールバックを登録してQRコード関数を報告する。

SetQRCodeSwitch関数を呼び出してQRコードレポートスイッチをオンにすると、コールバック関数はQRコードの結果データを受信できます

2) 関数 : int GetSingleRecognize(void* dev, void* pData, uint nDataLength);

3) パラメータ :

4) 戻り値

ビデオフレーム検証情報の例：

Device

Ping()

1) 説明 : デバイスの接続性をテストする

2) 関数 : int Ping(void* dev, const void* pTestData, uint nTestDataLength);

3) パラメータ :

4) 戻り値

UploadPackageSlice()

1) 説明 : アップグレードパッケージのアップロードを開始する。

2) 関数 : int UploadPackageSlice(void* dev, uint nPosition, const void* pPacketData, uint nPacketDataLength);

3) パラメータ :

4) 戻り値

GetDevModelAppVer()

1) 説明 : モジュールハードウェアのバージョン番号を取得する。

2) 関数 : int GetDevModelAppVer(void* dev, void* pModelVersion, uint nModelVersionLength);

3) パラメータ :

4) 戻り値

ApplyUpgrade()

1) 説明 : md5値を16進数に変換し、小文字のままにしてください。そうでない場合、デバイスはそれを認識しません。

2) 関数 : int ApplyUpgrade(void* dev, const void* pHashData, uint nHashDataLength);

3) パラメータ :

4) 戻り値

GetDeviceVersion()

1) 説明 : システムバージョン情報を照会する。

2) 関数 : int GetDeviceVersion(void* dev, void* pVersion, uint nLength);

3) パラメータ :

4) 戻り値

Reboot()

1) 説明 : システムを再起動する。

2) 関数 : int Reboot(void* dev, int nMode);

3) パラメータ :

4) 戻り値

SetUmodeToEngin()

1) 説明 : システムを再起動する（再起動時の非Uディスクファクトリモードの再起動に対応します）

2) 関数 : int SetUmodeToEngin(void* dev);

3) パラメータ :

4) 戻り値

Reset()

1) 説明 : システムを再起動する（再起動時の直接再起動に対応します）

2) 関数 : Restart the system (corresponding to the direct restart in reboot):

3) パラメータ :

4) 戻り値

Recovery()

1) 説明 : リセットする。

2) 関数 : int Recovery(void* dev, int nMode);

3) パラメータ :

4) 戻り値

GetDevSn()

1) 説明 : デバイスのSNを取得する

2) 関数 : int GetDevSn(void* dev, char nMode, void* pDevSn, uint nDevsnLength);

3) パラメータ :

4) 戻り値

GetDevModel()

1) 説明 : デバイスのモデルを取得する

2) 関数 : int GetDevModel(void* dev, void* pDevModel, uint nDevModelLength);

3) パラメータ :

4) 戻り値

GetCpuTemperature()

1) 説明 : CUP温度を照会する。

2) 関数 : int GetCpuTemperature(void* dev, uint* nTemperature);

3) パラメータ :

4) 戻り値

CloseAutoUploadAiInfo()

1) 説明 : 認識結果のシリアルポートデータのアクティブなレポートスイッチをオフにする。

2) 関数 : int CloseAutoUploadAiInfo(void* dev);

3) パラメータ :

4) 戻り値

OpenAutoUploadAiInfo()

1) 説明 : 認識結果のシリアルポートデータの自動レポートスイッチをオンにする。

2) 関数 : int OpenAutoUploadAiInfo(void* dev, char nUploadMode,char nImageMode);

3) パラメータ :

4) 戻り値