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

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

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

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

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

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

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

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

1.1 取付設置方法

1.2 廃棄方法

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3 現在画面に表示されている画像を顔認証用の画像として登録するために、Image 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の登録が解除されます。

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

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

3 現在画面に表示されている画像を顔認証用の画像として登録するために、Image 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の登録が解除されます。

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

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

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

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

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

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

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

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

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

1 Add base libraryを選択します。

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

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の登録が解除されます。

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

2 zipファイルを解凍し、"Android"フォルダ内の"SenseEngineCamera-demo-v4.0.8-debug.apk"をAndroid端末にインストールしてください。

3 以下のアプリケーションを起動します。

4 以下の画面が表示されることを確認し、ENTRYボタンを選択します。

1 Add base libraryを選択します。

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

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の登録が解除されます。

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

2 ADD USERを選択します。

3 現在画面に表示されている画像を顔認証用の画像として登録するために、Image 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の登録が解除されます。

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

1 1:Nを選択します。

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

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

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

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

4.1 各部名称

4.2 デバイスの仕様

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

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

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を選択します。

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

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

3 現在画面に表示されている画像を顔認証用の画像として登録するために、Image 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の登録が解除されます。

1 Add base libraryを選択します。

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

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の登録が解除されます。

以下の手順で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の場合

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

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

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

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

ここでは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:

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:

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

public interface IReceiveCallback {
 void onTracking(String data);// 追尾/認証結果
 void onVerify(String data);// 認証結果
 void onPhotoData(int trackId,String recognizeId,ByteBuffer rgbHeadpose,B yteBuffer rgbBackground,ByteBuffer irBackgroud);//認証した顔のスナップショット
 void onFeatureData(String traceId,ByteBuffer feature);// 認証したライブラリ内の人物のfeatureをアップロード }

3. Note

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

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

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

adb root
adb shell
chmod 777 ttyACM0

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) パラメータ :