1 / 41

2.0.0 Introduction

[日本語]開発者向けドキュメント

https://docs.japancv.co.jp/thundersdk/japanese-dev-documents

リリースノート

日付

バージョン

リリースノート

2021/4/15

2.0.0(beta)

SensePass、SenseThunderE、SenseThunderE-mini、SenseThunderAirにおける顔認証／温度検知などのAI機能を提供する。 顔認証アルゴリズム - 1:1顔認証 - 1:N顔認証 - 生体検知 - マスク検知 - サーバサイド顔認証 温度検知 - 温度検知 SenseLinkとの接続 - SenseLink Cloud 2.4.0に対応 - デバイス登録 - ユーザのログイン - データ同期化 - レコードアップロード - 構成情報の送信 ハードウェアコントロール - カメラコントロール - サーマルイメージングシステムコントロール - ドアコントロール（リレー、Wiegand）

2021/4/28

2.0.0

日本語ドキュメントの提供開始

Thunder SDKパッケージ

Thunder SDK Zipファイルには下記コンテンツがあります。ご確認ください。

開発者向けドキュメント
- ファイル名：

API仕様書

このドキュメントは、Thunder SDK APIの機能について説明しており、開発者が各型によって提供される特定の目的と機能を理解できるようにまとめられています。

バージョン

修正日

修正履歴

2.0.0

03/01/2021

初版

フィーチャーマネジメント

顔フィーチャーライブラリのマネジメント

クラスの説明

FeatureManagerProxy

メンバー関数の説明

int delete(int userId)

顔フィーチャーを削除

パラメータ

戻り値

削除が成功した場合に0を返す。そうでない場合は負の値を返す

例外

なし

byte[] getFeature(Bitmap avatar)

画像の顔フィーチャーを取得

パラメータ

戻り値

顔フィーチャーのbyte配列を返

例外

なし

int insert(int userId, byte[] feature)

フィーチャーライブラリの追加

パラメータ

戻り値

挿入操作が成功した場合に0を返す。そうでない場合は負の値を返す

例外

なし

QRコード

QRコードの内容を識別

機能類の説明

QRCodeDecoderProxy

LinkSDK

サンプルソフトウェア

ソフトウェアの主な機能の紹介

顔認証: 1:1認証、1:N認証、サーバー認証、QR コード認証、温度測定および検知
ハードウェア周辺機器の操作

[ENGLISH]dev-documents

https://docs.japancv.co.jp/thundersdk/english-dev-documents

Release Note

Thunder SDK Package Introduction

The Thunder SDK Package (zip file) has the contents shown below.

dev-documents
- : English version of the developer's manual.

API reference

This document, which describes the functions of a single type, is mainly for developers. The main purpose is to let developers understand the specific purpose and functions provided by each type.

SDK Authorization

Thunder SDK initiation and authorization

Description of functional types

WuKong

Description of Member Function

void init (Context context)

Initiation

Parameter

Return

None

Exception

None

void auth (String licFileName, boolean isLeafLic, String productName, PassModel modelConfig, IAuthCallback authCallback)

Authorization

Parameter

Return

None

Exception

None

void release ()

Release SDK resource

Parameter

None

Return

None

Exception

None

Feature Management

Face feature library management

Description of Class

FeatureManagerProxy

QR code

Identify the content of the QR code

Description of functional types

QRCodeDecoderProxy

Description of Member Function

String decodeQRCode(byte[] nv21, int w, int h)

Parse the QR code

Parameter

Return

The parsed QR code string

Exception

None

String decodeQRCode(Bitmap bitmap)

Parse the QR code

Parameter

Return

The parsed QR code string

Exception

None

LinkSDK

Encapsulation of SenseLink RESTful interface and Mqtt message push mechanism

Sample Software Introduction

Introduction to the main functions of the software

Face recognition: 1:1 verification, 1:N identification, server identification, QR code identification, temperature measurement + identification
Operate hardware peripherals
Access SenseLink

The running result is shown below:

Face Recognition

It includes 1:1 face verification, 1:N face identification, server-side identification, QR code identification, and temperature measurement + identification, as shown below:

1:1 Face Verification

The “1:1 Face verification" is a process of proving "you are you", which means that you already have someone's identity information to determine whether the person's face information in the camera view matches the existing identity information.

You need to add a photo of the target person before using it, as shown below:

Then enter the 1:1 matching

1:N Face Identification

The “1:N Face identification” refers to registering the set of face images to be recognized into the local face feature library, and comparing them with the set of face features in the face feature library when the camera acquires the face information to derive the identification result.

Build a facial feature database before using it, as shown below:

Then enter the 1:N identification

Server-side Identification

Server identification is also a 1:N recognition mode, which only replaces the local execution with the remote execution in the "face comparison" link. Since face features are stored on the server, you do not need to build the face feature library at this point, but just enter it directly, as shown below:

Please note that you, as a user, need to implement your own server comparison logic. Please refer to for details.

QR Code Identification

It features parsing of QR code content, placing the QR code in the preview screen to ensure clear imaging of the QR code, and if identification is successful, the QR code content will be displayed on the screen, as shown below:

Temperature Measurement + Identification

Through the Face recognition function and temperature measurement module, the face and thermodynamic diagram data are processed by the algorithm to get the final face temperature. Currently, the temperature measurement modules supported are Arrow module, Guide 120 module, and Guide 256 module. It should be noted that the final face temperature value may deviate depending on the ambient temperature, module model, and usage strategy.

The "Temperature Measurement+Identification" is equipped with a 1:N face feature library. So before using it, you need to go to 1:N Face Identification to set the face features, and then enter the "Temperature Measurement + Identification" function after the setting is completed.

Operate hardware devices

It’s compatible with some peripherals of Pass and Thunder series. The peripherals supported are shown in the following figure:

If newDeviceKey is true, it means the current device has not logged into SenseLink. Input the server address, account name, and password, then click login. If the following graph is shown, the login is successful.

Upload record and TSL model

Upload the record obtained from face recognition, QR code, and etc. to SenseLink. Upload TSL model to SenseLink. Please check the following graph for detail.

Senselinkとの連携

バージョン

改訂日

改訂内容

v1.1.0

2020/7/16

初稿

v1.2.1

2020/11/10

登録者データの同期化の使用法についての紹介を追加

LINK API について

Link APIは、SenseLinkプラットフォームのクラウド機能をカプセル化するための一連のインターフェースメソッドです。インターフェースメソッドには、プラットフォームRESTfulインターフェースのカプセル化と、プラットフォームのMqttメッセージのプッシュメカニズムのカプセル化の、主に2つのタイプがあります。プラットフォームが提供するクラウド機能を、一般的なJavaメソッドを呼び出すのと同じように使用することができます。＊JCVのSenselinkプラットフォームについて、下記リンクをご参照ください：

Link APIの使用

Link APIは主に、HttpApiClientとMqttApiClientの2つのコアタイプを提供しており、それぞれのタイプで提供されるメソッドを使用することでSenseLinkプラットフォームとの直接的な通信が実現できます。その方法を以下に紹介します。

HttpApiClient：プラットフォームのRESTful APIのカプセル化用であり、通信にはhttpプロトコルを使用し、共に同期化メソッドであるためワーカースレッドで使用する必要があります
MqttApiClient：プラットフォームメッセージのプッシュメカニズムのカプセル化用であり、通信にはMqttプロトコルを使用し、長距離通信を確立してメッセージのTopicにサブスクライブすることで、プラットフォームメッセージのプッシュを受信します

インターフェースメソッドに関するRESTful APIとMqtt Topicの詳細な定義については、「API仕様書」をご参照ください。

Link APIの初期化

Link APIは、統一された初期化エントリーを提供します。サーバーのURL、リクエストの読み込みと書き込みのタイムアウト、インターフェースから返される言語タイプなどを設定する必要があります。具体的な使用方法は以下の通りです。

初期化後、具体的なメソッドを呼び出して特定のサービスを実行できます。

RESTful APIのカプセル化方法

各RESTful APIインターフェースは、対応するJavaのメソッド実行をカプセル化します。具体的なエンティティークラスは、リクエストで要求されたパラメーターの受渡値とリクエストの結果データの両方によってカプセル化されています。例えば、認識レコードをアップロードするためにv2/recordリクエストを実行する場合、以下のように記述します。

以下のように、実行のための比較的シンプルなパラメーターを使用して、APIインターフェースに複数のパラメーターを直接受け渡すことができます。

デバイスのログイン操作

ユーザーIDに基づく詳細なユーザー情報の取得

「RESTful APIインターフェースの定義」と「APIとメソッド間の通信」の詳細については、API仕様書をご参照ください。

Mqttのプッシュメカニズムのカプセル化のメソッド

各MqttメッセージのプッシュTopicは、対応するJavaメソッドをカプセル化します。Topicにサブスクライブされるメッセージは、次のようにコールバックを登録することで受信されます。

サーバーとのMqtt長距離接続を以下のようにして確立します。

デバイスの登録者グループ変更にサブスクライブします

デバイスの登録者グループ変更のサブスクライブを解除します

「Mqtt Topic の定義」および「Topic のサブスクライブとメソッド間の通信」の詳細については、Thunder SDK API Documentをご参照ください。

主な使用プロセスについて

Link APIはSenselinkプラットフォームと簡単に通信する方法を提供しますが、一部の機能を使用する際には一定のプロセスステップに従わなければなりません。つまりRESTful APIインターフェースとMQTTトピックへのサブスクリプションの両方で、シーケンスに従う必要があります。以下、使用のシーケンスの観点から主要な機能の流れを中心に説明しています。

ログインと登録のステップ

SenseLinkプラットフォームの機能を利用するためには、ログインと登録操作が必要です。これにより、デバイスをプラットフォームに含めて一元管理することができます。通信プロセスの簡単な説明は以下の通りです。

主なステップの説明は以下の通りです。

（1）デバイスのログイン：最初にプラットフォームからパブリックキーを取得するためにv2/rsapubインターフェースをリクエストし、パブリックキーを使用してクリアテキストのパスワードを暗号化してログイン操作を行うためにv2/device/loginインターフェースをリクエストします。2つのステップはHttpApiClient.login()メソッドを使用することで完了します。このメソッドは、メソッドのパラメーターとしてアカウント番号、暗号化されたパスワード、デバイスのタイプとデバイスのDUIDのみを受け渡すだけで済みます。

トークン：全てのインターフェースのリクエストには、7日間有効なトークンを使用する必要があります。失効後は403エラーが返されますので、この場合は再度ログインして取得する必要があります。
newDeviceKey：trueの場合、現在のデバイスがプラットフォームの一元管理対象に含まれていないこと意味しますので、デバイス登録の操作を行う必要があります。

（2）デバイスの登録：登録を行うには、最初にv2/device/registerインターフェースをリクエストし、登録が完了した後にデバイスと登録者グループを結合するためにv2/device/group/defaultをリクエストする必要があります（以降の登録者データの配信管理のため）。2つのメソッドはHttpApiClient.register()メソッドを適用することで完了し、デバイス名、デバイスの場所、アクセスコントロールの入口と出口の方向などのパラメーターを受け渡す必要があります。

device ldid：プラットフォーム上のデバイスの一意の識別コードであり、デバイスを区別するために使用されます。
companyId：デバイスに対応する企業IDであり、各企業には複数の登録者グループがあります。

オブジェクトモデルの同期化戦略

オブジェクトモデル（TSL）に関する機能は、SenseLink2.3.0以降からサポートすています。これらの機能を使用する前に、サーバーのバージョン番号を特定する必要があります。サーバーがこれらの機能をサポートしていれば、予期しない例外が発生すること無くオブジェクトモデルを同期化することができます。この操作は構成の同期化の前にセットする必要があり、フローチャートは以下の図の通りです。

（1）オブジェクトモデルに関する機能がサーバーによってサポートされているかどうかを判断するために、HttpApiClient.getServerVersion()を呼び出して、現在接続されているサーバーのバージョン番号を取得します。サーバーのバージョン番号が2.3.0以上であれば、これらの機能はサポートされていますので、次の操作に進むことができますが、そうでない場合は（5）まで進んでください。

（2）ローカルオブジェクトモデルのMD5を計算し、入力パラメーターとしてHttpApiClient.checkTslExist()を呼び出して、フラグのゾーンビットを取得すると同時にクラウド上にローカルオブジェクトモデルが存在するかどうかをチェックします。flag==1の場合は、オブジェクトモデルがすでに存在していることを意味しますので、アップロードする必要はありません。そうでない場合はHttpApiClient.uploadTsl()を呼び出してオブジェクトモデルをアップロードします。

（3）HttpApiClient.checkTslLanguageExist(language)を呼び出します（zh：簡体字中国語、zh-tw：繁体字中国語、en：英語）。クラウド上に対応する言語パッケージが存在するかどうかをチェックし、クラウドの言語パッケージのゾーンビットとMD5を取得します。flag==1であり、かつクラウドの言語パッケージのMD5とローカルの言語パッケージのMD5が一致している場合は、言語パッケージがすでに存在しているということを意味しますので、アップロードする必要はありません。そうでない場合は、HttpApiClient.uploadTslLanguage()を呼び出して言語パッケージをアップロードします。

（4）言語パッケージが複数ある場合は、（3）のステップを繰り返します。

（5）構成の同期化に関する操作を行います。

デバイス構成の同期化戦略

デバイスの構成パラメーターは、2つの方法で設定することができます：UIインターフェースを介した設定と、SenseLinkクラウドを介した設定と発行です。通信の簡単な説明は以下の図の通りです。

（1）ユーザーが設定ページから構成を変更した後に、システムの設定モジュールが変更された構成パラメーターをバックグラウンドにアップロードし、最終的に構成の変更を送信します。

（2）バックグラウンドで構成が変更される際に、MQTTを介して構成変更のプッシュを送信します。通知を受信するとシステムの設定モジュールはHTTPを介して最新のサーバー構成を取得してデバイスの構成パラメーターを更新し、最終的に構成の変更を送信します。

（3）デバイス構成がバックグラウンドでリセットされると、MQTTを介してデフォルト構成の復元のプッシュを送信します。通知を受信するとシステム設定モジュールは全ての構成をリセットし、構成のリセットをバックグラウンドにアップロードして最終的に構成の変更を送信します。

登録者データの同期化戦略

登録者データの同期化とは企業の対応する登録者データをデバイス側がプラットフォーム側から取得することを意味し、データには主に登録者の基本情報と認証に必要な顔写真ライブラリが含まれます。データの同期化の通信プロセスの簡単な説明は次の通りです。

（1）デバイスのログインが完了し、Mqtt Brokerとの長距離のMqtt通信が確立された後に、「デバイスの登録者グループ変更Topic」へアクティブにサブスクライブする必要があります。サブスクライブの完了後、ただちにメッセージのプッシュを受信し、デバイスに属する全ての登録者グループの情報を取得することができます（キー項目は登録者グループのid）。Topicへのサブスクライブの解除は、データ受信後に行うことができます。

（2）（1）で全ての登録者グループのidが取得できたら、続けて「単一登録者グループ内の、全登録者データTopic」にサブスクライブし、サブスクライブが完了したら当該登録者グループの全ての登録者情報を取得することができます（キー項目はuser_idとimage_url）。Topicへのサブスクライブの解除は全グループの登録者情報の受信後に行うことができます。

（3）（2）で取得した user_idとimage_urlによって、RESTFulインターフェースを介して詳細な登録者情報とアバターを取得することができます。全ての登録者データを取得するには、このステップを繰り返す必要があります。

（4）登録者データの最初の取得後に、「単一の登録者グループ内の登録データ変更のTopic」にサブスクライブする必要があります。サブスクライブの完了後、ただちに登録者のインクリメントリストと変更タイプが返されますので、変更タイプに応じてデータを処理する必要があります。

{
  "engineVersion": "0.0.1",//エンジンのバージョン
  "modelVersion": "0.0.1", //モデルのバージョン
  "deviceType": "sps", // デバイスのタイプ
  "properties": [/*... */], // 機能の設定項目
  "status": [/*...*/]// デバイスの周辺機器の状態
}

{
  "properties": [{
    "name": "group-name",
    "fields": [{ // 設定項目集
      "key": { // 設定項目の名前の記述
        "name": "product_customer", // 名前
        "desc": "vendor-customer" // 名前を記述するために使用され、実用的な目的はありません
      },
      "value": {} // 設定項目の任意の値の記述
      ]
   }]
}

{
  "versionInfo": {
    "version": "0.0.1",
    "log": "",
    "updated": "2020-04-21 12:00:00"
  },
  "common": {
    "modelVersion": "Device model version"
  },
  "deviceTypes": {
    "sps": "SensePass"
  },
  "groups": {
    "general": "General Settings"
  },
  "fields": {
    "identify_mode": "identify_mode"
  },
  "values": {
    "enable": "Enable",
    "disable": "Disable"
  },
  "status": {
    "door_status": "Magnetism Status"
  }
}

{
  "engineVersion": "0.0.1",//エンジンのバージョン
  "modelVersion": "0.0.1", //モデルのバージョン
  "deviceType": "sps",
  "properties": [{
    "name": "features",
    "fields": [{
      "key": {
        "name": "identify_mode",
        "desc": "Enabled State"
      },
      "value": {
        "required": true, // 必須であるか否か。設定されていない場合、デフォルトは任意です。
        "type": "int", //データのタイプ、numeric、boolean、または string を設定する必要があります。
        "editable": true, // 編集可能であるか否か。設定されていない場合、デフォルトは編集不可です。
        /*
        ** UI のコンポーネントは次のタイプから設定する必要があります
        *** ナンバーピッカー：number
        *** ドロップダウンボックス：select
        *** 複数選択ボックス：checkbox
        *** ラジオボタン：radio
        *** タイムピッカー：date
        *** 1行のテキスト入力：text
        *** 複数行のテキスト入力：textarea
        *** 画像のアップロードと表示：image
        *** デフォルトは text です。
        */
        "ui": "select",
        "ranges": [{
          "min": 1,
          "max": 2,
          "enable": "{open_way}==2", //js expression string または boolean 値です。設定されていない場合はデフォルトで有効です。中括弧内のフィールドは差し替えられる値を示しています（open_wayの値が2の場合、式は"2==2"と解析されます）。
          "default": 1.5
        },{
          "min": 3,
          "max": 4,
          "enable": "{open_way}==3",//js expression stringまたはBoolean値です。設定されていない場合はデフォルトで有効です。
          "default": 3.5
        }],
        "step": 0.5,//値のみに対するステップのサイズです。
        "precision": 1,//精密さ。小数位の正確な数、非負整数を示し、数値に対してのみ有効であり、任意です。
        "mult": true, //複数選択か否か、任意。設定されていない場合、引渡されるパラメーターはデフォルトで単一値です。複数値はドロップダウンと複数選択ボックスに対してのみ有効です。
        "enable": "{open_way}==1", // js expression stringまたはboolean値であり、任意です。リンケージ制御によるフィールドの表示・非表示を示します。enableプロパティが設定されていない場合はデフォルトで有効です。
        "size": 20, // 文字列の長さ、任意です。stringとimage base64に対してのみ有効です。
        "timeFormat": "yyyy-MM-dd HH:mm:ss", //uiがdateの場合、日付形式を設定する必要があります。hhは12時間を意味し、HHは24時間を意味します。
        "options": [{
          "value": 0,
          "name": "off",
          "enable": "{open_way}==2", // js expression stringまたはboolean値です。trueを返し、これは選択された値が候補項目で使用可能であることを意味します。enableプロパティが設定されていない場合はデフォルトで有効です。
        }, {
          "value": 1,
          "name": "on", // js expression stringまたはboolean値です。trueを返し、これは選択された値が候補項目で使用可能であることを意味します。enableプロパティが設定されていない場合はデフォルトで有効です。
          "enable": "{open_way}==3"
        }],
        //watch: ステータスのlisten状態であることを意味します。
        /*
        ** 以下の例は、現在のフィールドの値がuse_modeに関連していることを意味します。
        ** use_modeが変更されると、現在のフィールドの値は式が実行された後の値になります "{use_mode}==2?1.5:{use_mode}==1?2:{recognition_distance}"
        */
        "watch":{
          "use_mode": "{use_mode}==2?1.5:{use_mode}==1?2:{recognition_distance}"
        }
      },
    }]
  }],
  "status": [{
    "name": "wifi",
    "enable": true, // js expression stringまたはboolean値です。このフィールドの表示条件を制御します。enableプロパティが設定されていない場合はデフォルトで有効です。
    "options": [{
      "value": 0,
      "name": "off",
      "enable": "{open_way}==2", // js expression stringまたはboolean値です。trueを返し、これは選択された値が候補項目で使用可能であることを意味します。enableプロパティが設定されていない場合はデフォルトで有効です。
    },{
      "value": 1,
      "name": "on",
      "enable": "{open_way}==1", // js expression stringまたはboolean値です。trueを返し、これは選択された値が候補項目で使用可能であることを意味します。enableプロパティが設定されていない場合はデフォルトで有効です。
    }],
  }]
}

// 初期化   
LinkSDKHelper.getInstance().init(“https://link.japancv.co.jp/sl/”, this)
         .setConnectTimeout(10 * 1000)
         .setReadTimeout(30 * 1000)
         .setWriteTimeout(10 * 1000)
         .setLanguage(LinkSDKHelper.LanguageTypeEnum.ZH)  // サーバーから返される情報の言語を設定します
         .addInterceptor(new ResponseInterceptor())  // インターセプターを設定します
         .setDebug(true);

    // パラメーターエンティティクラス
    RecordParameter recordParameter = new RecordParameter();
    recordParameter.setUserId(2547);
    recordParameter.setMode(2);
    recordParameter.setSignTime((int) (System.currentTimeMillis() / 1000));
    recordParameter.setType(1);
    recordParameter.setInTime(0);
    recordParameter.setEntryMode(1);
    Bitmap bitmap = BitmapFactory.decodeStream(mAppContext.getAssets().open("test.jpg"));
    recordParameter.setUsername("testUserName");
    // 誤ったbase64 文字列をアップロードするとエラーが発生します
    recordParameter.setSignBgAvatar(Base64Utils.bitmapToBase64(bitmap));
    recordParameter.setSignAvatar(Base64Utils.bitmapToBase64(bitmap));
    recordParameter.setDocPhoto(Base64Utils.bitmapToBase64(bitmap));
    recordParameter.setIcNumber("235113");
    recordParameter.setIdNumber("460003199809086744");

    // 特定のリクエストを実行するためにカプセル化されたメソッドの呼び出します。結果はリクエスト結果の統合されたラッパークラスを指します。
    Result<RecordResult> recordResultResult = HttpApiClient.uploadRecord(recordParameter);
    if(recordResultResult.isSuccess()){
        // リクエスト結果データの取得と処理です。RecordResult は、リクエスト結果データのエンティティクラスを指します。
            RecordResult body = recordResultResult.getBody(RecordResult.class);
        // todo: 具体的な操作の実行。
  } else {
          // リクエストの例外です。詳細についてはSenseLink APIのドキュメントをご参照ください
  }
}

// リクエストパラメーター
// 同期化メソッドの呼び出しです。ワークスレッドで実行する必要があります
Result<LoginResult> loginResult = HttpApiClient.login(
                                  "account", "password", "SPS", AppUtils.getAndroidId(ContextUtils.getContext()));

MqttApiClient.connectMqtt(new IMqttActionListener() {

      @Override
      public void onSuccess(IMqttToken iMqttToken) {
        // 接続成功
      }

      @Override
      public void onFailure(IMqttToken iMqttToken, Throwable throwable) {
        // 接続失敗
      }

    }, new IConnectionLost() {

      @Override
      public void onConnectionLost(Throwable cause) {
               // 接続が切断されました
      }
});

    // 登録者グループ変更にサブスクライブします
    MqttApiClient.registerGroupChangeListener(new MessageCallback() {

       @Override
       public void success(MqttMessage msg) {

                 // json データがプッシュメッセージの本文です。
                  String json = new String(msg.getPayload());
              // バックグラウンドでデバイスを削除し、空の文字列を処理せずにプッシュします。
            if (TextUtils.isEmpty(json)) {
                    return;
            }

            // データを取得します。Group classはメッセージデータに対応するエンティティクラスです。
            Pair<List<Group>, Boolean> pushGroupList =
                                          DataConverter.convertJsonToGroupList(json);
            // 具体的な業務に従ってデータを処理します
         }

       @Override
       public void error(int code, String msg, Throwable throwable) {
                         // サブスクリプト例外／メッセージプッシュ例外
       }
    });

Introduction to Thing Specification Language

The Thing Specification Language (TSL) refers to a description file provided for the configuration between the end-side and the server, which is used to describe the configuration items supported by the end-side and the constraints corresponding to the configuration items.

Overview

The SenseLink platform supports devices to define the TSL. The data model consisting of the configuration (properties, status) of the actual device facilitates the management of the device through the cloud.

Function Type

TSL

TSL is a JSON format file that is reported by the device when it first accesses SenseLink and is stored in the backend. As you open the details of a device on the web, the web can then dynamically load the TSL and TSL values corresponding to the device. This allows you to ensure consistency between the remote configuration function in the cloud and the local function of the device without upgrading the backend service.

TSL Usage Flow

1.Add TSL to the app and complete the creation based on TSL Data Structure 2.Create the required language pack. For its format, please see TSL internationalization. 3.After completing the development, you can report properties and events on the device, and set properties and invoke services on the cloud, and view the interface call steps Update Process 4.The attributes, events and completed service call data reported from the device will be displayed on the Device Settings tab of Device Details page of the corresponding device in the SenseLink console after passing the data verification.

TSL Structure

TSL is a json file, which contains the parameters such as "engineVersion", "modelVersion", "deviceType" at the top level. The "properties" and "status" are the settings for the above parameters.

Properties

Properties is composed of several modules, each containing multiple set items. Each setting item, also known as fields element, is a description and function definition for each setting item.

Field is composed of key and value. Key describes the name of the configuration item, and Value is the definition including the optional value, style, status of the configuration item. The following is an explanation of some fields. For more configuration, please see [TSL data structure] (# TSL data structure).

type: required, the type of the configuration item value, which can be int, float, string, boolean and others

ranges: optional, to express the interval of the value when the type is int, float, etc., including min: minimum value, max: maximum value, default: default value.

ui: optional, default as text, used to indicate web/device input control style.

List of available values for ui:

options: optional, used when Value is exhaustible (such as wiegand32, wiegand34, and wiegand2602), generally used with select for ui.

Status

Refers to the status of a peripheral component of a device. The platform only reads and does not write, and only maintains the latest state. The JSON file contains name, enable, and options, corresponding to the name, display or not, and optional values. For more information, please see [TSL data structure] (# TSL data structure).

TSL Internationalization

Defines the display names of device types, attributes, and status of all TSL in the system on the device/web, and stores them separately by different languages. TSL internationalization is to explain the TSL values and names in layman's terms for the cloud console and reduce the difficulty of operation. Each language pack is composed of files in JSON format, and the corresponding Key is a translation for the corresponding part of the TSL.

For more information on data structure, please see Data structure of language pack.

Appendix

Update Process

Data structure of language pack

An example of the data structure of the language pack is as follows.

TSL Data Structure

An example of the JSON field structure for TSL is as follows:

Senselink connection

Version

Revision Date

Revision Content

v1.1.0

7/16/2020

First Draft

v1.2.1

2020/11/10

Add an introduction to the usage of personnel data synchronization

An introduction of Link API

Link API is a series of interface methods for cloud capability encapsulation of SenseLink platform (For JCV Senselink Cloud, please refer to (Japanese only)). There are two major types of interface methods, one is encapsulation for the platform RESTful interface, and the other is encapsulation for the platform’s Mqtt message push mechanism. Users can use the cloud capability provided by the platform just like calling common Java methods.

Use of Link API

The Link API mainly provides two core types, namely, HttpApiClient and MqttApiClient, and by using the methods provided by these two types, direct communication with the SenseLink platform can be achieved. The brief introduction is as follows:

HttpApiClient: For encapsulation of platform RESTful API, use Http protocol for communication, both are synchronized methods and need to be used in the worker thread;
MqttApiClient: For encapsulation of the platform message push mechanism, use Mqtt protocol for communication, and receive platform message push by establishing a long connection and subscribing to the message Topic.

For the detailed definition of the RESTful API interface and Mqtt Topic involved in the interface method, please refer to the "Thunder SDK API Document".

Initialization of Link API

Link API provides a unified initialization entry, you need to set the Url of the server, the read and write timeout of the request, the language type returned by the interface, etc. The specific use is as follows:

After initialization, specific methods can be called to perform specific services.

RESTful API encapsulation method

Each RESTful API interface encapsulates the corresponding Java method execution. Specific entities class was encapsulated by both the parameter passing value required by the request and the result data of the request. For example, when executing the v2/record request to upload the identification record

Multiple parameters can be passed in directly to the API interface with relatively simple parameters for execution, specified as below:

Device login operation

Get detailed user information based on the user ID

For more details on "RESTful API interface definition" and "correspondence between API and methods", please refer to the Thunder SDK API Document .

Mqtt push mechanism encapsulation method

Each Mqtt message push Topic encapsulates the corresponding Java method. Topic subscribed messages are received by registering callbacks, specified as below

Establish a Mqtt long connection with the server, shown as below:
Subscribe to the personnel group change of the device

Unsubscribe to the personnel group change of the device

For more details on "Mqtt Topic definition" and "correspondence between topic subscribe and methods", please refer to the Thunder SDK API Document.

Introduction of key use processes

Link API provides easy communication with Senselink platform, however, certain process steps need to be followed while using some functions, in other words, both the use of RESTful API interface and the subscriptions to MQTT topics follow a sequence. Below mainly describes the main functional flow steps from the perspective of the sequence of use.

Login and registration operations are required to use the functions of SenseLink platform, so that device can be included into the platform for unified management. A brief communication process is stated as follows:

The main steps are described below:

(1) Device login: request v2/rsapub interface to obtain a public key from the platform first, then use the public key to encrypt the cleartext password, and then request v2 /device/login interface for login operation. The two steps are completed by using the HttpApiClient.login () method, which only needs to pass in the account number, encrypted password, device type and device DUID as method parameters.

token: all interface requests need to use token, which is valid for 7 days. After expiration, 403 error will be returned, in this case, you need to log in again to obtain it;
newDeviceKey: If it is true, it means that the current device has not been included in the unified management of the platform, in this case, device registration operation needs to be performed.

(2) Device registration: the v2/device/register interface should be requested first for registration, and then the v2/device/group/default interface should be requested to bind the device and personnel group after successful registration (for subsequent personnel data distribution management). The two steps are completed by applying HttpApiClient.register () method, and parameters such as device name, device location, entrance and exit direction of access control need to be passed in.

device ldid: the unique identification code of the device on the platform, which is used to distinguish device;
companyId: the company id corresponding to the device, and each company has several personnel groups.

Synchronization strategy of object model

Object model (TSL. Please refer to "tsl-dev-manual-en" in SDK documentation for intorduction.) related functions are only supported in SenseLink 2.3.0 and above versions. You need to determine the version number of the server before using these functions. On the premise that the server supports these functions, object model can be synchronized without unexpected exceptions. This operation should be placed before the configuration synchronization, the flow chart is shown in the figure below

(1) Get the version number of the currently connected server by calling HttpApiClient.getServerVersion() to determine whether or not object model related functions are supported by the server. If the version number of the server is greater than or equal to 2.3.0, these functions are supported and you can continue the subsequent operations, otherwise skip directly to step (5);

(2) Calculate the MD5 of the local object model, and call HttpApiClient.checkTslExist() as an input parameter to get the flag zone bit and check whether the local object model exists in the cloud at the same time. When flag==1, it means that the object model already exists and does not need to be uploaded. Otherwise, call HttpApiClient.uploadTsl() to upload the object model;

(3) Call HttpApiClient.checkTslLanguageExist( language ) (zh: Simplified Chinese, zh-tw: Traditional Chinese, en: English) Check whether there is a corresponding language package in the cloud, and get the zone bit and MD5 of the cloud language package. When flag==1 and the MD5 of the cloud language package is consistent with the MD5 of the local language package, it means that the language package already exists and does not need to be uploaded. Otherwise, call HttpApiClient.uploadTslLanguage() to upload the language package;

(4) If there are multiple language packages, repeat step (3);

(5) Perform related operations for configuration synchronization.

Device configuration synchronization strategy

There are two ways to set device configuration parameters: set through the UI interface and set and issue via SenseLink cloud. The brief communication is shown in the figure below:

(1) After the user modifies the configuration through the setting page, the system setting module will upload the modified configuration parameters to the background, and finally broadcast the configuration change;

(2) When the configuration is modified in the background, it will send a configuration change push through MQTT. After receiving the notification, the system setting module will obtain the latest server configuration through HTTP, update the device configuration parameters, and finally broadcast the configuration change;

(3) When the device configuration is reset in the background, it will send a restore default configuration push through MQTT. The system setting module will reset all configurations after receiving the notification, upload the reset configuration to the background, and finally broadcast the configuration change.

Personnel data synchronization strategy

Personnel data synchronization means that the device side obtains the company's corresponding personnel data from the platform side, the data mainly includes the basic information of the personnel and the face photo library required for recognition. The brief communication process of data synchronization is as follows:

(1) After the device logs in successfully and establishes a long Mqtt connection with Mqtt Broker, you need to actively subscribe to the "Device Personnel Group Change Topic". After subscribing, you can immediately receive the message push and obtain all the personnel group information belonging to the device (the key field is the id of the personnel group). You can unsubscribe to the Topic after receiving the data;

(2) With all the personnel group ids obtained in (1), continue to subscribe to "Topic of personnel data under the single personnel group", after subscribing, all personnel information of this personnel group can be obtained (key fields are user_id and image_url). You can unsubscribe to the Topic after receiving the personnel information of all groups;

(3) With the user_id and image_url obtained in (2), detailed personnel information and avatars can be obtained through the RESTFul interface. This step needs to be repeated to obtain all the personnel data;

(4) After initial acquisition of personnel data, it is necessary to subscribe to the "Topic of personnel data change under the single personnel group". After the subscription, the personnel increment list and the change type will be returned immediately, then you need to process the data correspondingly according to the change type.

{
  "engineVersion": "0.0.1",//Engine version
  "modelVersion": "0.0.1", //Model version
  "deviceType": "sps", // Device type
  "properties": [/*... */], // Function configuration items
  "status": [/*...*/]// Device peripheral status
}

{
  "properties": [{
    "name": "group-name",
    "fields": [{ // Collection of configuration items
      "key": { // Description of the name of configuration items
        "name": "product_customer", // Name
        "desc": "vendor-customer" // used to describe name, with no real purpose
      },
      "value": {} // Description of optional values for configuration items
      ]
   }]
}

{
  "versionInfo": {
    "version": "0.0.1",
    "log": "",
    "updated": "2020-04-21 12:00:00"
  },
  "common": {
    "modelVersion": "Device model version"
  },
  "deviceTypes": {
    "sps": "SensePass"
  },
  "groups": {
    "general": "General Settings"
  },
  "fields": {
    "identify_mode": "identify_mode"
  },
  "values": {
    "enable": "Enable",
    "disable": "Disable"
  },
  "status": {
    "door_status": "Magnetism Status"
  }
}

{
  "engineVersion": "0.0.1",//Engine version
  "modelVersion": "0.0.1", //Model version
  "deviceType": "sps",
  "properties": [{
    "name": "features",
    "fields": [{
      "key": {
        "name": "identify_mode",
        "desc": "Enabled State"
      },
      "value": {
        "required": true, // required or not. It’s non-required by default if not set.
        "type": "int", //data type, must be set, including numeric, boolean, and string.
        "editable": true, // Editable or not. It cannot be edited by default if not set, 
        /*
        ** UI components must be set with the following types
        *** Number picker number
        *** Drop-down box select
        *** Multi-select box checkbox
        *** Radio button radio
        *** Time picker date
        *** Single line text input text
        *** Multi-line text input textarea
        *** Image upload and display image
        *** Default is text
        */
        "ui": "select",
        "ranges": [{
          "min": 1,
          "max": 2,
          "enable": "{open_way}==2", //js expression string or boolean value. It is enabled by default if not set. The fields in curly braces indicate the value to be replaced, e.g. if the open_way value is 2, the expression is parsed as "2==2".
          "default": 1.5
        },{
          "min": 3,
          "max": 4,
          "enable": "{open_way}==3",//js expression string or Boolean value. It is enabled by default if not set.
          "default": 3.5
        }],
        "step": 0.5,// Step size, only for values
        "precision": 1, // Precision, indicates the exact number of decimal places, non-negative integer, and works only for numeric values, not required
        "mult": true, //multiple-choice or not, not required. The passing parameter is a single value by default if it’s not set. Multiple values only work for dropdown and multi-select boxes.
        "enable": "{open_way}==1", // js expression string or boolean value, not required, indicates the display and hiding of the field via linkage control. If the enable property is not set, it is available by default.
        "size": 20, // string length, not required, only works for string and image base64
        "timeFormat": "yyyy-MM-dd HH:mm:ss", //if ui is date, the time format must be filled in. hh means 12 hours, HH means 24 hours
        "options": [{
          "value": 0,
          "name": "off",
          "enable": "{open_way}==2", // js expression string or boolean value. Returns true, indicating that the selected value can be used in the candidate item. If the enable property is not set, it is available by default.
        }, {
          "value": 1,
          "name": "on", // js expression string or boolean value. Returns true, indicating that the selected value can be used in the candidate item. If the enable property is not set, it is available by default.
          "enable": "{open_way}==3"
        }],
        //watch: indicates status listening
        /*
        ** The following example indicates that the value of the current field is associated with the use_mode field.
        ** When the use_mode field changes, the value of the current field is equal to the value after the expression is executed "{use_mode}==2?1.5:{use_mode}==1?2:{recognition_distance}"
        */
        "watch":{
          "use_mode": "{use_mode}==2?1.5:{use_mode}==1?2:{recognition_distance}"
        }
      },
    }]
  }],
  "status": [{
    "name": "wifi",
    "enable": true, // js expression string or boolean value. Controls the display condition of this field. If the enable property is not set, it is available by default.
    "options": [{
      "value": 0,
      "name": "off",
      "enable": "{open_way}==2", // js expression string or boolean value. Returns true, indicating that the selected value can be used in the candidate item. If the enable property is not set, it is available by default.
    },{
      "value": 1,
      "name": "on",
      "enable": "{open_way}==1", // js expression string or boolean value. Returns true, indicating that the selected value can be used in the candidate item. If the enable property is not set, it is available by default.
    }],
  }]
}

// Initialize   
LinkSDKHelper.getInstance().init(“https://link.japancv.co.jp/sl/”, this)
         .setConnectTimeout(10 * 1000)
         .setReadTimeout(30 * 1000)
         .setWriteTimeout(10 * 1000)
         .setLanguage(LinkSDKHelper.LanguageTypeEnum.ZH)  // Set the language of return information from the server
         .addInterceptor(new ResponseInterceptor())  // Set interceptors
         .setDebug(true);

    // Parameter entity class
    RecordParameter recordParameter = new RecordParameter();
    recordParameter.setUserId(2547);
    recordParameter.setMode(2);
    recordParameter.setSignTime((int) (System.currentTimeMillis() / 1000));
    recordParameter.setType(1);
    recordParameter.setInTime(0);
    recordParameter.setEntryMode(1);
    Bitmap bitmap = BitmapFactory.decodeStream(mAppContext.getAssets().open("test.jpg"));
    recordParameter.setUsername("testUserName");
    // Error occurs when uploading incorrect base64 string
    recordParameter.setSignBgAvatar(Base64Utils.bitmapToBase64(bitmap));
    recordParameter.setSignAvatar(Base64Utils.bitmapToBase64(bitmap));
    recordParameter.setDocPhoto(Base64Utils.bitmapToBase64(bitmap));
    recordParameter.setIcNumber("235113");
    recordParameter.setIdNumber("460003199809086744");

    // Call the encapsulated method to execute the specific request. Result refers to the unified wrapper class for the result of the request
    Result<RecordResult> recordResultResult = HttpApiClient.uploadRecord(recordParameter);
    if(recordResultResult.isSuccess()){
        // Get the request result data and process it, RecordResult refers to the entity class of the request result data
            RecordResult body = recordResultResult.getBody(RecordResult.class);
        // todo: the execution of specific operations
  } else {
          // Request exception. Please see the SenseLink API documentation for details
  }
}

// Request parameters
// Synchronize method calls, which need to be executed in the work thread
Result<LoginResult> loginResult = HttpApiClient.login(
                                  "account", "password", "SPS", AppUtils.getAndroidId(ContextUtils.getContext()));

MqttApiClient.connectMqtt(new IMqttActionListener() {

     @Override
     public void onSuccess(IMqttToken iMqttToken) {
       // Connection successful
     }

     @Override
     public void onFailure(IMqttToken iMqttToken, Throwable throwable) {
       // Connection failed
     }

   }, new IConnectionLost() {

     @Override
     public void onConnectionLost(Throwable cause) {
              // Connection lost
     }
});

    // Subscribe to the personnel group change
    MqttApiClient.registerGroupChangeListener(new MessageCallback() {

       @Override
       public void success(MqttMessage msg) {

                 // json data is the body of the push message.
                  String json = new String(msg.getPayload());
              // Delete the device in the background and push an empty string without processing.
            if (TextUtils.isEmpty(json)) {
                    return;
            }

            // Get the data. Group class is the entity class corresponding to the message data.
            Pair<List<Group>, Boolean> pushGroupList = 
                                          DataConverter.convertJsonToGroupList(json);
            // Process data according to specific business
         }

       @Override
       public void error(int code, String msg, Throwable throwable) {
                         // Subscription exceptions / Message push exceptions
       }
    });

Thermal imaging system

Used in traffic scenes, support Thermal imaging system preview and get the data recall, manage its the lifecycle, monitor its status, and auto co

Description of functional types

TemperatureCameraFactory

Get different instances for Thermal imaging system

Description of Member Function

ITemperatureCamera getTemperatureCamera(CameraType type)

Get Thermal imaging system

Parameter

Return

ITemperatureCamera

Current Type

Exception

None

ITemperatureCamera

Operate Thermal imaging system

Description of Member Function

boolean matrixTemperature(float[] y16Frame, int y16W, int y16H, float distance, int x, int y, int w, int h, float[] tempArray)

Batch Conversion of Temperature

Parameter

Return

Exception

None

float getCentigradeFromTemperatureData(float temperatureData)

Get Centigrade from Temperature Data

Parameter

Return

Centigrade Value

Exception

None

float getCameraBodyTemperature()

Get Camera Body Temperature

Parameter

None

Return

Camera Body Temperature

Exception

None

void addTemperaturePreviewDataCallback(ITemperaturePreviewDataCallback callback)

Add Thermal imaging system Preview Data Callback

Parameter

Return

None

Exception

None

void initCamera(Context context)

Initialize Thermal imaging system

Parameter

Return

None

Exception

None

void releaseCamera()

Release Thermal imaging system

Parameter

None

Return

None

Exception

None

void removeTemperaturePreviewDataCallback(ITemperaturePreviewDataCallback callback)

Remove Temperature Preview Data Callback

Parameter

Return

None

Exception

None

void startPreview(TextureView textureView)

Start Preview

Parameter

Return

None

Exception

None

void stopPreview()

Stop Preview

Parameter

None

Return

None

Exception

None

void setConfig(TemperatureCameraConfig config)

Thermal imaging system Configuration

Parameter

Return

None

Exception

None

void setAutoShutterEnable(boolean enable)

Set Auto Shutter Enable

Parameter

Return

None

Exception

None

void shutter()

Open Shutter

Parameter

None

Return

None

Exception

None

Description of Entities

ITemperaturePreviewDataCallback

Preview Data Callback

Description of Method

void onTemperaturePreviewData(Bitmap temperatureBitmap, float[] temperatureValue, int width, int height)

Temperature Preview Data Callback: Thermal imaging system outputs the image orientation as the same as its phisical orientation. For example, the human face will output with the vertical orientation.

Parameter

TemperatureCameraConfig

Thermal imaging system Configuration

Description of Properties

CameraType

Thermal imaging system Type(Enumeration Type)

Description of Properties

HttpApiClient

HTTPインターフェースの実装

HttpApiClient

メンバー関数

説明

導入バージョン

byte[] getImage(int type, String imageId)

画像データを取得

2.0.0

メンバー関数の説明

byte[] getImage(int type, String imageId)

図データを取得

パラメータ

戻り値

画像データ

例外

なし

ConnectConfigEntity getConnectConfigEntity()

現在接続構成を取得

パラメータ

なし

戻り値

ConnectConfigEntity

例外

なし

Result alarmReport(AlarmReportParameter reportParameter)

アラートをレポート

パラメータ

戻り値

Result

例外

なし

Result bindDefaultGroup()

デフォルトグループをバンドル

パラメータ

なし

戻り値

Result

例外

なし

Result checkPasswordUseLoginInterface(String password)

パスワードを検証

パラメータ

戻り値

Result

例外

なし

Result checkTslExist(String md5)

Tslが存在するかをチェック

パラメータ

戻り値

Result<TslCheckExistResult>

例外

なし

Result checkTslLanguageExist(String lang)

Tslの言語パッケージが存在するかをチェック

パラメータ

戻り値

Result<TslLanguageCheckExistResult>

例外

なし

Result faceSearch(FaceSearchParameter searchParameter)

サーバの識別

パラメータ

戻り値

Result<FaceSearchResult>

例外

なし

Result> getGroupIndexList()

当該デバイスにバンドルされるグループインデックスリストを取得

パラメータ

なし

戻り値

Result<GroupIndex>

例外

なし

Result> getUserIndexList(int groupId)

グループでのユーザーインデックスリストを取得

パラメータ

なし

戻り値

Result>

例外

なし

Result> getUserInfoList(UserInfoParameter parameter)

ユーザー情報リストを取得

パラメータ

戻り値

Result>

例外

なし

Result getServiceConfigJson()

サーバ構成を取得

パラメータ

なし

戻り値

Result

例外

なし

Result getAllGroupList()

当該デバイスにバンドされるグループリストを取得

パラメータ

なし

戻り値

Result<DeviceGroups>

例外

なし

Result getDeviceDetailInfo()

デバイスの情報詳細を取得

パラメータ

なし

戻り値

Result<DeviceDetailInfo>

例外

なし

Result getCompanyInfo()

企業情報を取得

パラメータ

なし

戻り値

Result<Company>

例外

なし

Result getUserInfo(long id)

ユーザーの詳細情報を取得

パラメータ

戻り値

Result<UserDetailInfo>

例外

なし

Result getGuestInfo(long id)

ユーザーの詳細情報を取得

パラメータ

戻り値

Result<GuestDetailInfo>

例外

なし

Result getServerVersion()

サーバのバージョンを取得

パラメータ

なし

戻り値

Result<ServerVersion>

例外

なし

Result getPassTimeTable(long timetableId)

アクセスタイムテーブルを取得

パラメータ

戻り値

Result<TimeTable>

例外

なし

void logout()

ログアウト

パラメータ

なし

戻り値

なし

例外

なし

Result identifyQRCode(IdentifyQRCodeParameter parameter)

QRコード認識インターフェース

パラメータ

戻り値

Result<QRResult>

例外

なし

デバイスのログイン

パラメータ

戻り値

Result<LoginResult>

例外

なし

Result register( RegisterParameter registerParameter)

デバイスを登録

パラメータ

戻り値

Result<RegisterResult>

例外

なし

Result reportUserStatus(UserStatusParameter userStatusParameter) )

ローカルデータベースでのユーザー異常ステータスをアップロード

パラメータ

戻り値

Result

例外

なし

Result reportUserStatus(UserSyncStatusParameter userSyncStatusParameter)

ローカルデータベースでのユーザー異常ステータスをアップロード

パラメータ

戻り値

Result

例外

なし

void refreshConnectConfig(ConnectConfigEntity connectConfig)

接続構成をリロード

パラメータ

戻り値

なし

例外

なし

Result reportDeviceEvent(DeviceReportEventParamer param)

デバイスイベントをレポート

パラメータ

戻り値

Result

例外

なし

Result uploadRecord(RecordParameter recordParameter)

識別レコードをアップロード

パラメータ

戻り値

Result<RecordResult>

例外

なし

Result uploadDeviceVersionInfo(DeviceVersionInfoParameter deviceInfoParameter)

デバイスバージョンをアップロード

パラメータ

戻り値

Result

例外

なし

Result uploadConfig(String deviceConfigKey, Object config)

構成をアップロード

パラメータ

戻り値

Result

例外

なし

Result uploadTsl(TslUploadParameter parameter))

Tslをアップロード

パラメータ

戻り値

Result

例外

なし

Result uploadTslLanguage(TslLanguageUploadParameter parameter)

Tsl言語パッケージをアップロード

パラメータ

戻り値

Result

例外

なし

HttpApiClient

HTTP interface implementation

HttpApiClient

Member Function

Description

Version Introduced

byte[] getImage(int type, String imageId)

Get Image Data

Description of Member Function

byte[] getImage(int type, String imageId)

Get Image Data

Parameter

Return

Image Data

Exception

None

ConnectConfigEntity getConnectConfigEntity()

Get Current Connection Configuration

Parameter

None

Return

ConnectConfigEntity

Exception

None

Result alarmReport(AlarmReportParameter reportParameter)

Alarm Report

Parameter

Return

Result

Exception

None

Result bindDefaultGroup()

Bind Default Group

Parameter

None

Return

Result

Exception

Result checkPasswordUseLoginInterface(String password)

Check Password

Parameter

Return

Result

Exception

None

Result checkTslExist(String md5)

Check Tsl Exist

Parameter

Return

Result<TslCheckExistResult>

Exception

None

Result checkTslLanguageExist(String lang)

Check Tsl Language Exist

Parameter

Return

Result<TslLanguageCheckExistResult>

Exception

None

Result faceSearch(FaceSearchParameter searchParameter)

Server Identification

Parameter

Return

Result<FaceSearchResult>

Exception

None

Result> getGroupIndexList()

Get Group Index List Bound to the device

Parameter

None

Return

Result<GroupIndex>

Exception

None

Result> getUserIndexList(int groupId)

Get User Index List in a Group

Parameter

None

Return

Result>

Exception

None

Result> getUserInfoList(UserInfoParameter parameter)

Get User Info List

Parameter

Return

Result>

Exception

None

Result getServiceConfigJson()

Get Server Configuration

Parameter

None

Return

Result

Exception

None

Result getAllGroupList()

Get Group List Bound to the Device

Parameter

None

Return

Result<DeviceGroups>

Exception

None

Result getDeviceDetailInfo()

Get Device DetaiIed Info

Parameter

None

Return

Result<DeviceDetailInfo>

Exception

None

Result getCompanyInfo()

Get Company Info

Parameter

None

Return

Result<Company>

Exception

Result getUserInfo(long id)

Get User Detailed Info

Parameter

Return

Result<UserDetailInfo>

Exception

None

Result getGuestInfo(long id)

Get Guest Detailed Info

Parameter

Return

Result<GuestDetailInfo>

Exception

None

Result getServerVersion()

Get Server Version

Parameter

None

Return

Result<ServerVersion>

Exception

None

Result getPassTimeTable(long timetableId)

Get Pass Time Table

Parameter

Return

Result<TimeTable>

Exception

None

void logout()

Log out

Parameter

None

Return

None

Exception

None

Result identifyQRCode(IdentifyQRCodeParameter parameter)

QR Code Identification Interface

Parameter

Return

Result<QRResult>

Exception

None

Device Login

Parameter

Return

Result<LoginResult>

Exception

None

Result register( RegisterParameter registerParameter)

Device Registration

Parameter

Return

Result<RegisterResult>

Exception

None

Result reportUserStatus(UserStatusParameter userStatusParameter)

Upload the abnormal status of the user in the local database

Parameter

Return

Result

Exception

None

Result reportUserStatus(UserSyncStatusParameter userSyncStatusParameter)

Upload the abnormal status of the user in the local database

Parameter

Return

Result

Exception

None

void refreshConnectConfig(ConnectConfigEntity connectConfig)

Refresh Connect Configuration

Parameter

Return

None

Exception

None

Result reportDeviceEvent(DeviceReportEventParamer param)

Report Device Event

Parameter

Return

Result

Exception

None

Result uploadRecord(RecordParameter recordParameter)

Upload Identification Record

Parameter

Return

Result<RecordResult>

Exception

None

Result uploadDeviceVersionInfo(DeviceVersionInfoParameter deviceInfoParameter)

Upload Device Version Info

Parameter

Return

Result

Exception

None

Result uploadConfig(String deviceConfigKey, Object config)

Upload Configuration

Parameter

Return

Result

Exception

None

Result uploadTsl(TslUploadParameter parameter)

Upload Tsl

Parameter

Return

Result

Exception

None

Result uploadTslLanguage(TslLanguageUploadParameter parameter)

Upload Tsl Language Package

Parameter

Return

Result

Exception

None

LinkSDKHelper

SenseLink RESTfulインターフェースとMqttメッセージプッシュ仕組みをカプセル化

機能類の説明

LinkSDKHelper

LinkSDKを初期化し、ネットワークリクエストパラメータを設定

メンバー関数の説明

boolean isCAVerify()

CA Verificationかを取得

パラメータ

なし

戻り値

例外

なし

int getConnectTimeout()

接続タイムアウトを取得

パラメータ

なし

戻り値

接続タイムアウト（ミリ秒）

例外

なし

int getReadTimeout()

読み取りタイムアウトを取得

パラメータ

なし

戻り値

読み込みタイムアウト（ミリ秒）

例外

なし

int getWriteTimeout()

書き込みタイムアウトを取得

パラメータ

なし

戻り値

書き込みタイムアウト（ミリ秒）

例外

なし

LinkSDKHelper addInterceptor(Interceptor interceptor)

インターセプターを追加

パラメータ

戻り値

Current Object

例外

なし

LanguageTypeEnum getLanguageType()

言語タイプを取得

パラメータ

なし

戻り値

LanguageTypeEnum

例外

なし

LinkSDKHelper init(String url,Context context)

初期化

パラメータ

戻り値

Current Object

例外

なし

LinkSDKHelper setUrl(String url)

URLを設定

パラメータ

戻り値

Current Object

例外

なし

LinkSDKHelper setCAVerify(boolean caVerify)

CA Verificationを設定

パラメータ

戻り値

Current Object

例外

なし

LinkSDKHelper setConnectTimeout(int connectTimeout)

接続タイムアウトを設定

パラメータ

戻り値

Current Object

例外

なし

LinkSDKHelper setReadTimeout(int readTimeout)

読み取りタイムアウトを設定

パラメータ

戻り値

Current Object

例外

なし

LinkSDKHelper setWriteTimeout(int writeTimeout)

書き込みタイムアウトを設定

パラメータ

戻り値

Current Object

例外

なし

LinkSDKHelper setInterceptorList(List interceptorList)

BatchAddインターセプター

パラメータ

戻り値

Current Object

例外

なし

List getInterceptorList()

インターセプターリストを取得

パラメータ

なし

戻り値

インターセプターリスト

例外

なし

LinkSDKHelper setLanguage(LanguageTypeEnum type)

言語タイプを設定

パラメータ

戻り値

Current Object

例外

なし

String getUrl()

URLを取得

パラメータ

なし

戻り値

サーバアドレス

例外

なし

Development manual

Version

Revision Date

Revision Content

v1.0.2

4/07/2020

Add types of devices to which the SDK is adapted

v1.0.3

5/12/2020

Add an introduction to door access function

v1.2.0

10/14/2020

Add an introduction to face temperature measurement function

Thunder SDK Development Manual

Thunder SDK [hereinafter referred to as "SDK"] is an Android SDK based on AI face algorithm and its derived functions, and takes the intelligent hardware device [hereinafter referred to as the "hardware device"] as the running carrier. It can be used for rapid development of liveness detection, 1:N face identification, 1:1 Face Verification, face temperature measurement, mask detection, access control and other functions.

This document is intended to describe the integration steps of the SDK and how to use the key functions, mainly for development engineers.

SDK Business Capabilities Introduction

This SDK is used for offline identification, capturing faces through device cameras for face identification, and its general flow is shown in the figure below

Based on this generic process, it may be 1 vs 1 or 1 vs N in face matching, so the process is subdivided into 1:1 matching and 1:N identification. Both are used in different scenarios, and 1:1 is not the case where N is set to 1 in 1:N, as defined below.

Call Camera

Quickly access the camera and get the preview callback data, encapsulate methods to manage the camera lifecycle, and support monitoring of the camera status.

Call Thermal imaging system

The characteristics of abstract Thermal imaging system used in traffic scenes, support Thermal imaging system preview and get the data callback, manage its lifecycle, monitor its status, and auto connection after hot plug.
The Thermal imaging system models supported are Arrow, Guide 120 and Guide 256.

1:1 Face Verification

The “1:1 Face Matching" is a process of proving "you are you", which means that you already have someone's identity information to determine whether the person's face information in the camera view matches the existing identity information.
The “1:1 Face Matching" is an authentication operation, which is often used in scenarios requiring identity verification, such as real-name authentication in mobile carrier shop, bank, and authentication scenarios in stations, airports, hotels, and Internet cafes.

1:N Face Identification

The “1:N Face Identification” refers to registering the set of face images to be recognized into the local face feature library, and comparing them with the set of face features in the face feature library when the camera acquires the face information to derive the identification result.

The “1:N Face Identification” is often used in scenarios that require multi-person identification, such as access control and attendance check-in for communities, buildings, schools, etc.

Mask Detection

The “Mask Detection” refers to the rapid detection of whether a person is wearing a mask by analyzing the face information captured by the camera, which is used in scenarios where masks are required, such as hospitals, manufacturing plants, and construction sites with large amounts of dust.

Server 1:N Identification

In the general process mentioned above, face matching can be performed either locally or remotely (via Http network requests). In the remote execution, the user needs to implement the comparison logic by himself, and the user can consider to achieve this function under the premise of the existing face identification backend server.

Door Access Function

The “Door Access Function" refers to the control function of the SDK for door access devices. Different hardware devices have different ranges of support for door access devices. To facilitate the description of the correspondence, the following concepts are defined:

"Door Access Device" - as a collective term for all devices including hardware accessories included in the hardware device of SenseTime and peripheral devices that can be connected and used by the hardware expansion interface.
- Hardware Accessories: including screen backlight, IR fill light,light sensor, distance sensor, buzzer,local relays, loudspeakers, force removal and alarm button;
- Peripheral Devices: door open buttons, fire signals, door magnets, door bells, alarms, Wiegand card readers, network relays, Wiegand door open controllers, etc.

SDK's support for the "Door Access Function" of different hardware devices varies, as follows (the following table is described only from the perspective of SDK (not hardware) adaptation:

For the purpose of description, this document is defined as follows:

Pass Access Control Function: refers to the access control function used by the remaining devices in the Pass and Thunder series (the device models above).

Please pay attention to the following distinction between different devices when the use of the access control function is described.

QR Code Identification

The "QR Code Identification" refers to the function of parsing the content of QR code, which is used in the scenario of QR code identification. There are two codec libraries ZXing and ZBar built into the SDK, which can be selected by yourself when used.

Face Temperature Measurement

The "Face Temperature Measurement" means that through the face identification function and temperature measurement module, the face and thermodynamic diagram data are processed by the algorithm to get the final face temperature. Currently, the temperature measurement modules supported are Arrow module, Guide 120 module, and Guide 256 module. It should be noted that the final face temperature value may deviate depending on the ambient temperature, module model, and usage strategy.

Introduction to Devices Suitable for SDK

Introduction to Face Camera Imaging

For the purpose of illustrating camera imaging, the following definition is made.

Horizontal Imaging: means that the width of the camera imaging picture is greater than the height.
Vertical Imaging: means that the width of the camera imaging image is less than the height.
Imaging Mirroring :refers to the camera image in which the real moving direction of the object is opposite to the direction in which the picture is presented. If a person walks to the left, he or she goes to the right in the preview screen.

The following table indicates the imaging characteristics of the face camera corresponding to the specific device model.

Access Instructions

The SDK is provided as a.zip package file, which includes the.aar package,.so file, algorithm model file, sample project and development documentation. The SDK requires the following environment:

Start Integration

Copy the .aar file to the project libs folder, as shown in the figure below.

Select the corresponding model file in the "model file" folder of the zip package according to the device type, as shown in the figure below.

Copy the corresponding model file in the zip package to the actual project assets/model folder.

Select the corresponding so library in the "so library" folder of the package according to the device type, as shown in the table below

and copy the so in the folder to the /src/main/jniLibs folder.

Add the following configuration to the build.gradle file

Add the following permission declaration in AndroidManifest.xml file

Copy the .lic certificate to the assets folder (there is a debug certificate in Sample, which is for testing purposes only, and a separate application is required for the official production environment certificate), as shown in the following sample image.

Sample Project

The Sample project can be opened in Android Studio. Copy aar, model, so and other files to the corresponding folder according to the documentation, and run debugging with pass series and thunder series of hardware devices. The Sample project mainly demonstrates 1:N identification, 1:1 matching, mask detection, access control and other functions.

SDK usage

In this section, the use of key api and processes in the SDK will be mainly described.

SDK initialization

Before using the SDK, please make sure that the aar, model, so and .lic files are properly stored and configured. Once the files are ready, the initialization can be performed as follows:

Authorization can be made after successful initialization, and the first authorization must be connected to the public network authorization, shown as follows:

In general, there is no need to perform a release operation before the application exits after successful SDK authorization. Specifically, when it is necessary to restart the application, the SDK resources can be released at the end of the application, as follows:

Call Camera

The CameraTextureView and CameraManager classes in the SDK make it easy to manage the camera life cycle and related preview operations. The following is an example of using a face camera (RGB) to introduce the use of the camera. CameraTextureView can be used in the layout file as follows (full screen preview).

Then initialize the camera (Please check the following code for detail. 1280*720 preview resolution is highly recommended), as follows,

Control Camera Lifecycle, as follows:

Call Thermal imaging system

Before calling the relevant interface of the thermal camera, get the instance of the thermal camera first. TemperatureCameraFactory is provided in the SDK to obtain different instances of the Thermal imaging system, shown as follows:

Initialize the Thermal imaging system configuration

Add Thermodynamic Diagram and Callback of Temperature Data

Get the partial status of the Thermal imaging system

Manage the lifecycle of the Thermal imaging system

In addition, the SDK provides a number of methods to operate the Thermal imaging system, shown as below:

1:N Face Identification Flow

The business process of face identification contains several steps such as Camera management, face feature library creation, liveness detection, face comparison, and result processing, which involves many details of SDK usage. The following article introduces the details of SDK usage, taking the process of "1:N identification" as an example.

Create Face Feature Library

The "1:N identification" requires a face feature library as the "database" for face feature retrieval, so the face feature library needs to be built before the process starts. The SDK has FeatureManagerProxy for feature library creation, which is briefly used as follows.

N face features (a maximum of 5W features) can be inserted in the feature library. After the construction is completed, the Identify Manager automatically obtains the inserted facial feature data of 'FeatureManagerProxy' during the identification process for personnel identification.

Start Camera Preview

Please check Call Camera section for detail to turn on the RGB camera. If liveness detection is enabled, you also need to turn on the IR camera again and modify the preview data callback to pass the preview data into the Identify Manager, as follows:

Start the Identify Manager

The Identify Manager has built-in "1:N", "1:1" and "server 1:N" identification processes, and you can switch the internal identification logic by switching the Identify Manager mode. The Identify Manager modes are as follows.

VerifyModeEnum.MODE_1_N: 1:N identification mode, corresponding to 1:N identification process.
VerifyModeEnum.MODE_1_1: 1:1 comparison mode, corresponding to 1:1 comparison process.
VerifyModeEnum.MODE_SERVER_1_N: server 1:N identification mode, corresponding to the server 1:N identification process;

Before use, set the configuration as follows:

After the initial setup, the Identify Manager can be turned on/off to control identification, as follows

The identification process can control the details through the parameters, and the Identify Manager parameters can be configured individually according to the specific business, as follows. (In the code annotation below, if there are notes for a series different from the pass and thunder series, please skip them as appropriate.)

Process Identification Result

The Identify Manager transmits the identification result to the upper business by the way of interface callback, and the upper business only needs to process the result in the callback interface, shown as follows:

When the result callback is not required, set null as follows:

At this point, the process of "1:N identification" has been preliminarily built.

1:1 Face Verification Process

In the above description, the Identify Manager in the "1:N identification" process uses the mode VerifyModeEnum.MODE_1_N, which is the "1:N identification" mode. In the face "1:1 matching" process, the Identify Manager needs to be switched to "1:1 matching" mode, as follows:

Server 1:N Identification

When the identification step is executed on the remote server, you need to modify the configuration of the Identify Manager to enable the server identification based on 1:N identification, and then use the IServerVerifyAction class to implement the identification logic. The specific use is as follows:

Mask Detection

Based on the identification of "1:N", "1:1" and "server 1:N", the corresponding mask detection results can be obtained from the identification results by configuring to open the mask detection. If the mask detection function is not enabled, the default mask detection result is true, enabled as follows:

Face Temperature Measurement

Based on the identification of "1:N", "1:1" and "server 1:N", the temperature measurement configuration item of the Identify Manager needs to be enabled before the face temperature measurement function is used, as shown below

It should be especially noted that the Identify Manager needs temperature data to work properly after the temperature measurement function is turned on, and no identification will be made before the temperature data is obtained, but face tracking will be carried out normally. In addition, when the temperature measurement function is turned on, it is recommended to set the rectangle for face recognition and a stricter angle of the front face to try to identify the face in the center of the field of view, so as to increase the accuracy of face identification and temperature measurement, as follows

The temperature measurement function requires a temperature measurement module (Thermal imaging system), which can be initialized by obtaining the corresponding Thermal imaging system object through the TemperatureCameraFactory class. Note that the Thermal imaging system takes several seconds to initialize, as follows

After the temperature data are obtained, the temperature value needs to be calibrated by the temperature measurement algorithm, which needs to be initialized manually, as follows

Set Temperature Sdk Action to the Identify Manager,

Get the thermal camera preview data (thermodynamic diagram). Once the temperature data is acquired, it needs to be injected into the Identify Manager in time, as follows

Get personal temperature data from the identification callback results:

Use of Pass Access Control

The use of the Pass access control feature requires a global initialization configuration, which is initialized as follows.

The configuration for using the Pass access control function can be dynamically modified by DoorDeviceAccessProxy.setConfig(config).

Key categories of Pass access control function:

DoorDeviceAccessProxy: responsible for global initialization, resource release, configuration usage, door opening control.
DoorAccessConfig: Categories of Door Access Configuration.
PassDoorDeviceAccessProxy: Manage access control functions available to SensePass/SensePassPro devices, such as door chimes, RS485 protocols, alarms, and tamper alarm lights.

Open Door via Local Relay

The "local relay" is a hardware device with its own accessories, used to control the opening of the door and set the door opening time (i.e. open the door for a number of seconds and then close it). The hardware models supporting this function are SensePass, SensePassPro.

The Pass access control function is used as follows:

DoorDeviceAccessProxy.openDoor() automatically acquires the configured door opening method and the delayed closing time, and then automatically executes the door opening action. The user does not need to care about the specific way to open the door, which is automatically controlled by the method. The same is true of door openning with the network relay and the Wiegand controller below.

Specifically, when the delayed closing time needs to be greater than 30 seconds, it is necessary to open the door in the following ways

If the local relay needs to be closed immediately, the following method can be called manually.

Open Door via Network Relay

The "Network Relay" is a peripheral device. The hardware device connects to the network relay through the network, and controls the door opening and delayed closing time by sending door opening commands to the network relay. The hardware models supporting this function are Pass and Thunder series.

The Pass access control function is used as follows:

Open Door via Wiegand Controller

The "Wiegand Controller" is a peripheral device that connects to the hardware device through an expansion interface and uses the Wiegand protocol for data communication, which can be used to control the door opening. SDK currently supports Wiegand 26, Wiegand 32 and Wiegand 34, and the hardware models that support this function are Pass and Thunder series device.

The maximum card number supported by the standard Wiegand 26 protocol is 8 bits, and the card number data transmission is divided into HID and PID. According to the generation mode of HID and PID, Wiegand 26 is subdivided into two modes, "Wiegand 26 (24bit)" and "Wiegand 26 (8+16bit)”, whose difference is as follows:

Wiegand 26 (24bit): For ordinary use mode, the card number is converted to int, divided by 2^16 to take an integer as HID, and the remainder of 2^16 is taken as PID.
Wiegand 26 (8+16bit): For special use mode, the first 3 digits of the card number are converted to int as HID, and the last 5 digits are converted to int as PID.

The Pass access control function is used as follows:

Open Door via Wiegand 26

Open Door via Wiegand 32/34

Wiegand card reading

The "Wiegand card reading" needs to be configured with a Wiegand reader, which is a peripheral device. It connects with the device through the extended interface and uses the Wiegand protocol for data communication to read the IC card number. It supports Wiegand 26 (consistent with the above description), Wiegand 32 and Wiegand 34. The hardware device models supporting this function are Pass and Thunder series device.

The Pass access control function is used as follows:

Once the setup is complete, you can listen to the Wiegand read callback. The code is used as follows.

GPIO Input Devices

"GPIO input devices" refer to a class of devices that send GPIO signals to hardware devices through the GPIO port connection, including door opening buttons, fire signals and door magnets. When used, the hardware device serves as the receiver and the "GPIO input device” serves as the sender, and the two communicate through the GPIO input port. The hardware device models that support this feature are Pass and Thunder series device.

Pass access control function supports the use of dual GPIO, divided into B and C. configuration. Before use, set the relevant access control configuration, and its code is as follows:

Once the setup is complete, you can listen to the relevant signal input. The code is used as follows.

GPIO Output Devices

"GPIO output devices" refers to peripheral devices connected through GPIO output port for receiving GPIO signals from hardware devices, including doorbell, and alarm. When used, the hardware device serves as the sending end and the "GPIO output type device" serves as the receiving end, and the two communicate through the GPIO output port. The hardware device models that support this feature are Pass and Thunder series.

Before use, set the relevant access control configuration, and its code is as follows:

Specifically, when using the alarm, you need to manually control the alarm and turn off the alarm. The code is used as follows:

Light Control

"Lighting Control" mainly controls the lighting accessories of hardware devices, including RGB fill light, IR fill light and screen backlight.

IR Fill Light

The "IR fill light" is part of the IR camera module and is used to enhance the IR image. To increase its lifetime, it can be dynamically controlled to turn off when not in use. The hardware device models that support this feature are Pass and Thunder series.

The code is used as follows:

Screen Backlight

The "screen backlight" is an accessory that comes with the hardware device to turn off the screen light when the software application is in a dormant state (such as late at night when the software application is no longer needed), increasing the life of the hardware device and reducing energy consumption. The hardware device models that support this feature are Pass and Thunder series.

The code is used as follows:

RS485 Protocol

The "RS485 protocol" refers to a serial communication protocol standard. The RS485 interface is provided in the hardware device to support its communication in half-duplex mode, Half-duplex data read-only and write-only are controlled automatically by the rom, and the upper business only needs to pay attention to the serial communication. The hardware device models that support this feature are Pass and Thunder series.

Before use, first turn on the RS485 function, and set the baud rate, data buffer, and data transceiver timeout length according to the use scene.The code is used as follows:

To send data, use the following code:

Tamper alarm button

The "tamper alarm button” is an accessory that comes with the hardware device, located on the back of the device as a raised button. When the button is pressed during normal operation, the button will pop up when the hardware device is removed, and the Rom level will sense it and issue a "tamper alarm" for alerting when the hardware device is removed abnormally.

The Rom level converts the "tamper alarm" into an input event of the "F2 button", i.e. when the "tamper alarm" occurs, the system layer sends the "F2 button" input event. F2 button" input event, so you can listen to the "tamper alarm" by listening to whether the "F2 button" is pressed or not. The code is used as follows:

Sensor

"Sensors" refers to the sensors that come with the hardware device, such as light sensors, and distance sensors. For the passage scenario, the role of sensors is as follows:

Light sensor: senses light intensity and can set "fill light mode" for applications in low light conditions.
Distance sensor: senses the proximity of a person to trigger certain specific operations (e.g. waking up a device in a dormant state when the person is close).

Sensors can be used through the SensorManager class in the Android native SDK, whose code is used as follows:

Buzzer

The "buzzer" is an accessory that comes with the hardware device and is mainly used for beeping when an alarm occurs on the hardware device. Currently, only SensePass and SenseThunderE-mini devices support this feature. Using the buzzer requires manual control to turn it on and off, and the code is as follows:

Application System Signature

The system signature file sensetime.jks is placed in the sample project of the SDK. Using this file as the application signature allows the application to gain system privileges, which allows the application to perform more operations that require high privileges, such as setting system events, and modifying system settings.

To use it, please copy sensetime.jks to the root of the main module of the project, and then add the following configuration to the build.gradle file.

And add the system application declaration android:sharedUserId="android.uid.system" to the AndroidManifest.xml file, as follows:

QR Code Identification

The QR code recognition function can recognize ordinary QR codes normally. When using it, you can select ZXing or ZBar encoding and decoding library. It is recommended to use ZBar, which is more suitable for end-to-side device identification and faster. For more information on how to use it, please see the Sample code. The brief usage is as follows:

android {
     ...
     compileOptions {
         sourceCompatibility JavaVersion.VERSION_1_8
         targetCompatibility JavaVersion.VERSION_1_8
     }
}
dependencies {
    implementation files('libs/Thunder-android-vx.x.x.aar')
    // Third-party libraries that SDK needs
    implementation 'com.alibaba:fastjson:1.2.70'
    implementation 'com.facebook.conceal:conceal:2.0.1@aar'
    implementation 'com.google.zxing:core:3.3.3'
    implementation 'com.github.open-android:pinyin4j:2.5.0'
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.okhttp3:okhttp:4.8.0'
    implementation 'com.squareup.okhttp3:logging-interceptor:4.8.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.4.0'
    implementation 'com.liulishuo.okdownload:okdownload:1.0.7'
    implementation 'com.liulishuo.okdownload:okhttp:1.0.7'
    implementation 'com.liulishuo.okdownload:sqlite:1.0.7'
}

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.NFC" />

// Specify the model used by the SDK. Here, take initialization on SensePass devices as an example. For more information, please see the Sample code.
model.mMode = SDKMode.PASS;
model.mAlignmentModel = "model/M_Align_occlusion_106_1.20.0.model";
model.mSmallDetectModel = "model/M_Detect_Hunter_LargeFaceSelfie_Gray_11.2.0.model";
model.mVerifyModel = "model/M_Verify_Mobilenetv2Pruned_BGR_Surveillance_4.13.0_v2_weak.model";
model.mDoubleHackModel = "model/pass_ext/M_Liveness_Antispoofing_Binocular_3.28.0.model";
model.mVerifyFinanceModel = "model/M_Verify_Mobilenetv2Pruned_BGR_Surveillance_4.13.0_v2_weak.model";
model.mAttributeModel = "model/M_Attribute_MTNet_2.1.1.model";

// The name of the license file
String licenseName = "sensepass.lic";
String productName = null;

WuKong.auth(licenseName, productName, model, new IAuthCallback() {
            @Override
            public void onSuccess() {
                // Authorization successful
            }

            @Override
            public void onFail(int code, String errMsg) {
                // Authorization failed
            }
        });

<com.sensetime.camera.view.CameraTextureView
        android:id="@+id/camera_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:scalableType="centerCrop" />

CameraTextureView mCameraView = findViewById(R.id.camera_view);
Camera.PreviewCallback mRgbCallback = new Camera.PreviewCallback() {
        @Override
        public void onPreviewFrame(byte[] data, Camera camera) {
            // Preview data callback, which can be passed to the Identify Manager
            // IdentifyManager.getInstance().handleRgbData(data);
        }
};

// Take setting up a face camera as an example
CameraManager faceCameraManager = CameraManager.getInstance(CameraUtils.getFaceCameraIndex());
// Add preview data callback
faceCameraManager.addPreviewCallbackWithBuffer(mRgbCallback);
// Open Camera
faceCameraManager.openCamera(getApplicationContext());
// Set preview-related parameters, such as preview width and height, and face orientation.
faceCameraManager.initParameters(1280, 720, 0, mCameraView.getSurfaceTexture());

// Start Preview
faceCameraManager.startPreview();

// Stop Preview
faceCameraManager.stopPreview();

// Release Camera
faceCameraManager.releaseCamera();
faceCameraManager.setPreviewTexture(null);
faceCameraManager.removePreviewCallbackWithBuffer(mRgbCallback);
faceCameraManager.setCameraLifecycleCallback(null);
faceCameraManager.setCameraStatusCallback(null);
faceCameraManager.setCameraExceptionHandler(null);
faceCameraManager.setCameraDataUpdateCallback(null);

// Get Thermal imaging system Type
CameraType cameraType = TemperatureCameraUtils.getCameraType();
// Get the instance of the corresponding Thermal imaging system by camera type
ITemperatureCamera temperatureCamera = TemperatureCameraFactory.getTemperatureCamera(cameraType);

Initialize Thermal imaging system
temperatureCamera.initCamera(context);
// Set the relevant parameters of the Thermal imaging system (needs to be executed after initialization)
temperatureCamera.setConfig(config);
// Set whether the shutter is enabled automatically. It is true by default (Enabling the shutter improves the accuracy of temperature measurement, but shortens the service life of the device)
temperatureCamera.setAutoShutterEnable(true);

ITemperaturePreviewDataCallback dataCallback = new ITemperaturePreviewDataCallback() {

            @Override
            public void onTemperaturePreviewData(Bitmap temperatureBitmap, float[] temperatureValue, int width, int height) {
                    // Thermodynamic Diagram and Callback of Temperature Data
            }
        };
// Add Data Callback
temperatureCamera.addTemperaturePreviewDataCallback(dataCallback);
// Remove the callback when the data are not in use
temperatureCamera.removeTemperaturePreviewDataCallback(dataCallback);
// It is worth noting that the temperature data does not refer to Celsius degrees, which can be obtained from the temperature data by the following method
temperatureCamera.getCentigradeFromTemperatureData(temperatureValue);
// Alternatively, it can be converted by batch
temperatureCamera.matrixTemperature(temperatureValue,width,height,distance,x,y,w,h,tempArray);

// Start Preview of Thermal imaging system
temperatureCamera.startPreview(textureView);
// Stop Preview of Thermal imaging system
temperatureCamera.stopPreview();
// Release Camera Resources of Thermal imaging system
temperatureCamera.releaseCamera();

// Frontal Clear Single Photo
Bitmap avatar = BitmapFactory.decode(R.id.avatar);
int userId = 123;

if (avatar != null) {
      // Get Features of the Face in the Picture
      byte[] feature = FeatureManagerProxy.getInstance().getFeature(avatar);
      // Insert Feature Library (native memory). Data persistence requires processing by upper business.
      int result = FeatureManagerProxy.getInstance().insert(userId, feature);
      if (result == 0) {
            Log.d(TAG, "Face Feature Inserted Successfully");
      }
}

// Delete Person Characteristics
int result = FeatureManagerProxy.getInstance().delete(userId);
if (result == 0) {
      Log.d(TAG, "Face Feature Deleted Successfully");
}

Camera.PreviewCallback mRgbCallback = new Camera.PreviewCallback() {
        @Override
        public void onPreviewFrame(byte[] data, Camera camera) {
            // Transfer RGB Preview Data Callback to the Identify Manager
            IdentifyManager.getInstance().handleRgbData(data);
        }
};
Camera.PreviewCallback mIrCallback = new Camera.PreviewCallback() {
        @Override
        public void onPreviewFrame(byte[] data, Camera camera) {
            // Transfer IR Preview Data Callback to the Identify Manager
            IdentifyManager.getInstance().handleIrData(data);
        }
};

 // Please configure the image related settings according to the device hardware environment
ImageConfig imageConfig = new ImageConfig.Builder()
          .previewW(1280)
          .previewH(720)
          .faceOrientation(FaceOrientation.UP)
          .pixelFormat(MidPixelFormat.NV21)
          .build();


// Initialize
IdentifyManager.getInstance().init(imageConfig,identifyCallback);

// Set Identification Mode of the Identify Manager
IdentifyManager.getInstance().setVerifyMode(VerifyModeEnum.MODE_1_N);
// Set Result Callback
IdentifyManager.getInstance().setIdentifyCallback(identifyCallback);

// Enable Identification
IdentifyManager.getInstance().start();

// Stop Identification
IdentifyManager.getInstance().stop();

// Release the Identify Manager
IdentifyManager.getInstance().release();

IdentifyConfig identifyConfig = IdentifyManager.getInstance().getIdentifyConfig();
IdentifyConfig.hasLiveness = true; // Enable liveness detection
identifyConfig.isSingleLiveness = DeviceInfoUtils.isSenseIDProduct();   // For monocular liveness detection, this item should be enabled only for ID series devices
identifyConfig.isSenseGateConfig = DeviceInfoUtils.isSenseGateProduct();  // Turn this on only if the device used is SenseGate series
identifyConfig.isContinueVerify = true; // IdentifyConfig.isContinueVerify = true; / / Whether to recognize continuously. If enabled, it will be recognized continuously (the face needs to be in the camera field of view). It is used together with the continueVerifyIntervalTime parameter.
identifyConfig.continueVerifyIntervalTime = 3000L;  // Interval for continuous identification of the same face, which takes effect when isContinueVerify is set to true
identifyConfig.hasTemperatureDetection = false;
identifyConfig.isServerVerify = false;
IdentifyManager.getInstance().setIdentifyConfig(identifyConfig);

// The modifications are shown here - In 1:N matching, the matching threshold is changed to 0.83f and the liveness filtering threshold is 0.95f (if exceeded, it is non-liveness), with a minimum identification of 100 pixels of the face
ThresholdConfig thresholdConfig = IdentifyManager.getInstance().getThresholdConfig();
thresholdConfig.verifyScore = 0.83f;
thresholdConfig.livenessScore = 0.95f;
thresholdConfig.faceMinWidth = 100;
thresholdConfig.verifyAreaRect = new RectF(0, 0, mPreviewHeight, mPreviewWidth);
IdentifyManager.getInstance().setThresholdConfig(thresholdConfig);

IIdentifyResultCallback identifyCallback = new IIdentifyResultCallback() {

    @Override
    public void onDrawFaces(@Nullable List<FaceInfo> list) {
        // Face Detection Callback, which can be used to draw a face calibration frame.
        // Please note that the callbakc occurs when identification is paused, which means that faces are still being tracked in the process, but just not recognized
    }

    @Override
    public void onClearScreen() {
        // Clear Screen Callback. Clear the screen with this callback when there appears no face in the field of view
    }

Please note that the callbakc o
    public void onUnknown(float faceW) {
                // If the face is too large or too small to determine whether it is liveness or not, notice is given with this method
    }

    @Override
    public void onIdentifyResult(List<FrameIdentifyResult> frameIdentifyResults) {
                // Identify Result Callback
    }
};

// Set Result Callback
IdentifyManager.getInstance().setIdentifyCallback(identifyCallback);

// Initialization of the Identify Manager is the same as that of 1:N
// When the Identify Manager is switched from 1:N to 1:1, it is necessary to set the single identification feature first, and then switch the mode

Bitmap singleTarget = BitmapFactory.decodeResource(getResource(), R.mipmap.face);
boolean setupResult = IdentifyManager.getInstance().setIdentifyTarget(singleTarget);
// Set Identification Mode of the Identify Manager. Before setting it, make sure that the individual identification feature is set successfully.
if (setupResult) {
    IdentifyManager.getInstance().setVerifyMode(VerifyModeEnum.MODE_1_1);
}

// 1. Enable Server Verify Mode 
IdentifyManager.getInstance().setVerifyMode(VerifyModeEnum.MODE_SERVER_1_1);

// 2. Implement Server Verify Action
IServerVerifyAction serverVerify = new IServerVerifyAction() {
        @Override
        public <T extends FaceSearchResult> T verify(@NonNull byte[] cameraData, byte[] feature, @Nullable FaceInfo rgbFace,int width, int height) {

              // Upload Data via http Request and Get Identification Result (note to set a reasonable request timeout).
            // ..code

            // Build Face Search Result and Return It, as shown in the following example
            FaceSearchResult result = new FaceSearchResult();
            result.score = 0.93f;
            result.userID = 12345;

            return (T) result;
        }
};

// 3. Set Server Verify Action
IdentifyManager.getInstance().setServerVerifyAction(serverVerify);

// Open Wear Mask Identify
IdentifyConfig identifyConfig = IdentifyManager.getInstance().getIdentifyConfig();
identifyConfig.isOpenWearMaskIdentify = true;
IdentifyManager.getInstance().setIdentifyConfig(identifyConfig);

// Get Face Identify Result Through Identify Result Callback Interface
IIdentifyResultCallback identifyCallback = new IIdentifyResultCallback() {

    @Override
    public void onDrawFaces(@Nullable List<FaceInfo> list) {
        // Face Detection Callback, which can be used to draw a face calibration frame.
        // Please note that this callback still occurs when identification is paused, which means that faces are still being tracked in the process, but just not recognized
    }

    @Override
    public void onClearScreen() {
        // Clear Screen Callback. Clear the screen with this callback when there appears no face in the field of view
    }

    @Override
    public void onUnknown(float faceW) {
                // If the face is too large or too small to determine whether it is liveness or not, notice is given with this method
    }

    @Override
    public void onIdentifyResult(List<FrameIdentifyResult> frameIdentifyResults) {
                // Identify Result Callback
      for (int i = 0; i < frameIdentifyResults.size(); i++) {
            FrameIdentifyResult frameIdentifyResult = frameIdentifyResults.get(i);
            List<FaceIdentifyResult> faceIdentifyResults = frameIdentifyResult.faceIdentifyResults;
            for (int j = 0; j < faceIdentifyResults.size(); j++) {
                FaceIdentifyResult faceIdentifyResult = faceIdentifyResults.get(j);
                  // Get Face Identify Result
                  boolean mask = faceIdentifyResult.isMask();
            }
        }
    }
};

// Set Result Callback
IdentifyManager.getInstance().setIdentifyCallback(identifyCallback);

IdentifyConfig identifyConfig = IdentifyManager.getInstance().getIdentifyConfig();
identifyConfig.hasTemperatureDetection = true;    // Enable Temperature Detection
IdentifyManager.getInstance().setIdentifyConfig(identifyConfig);

ThresholdConfig thresholdConfig = IdentifyManager.getInstance().getThresholdConfig();
thresholdConfig.faceMinWidth = 200; // In the temperature measurement, it needs to be closer, and the width of the face needs to be set larger.
thresholdConfig.pitch = 20;   // In the temperature measurement, the requirements are more stringent, and face facing forward helps to measure the temperature more accurately
thresholdConfig.roll = 20;
thresholdConfig.yaw = 20;
thresholdConfig.verifyAreaRect = new RectF(125, 400, 565, 835); // Take the SensePass device as an example       
IdentifyManager.getInstance().setThresholdConfig(thresholdConfig);

// Get Camera Type
CameraType type = TemperatureCameraUtils.getCameraType();
// Create Thermal imaging system Object
ITemperatureCamera mTemperatureCamera = TemperatureCameraFactory.getTemperatureCamera(type);
// Initialize
mTemperatureCamera.initCamera(this);

// Initialize Temperature Comparison Algorithm (for calibration temperature)
TemperConvertCallback temperConvertCallback = new TemperConvertCallback() {

            private float[] tempArray;

            @Override
            public float temperConvertCentigrade(float temper) {

                return TemperatureCameraFactory.getTemperatureCamera(type).getCentigradeFromTemperatureData(temper);
            }

            @Override
            public float[] getTempMatrix(float[] y16Frame, int y16W, int y16H, float distance, int x, int y, int w, int h) {

                int size = w * h;
                if (tempArray == null || tempArray.length != size) {
                    tempArray = new float[size];
                }
                TemperatureCameraFactory.getTemperatureCamera(type).matrixTemperature(y16Frame, y16W, y16H, distance, x, y, w, h,                                         temperConvertCallback = tempArray);
                return tempArray;
            }
        };
int ret = TemperatureActionProxy.init(algorithmVersio, temperConvertCallbackn);
if(ret == 0) {
        Log.d(TAG, "Temperature Measurement Algorithm Initialized Successfully");
}

ITemperatureSdkAction action = new ITemperatureSdkAction() {

            @Override
            public <T extends TrackAndTemperatureResult> List<T> temperCalculateAir(MatchFace[] matchFaces, @Nullable Bitmap temperatureBitmap, float[] temperatureData, int temperatureWidth, int temperatureHeight, FaceOrientation temperatureOrientation) {
                // Ambient temperature of equipment in use 
                // when CameraType is CameraType.GUIDE120 or CameraType.IRAY，Examples code
                   MatchFace matchFace = matchFaces[0];
                    float envTemperature = 25.1f;
                    TemperInfo temperInfo = TemperatureActionProxy.temperCalculateObtainRect(matchFace.rgbFace, temperatureData,
                                                                                     temperatureWidth, temperatureHeight, FaceOrientation.UP.getValue(), envTemperature, 0.1f);
                    TrackAndTemperatureResult trackAndTemperatureResult = new TrackAndTemperatureResult();
                    trackAndTemperatureResult.setFaceInfo(matchFace.rgbFace);
                    trackAndTemperatureResult.setIrFaceInfo(matchFace.irFace);
                    trackAndTemperatureResult.setTemperature(temperInfo.temper);

                    List<T> ts = new ArrayList<>();
                    ts.add((T) trackAndTemperatureResult);
                    return ts;
            }
        };
            }
        };
// Set Temperature Sdk Action
IdentifyManager.getInstance().setTemperatureSdkAction(action);

ITemperaturePreviewDataCallback mPreviewDataCallback = 
          new ITemperaturePreviewDataCallback() {

          @Override
      public void onTemperaturePreviewData(
            Bitmap temperatureBitmap, float[] temperatureValue, int width, int height) {

                // temperatureBitmap - thermodynamic diagram, which can be used to draw a temperature bitmap preview
                // temperatureValue - Temperature Data
                // width, height - heat Width and height of Thermodynamic Diagram

                // Inject temperature data into the Identify Manager (if temperature data are not injected after the temperature measurement function is enabled, no recognition will be performed)
                IdentifyManager.getInstance().handleTemperatureData(
                  temperatureBitmap, temperatureValue,width, height, mCameraUseConfig.faceOrientation);
            }
        };

// Set Callback
mTemperatureCamera.addTemperaturePreviewDataCallback(mPreviewDataCallback);

// Get Face Identify Result Through Identify Result Callback Interface
IIdentifyResultCallback identifyCallback = new IIdentifyResultCallback() {

    @Override
    public void onDrawFaces(@Nullable List<FaceInfo> list) {
        // Face Detection Callback, which can be used to draw a face calibration frame.
        // It should be noted that this callback still occurs when identification is paused, which means that faces are still being tracked in the process, but just not recognized
    }

    @Override
    public void onClearScreen() {
        // Clear Screen Callback. Clear the screen with this callback when there appears no face in the field of view
    }

    @Override
    public void onUnknown(float faceW) {
                // If the face is too large or too small to determine whether it is liveness or not, notice is given with this method
    }

    @Override
    public void onIdentifyResult(List<FrameIdentifyResult> frameIdentifyResults) {
                // Identify Result Callback
              for (int i = 0; i < frameIdentifyResults.size(); i++) {
            FrameIdentifyResult frameIdentifyResult = frameIdentifyResults.get(i);
            if (frameIdentifyResult == null
                    || frameIdentifyResult.faceIdentifyResults == null
                    || frameIdentifyResult.faceIdentifyResults.size() <= 0) {
                continue;
            }
            List<FaceIdentifyResult> faceIdentifyResults = frameIdentifyResult.faceIdentifyResults;
            for (int j = 0; j < faceIdentifyResults.size(); j++) {
                FaceIdentifyResult faceIdentifyResult = faceIdentifyResults.get(j);
                if (faceIdentifyResult == null || faceIdentifyResult.getIdentifyResultTypeEnum() == null) {
                    continue;
                }
                TrackAndTemperatureResult trackAndTemperatureResult = faceIdentifyResult.getTrackAndTemperatureResult();
                float temperature = 0;
                if (trackAndTemperatureResult != null) {
                    temperature = trackAndTemperatureResult.getTemperature();
                }
                Log.i(TAG, String.format(Locale.getDefault(), "userId-%d temperature is %f",
                                         faceIdentifyResult.getUserId(), temperature));
            }
        }
    }
};

// Set Result Callback
IdentifyManager.getInstance().setIdentifyCallback(identifyCallback);

// Pass access control function initialization, must be called before use of the access control function
DoorDeviceAccessProxy.init();

final DoorAccessConfig config = new DoorAccessConfig.Builder()
        // Set GPIO B port input type, which can be set to GPIO_IN_NONE by default
        .setGpioInB(DoorAccessConfig.GPIO_IN_NONE)
        // Set GPIO C port input type, which can be set to GPIO_IN_NONE by default
        .setGpioInC(DoorAccessConfig.GPIO_IN_NONE)
        // Set Open Door Time, only for local relays (here set to close after 5 seconds of opening)
        .setOpenDoorTime(5)
        // Set GPIO Output Type
        .setGpioOutA(DoorAccessConfig.GPIO_OUT_NONE)
        // Control RS485 data reading and writing by the Rom itself (Rom support is required. Please set it to false if Rom does not support)
        .setIsSupportRS485GpioAutoControl(true)
        // Set Wiegand Input Protocol Type
        .setWiegandInput(DoorAccessConfig.WIEGAND26_24_BIT)
        // Set Open Door Mode
        .setOpenDoorMode(DoorAccessConfig.OPEN_DOOR_MODE_RELAY)
        .Setthe Serial Port Baud Rate for RS485 Protocol
        .setRS485BaudRate(9600)
        .build();
DoorDeviceAccessProxy.setConfig(config);

// Set Open Door Mode to "Local Relay"
DoorAccessConfig mDoorAccessConfig = DoorDeviceAccessProxy.getConfig();
mDoorAccessConfig.setOpenDoorMode(DoorAccessConfig.OPEN_DOOR_MODE_RELAY);
DoorDeviceAccessProxy.setConfig(mDoorAccessConfig);

// This method is a global door opening method, which will automatically execute the door opening action according to the door opening method set in the config
// The IC card number is only used when the input parameter is Wiegand Open Door. Transfer it directly here. “
DoorDeviceAccessProxy.openDoor("");

DoorAccessConfig mDoorAccessConfig = DoorDeviceAccessProxy.getConfig();
// Just fill in the IP, the port has been defaulted to 12345. If it was set during initialization, no need set repeatedly here
mDoorAccessConfig.setRelayIp("192.168.12.11");
// Set Open Door Mode as Network Relay
mDoorAccessConfig.setOpenDoorMode(DoorAccessConfig.OPEN_DOOR_MODE_IP_RELAY);
DoorDeviceAccessProxy.setConfig(mDoorAccessConfig);

// The parameter is the delayed closing time, which can be set freely
DoorDeviceAccessProxy.openDoor("");

DoorAccessConfig config = DoorDeviceAccessProxy.getConfig();
// This is set to the Wiegand 26 standard card reader
config.setWiegandInput(DoorAccessConfig.WIEGAND26_24_BIT);
DoorDeviceAccessProxy.setConfig(config);

DoorDeviceAccessProxy.setCardReaderCallback(
            new WiegandReaderDevice.CardReaderCallback() {

    @Override
    public void onRead(String cardNumber) {
        // The card number is read successfully, and the cardNumber is the card number
    }
});

DoorAccessConfig mDoorAccessConfig = DoorDeviceAccessProxy.getConfig();
// Here it is assumed that the peripheral device is connected to port B to connect to the door button. If you use port C, please set doorAccessConfig.setGpioInC()
mDoorAccessConfig.setGpioInB(DoorAccessConfig.GPIO_IN_DOOR_BUTTON);
DoorDeviceAccessProxy.setConfig(mDoorAccessConfig);

// When Using Door Button
PassDoorDeviceAccessProxy.setOnClickDoorButtonListener(
                new DoorButtonDevice.DoorButtonOnClickListener() {

        @Override
        public void onClick() {
            // Receive Door Opening Signal
        }
});

// When Using Receive Fire Sign Listener
PassDoorDeviceAccessProxy.setReceiveFireSignListener(
                new FireSignalDevice.ReceiveFireSignListener() {

        @Override
        public void onReceive() {
            // Receive Fire Signal
        }
});

// When using door sensors
PassDoorDeviceAccessProxy.setDoorStateCallback(
                new PassDoorDeviceAccessProxy.DoorMagnetismStateCallback() {

        @Override
        public void onDoorStateChanged(int state) {
            if (state == '0') {
                // Door Magnetism State- Off
            } else {
                // Door Magnetism State- On
            }
        }
});

DoorAccessConfig sgDoorAccessConfig = DoorDeviceAccessProxy.getConfig();
// It is assumed here that the doorbell is used
sgDoorAccessConfig.setGpioOutA(DoorAccessConfig.GPIO_OUT_DOOR_BELL);
DoorDeviceAccessProxy.setConfig(sgDoorAccessConfig);

// When the doorbell rings, the parameter is the time (the actual ringing time may have errors, because the doorbell manufacturer may set the ringing according to the number of times, rather than the specific length of time)
PassDoorDeviceAccessProxy.pressDoorBell(2000);

// Start rs485, baud rate 9600, read buffer size 32, timeout 3s
PassDoorDeviceAccessProxy..enableRS485(9600, 32, 
            new RS485Device.RS485ReceiveListener() {

            @Override
            public void onReceive(byte[] data, long dataLength) {
                // Received data
            }

        }, 3000, new SerialPortReader.OnReadTimeOutListener() {

            @Override
            public void onTimeout(byte[] data, long dataLength) {
                // Data read timeout
            }
        }
});

// Listen to it in the Activity via the onKeyUp() event
public class ForceDisassemblyDemoActivity extends AppCompatActivity {

    // Omit redundant code

    @Override
    public boolean onKeyUp(int keyCode, KeyEvent event) {
        if (keyCode == KeyEvent.KEYCODE_F2) {
            // Listen to tamper alarm
        }
        return super.onKeyUp(keyCode, event);
    }
}

SensorManager mSensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
// Use the light sensor. To use a distance sensor, use the parameter Sensor.TYPE_PROXIMITY
Sensor lightSensor = mSensorManager.getDefaultSensor(Sensor.TYPE_LIGHT);
if (lightSensor != null) {

    mSensorManager.registerListener(new SensorEventListener() {
        @Override
        public void onSensorChanged(SensorEvent event) {
            // Get the specific value via event.value[0] and do specific processing
        }

        @Override
        public void onAccuracyChanged(Sensor sensor, int accuracy) {

        }
    }, lightSensor, SensorManager.SENSOR_DELAY_NORMAL);

} else {
     // Sensor not available
}

android {

    signingConfigs {
        system {
            keyAlias 'sensetime'
            keyPassword 'sensetime'
            storeFile file('./sensetime.jks')
            storePassword 'sensetime'
        }
    }

    buildTypes {
        debug {
            signingConfig signingConfigs.system
            // ...
        }
        release {
            signingConfig signingConfigs.system
            // ...
        }
    }    
}

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.sensetime.wksample"
    android:sharedUserId="android.uid.system">
</manifest>

android {
     ...
     compileOptions {
         sourceCompatibility JavaVersion.VERSION_1_8
         targetCompatibility JavaVersion.VERSION_1_8
     }
}
dependencies {
    implementation files('libs/Thunder-android-vx.x.x.aar')
    //SDKで必要なサードパーティのライブラリ
    implementation 'com.alibaba:fastjson:1.2.70'
    implementation 'com.facebook.conceal:conceal:2.0.1@aar'
    implementation 'com.google.zxing:core:3.3.3'
    implementation 'com.github.open-android:pinyin4j:2.5.0'
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.okhttp3:okhttp:4.8.0'
    implementation 'com.squareup.okhttp3:logging-interceptor:4.8.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.4.0'
    implementation 'com.liulishuo.okdownload:okdownload:1.0.7'
    implementation 'com.liulishuo.okdownload:okhttp:1.0.7'
    implementation 'com.liulishuo.okdownload:sqlite:1.0.7'
}

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.NFC" />

//SDKで使用されているモデルを指定します。ここでは、SensePass デバイスでの初期化を例にとります。詳細については、サンプルコードをご覧ください。
model.mMode = SDKMode.PASS;
model.mAlignmentModel = "model/M_Align_occlusion_106_1.20.0.model";
model.mSmallDetectModel = "model/M_Detect_Hunter_LargeFaceSelfie_Gray_11.2.0.model";
model.mVerifyModel = "model/M_Verify_Mobilenetv2Pruned_BGR_Surveillance_4.13.0_v2_weak.model";
model.mDoubleHackModel = "model/pass_ext/M_Liveness_Antispoofing_Binocular_3.28.0.model";
model.mVerifyFinanceModel = "model/M_Verify_Mobilenetv2Pruned_BGR_Surveillance_4.13.0_v2_weak.model";
model.mAttributeModel = "model/M_Attribute_MTNet_2.1.1.model";

// assets ディレクトリ内のライセンスファイルの名前
String licenseName = "sensepass.lic";
String productName = null;

WuKong.auth(licenseName, productName, model, new IAuthCallback(){
            @Override
            public void onSuccess(){
                // アクティベーションに成功
            }

            @Override
            public void onFail(int code, String errMsg){
                // アクティベーションに失敗
            }
        });

<com.sensetime.camera.view.CameraTextureView
        android:id="@+id/camera_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:scalableType="centerCrop" />

CameraTextureView mCameraView = findViewById(R.id.camera_view);
Camera.PreviewCallback mRgbCallback = new Camera.PreviewCallback(){
        @Override
        public void onPreviewFrame(byte[] data, Camera camera){
            // Identify Manager に渡すことができる、データをプレビューするコールバック
            // IdentifyManager.getInstance().handleRgbData(data);
        }
};

// 顔カメラの設定を例にとります
CameraManager faceCameraManager = CameraManager.getInstance(CameraUtils.getFaceCameraIndex());
// データをプレビューするコールバックを追加します
faceCameraManager.addPreviewCallbackWithBuffer(mRgbCallback);
// カメラを有効化します
faceCameraManager.openCamera(getApplicationContext());
// プレビューの幅や高さ、顔の方向など、プレビュー関連のパラメーターを設定します
faceCameraManager.initParameters(1280, 720, 0, mCameraView.getSurfaceTexture());

// プレビューを開始します
faceCameraManager.startPreview();

// プレビューを停止します
faceCameraManager.stopPreview();

// カメラを解放します
faceCameraManager.releaseCamera();
faceCameraManager.setPreviewTexture(null);
faceCameraManager.removePreviewCallbackWithBuffer(mRgbCallback);
faceCameraManager.setCameraLifecycleCallback(null);
faceCameraManager.setCameraStatusCallback(null);
faceCameraManager.setCameraExceptionHandler(null);
faceCameraManager.setCameraDataUpdateCallback(null);

// サーマルイメージングシステムタイプを取得します
CameraType cameraType = TemperatureCameraUtils.getCameraType();
// カメラタイプに応じて、関連するサーマルイメージングシステムのインスタンスを取得します
ITemperatureCamera temperatureCamera = TemperatureCameraFactory.getTemperatureCamera(cameraType);

Initialize Thermal imaging system
temperatureCamera.initCamera(context);
// サーマルイメージングシステムの関連パラメーターを設定します(初期化後に実行する必要があります)
temperatureCamera.setConfig(config);
// シャッターを自動的に有効にするかどうかを設定します。デフォルトではtrueです(シャッターを有効にすると温度検知の精度が向上しますが、デバイスの耐用年数が短くなります)。
temperatureCamera.setAutoShutterEnable(true);

ITemperaturePreviewDataCallback dataCallback = new ITemperaturePreviewDataCallback(){

            @Override
            public void onTemperaturePreviewData(Bitmap temperatureBitmap, float[] temperatureValue, int width, int height){
                    // 熱力学線図および温度データのコールバック
            }
        };
// データコールバックを追加します
temperatureCamera.addTemperaturePreviewDataCallback(dataCallback);
// データが使用されていない場合、コールバックを削除します。
temperatureCamera.removeTemperaturePreviewDataCallback(dataCallback);
// 温度データは、摂氏で表示されないことに注意する必要があります。摂氏でデータを取得する場合は、次の方法で求めることができます。
temperatureCamera.getCentigradeFromTemperatureData(temperatureValue);
// または一括で変換することも可能です。
temperatureCamera.matrixTemperature(temperatureValue,width,height,distance,x,y,w,h,tempArray);

// サーマルイメージングシステムのプレビューを開始します
temperatureCamera.startPreview(textureView);
// サーマルイメージングシステムのプレビューを停止します
temperatureCamera.stopPreview();
// サーマルイメージングシステムのカメラリソースを解放します
temperatureCamera.releaseCamera();

// シャッターを有効にします(シャッターを有効にすると温度検知の精度が向上しますが、デバイスの耐用年数が短くなります)
temperatureCamera.shutter();

// 正面からの鮮明な写真1枚
Bitmap avatar = BitmapFactory.decode(R.id.avatar);
int userId =123;

if(avatar != null){
      // 写真から顔フィーチャーを取得します
      byte[] feature = FeatureManagerProxy.getInstance().getFeature(avatar);
      // フィーチャーライブラリを挿入します(ネイティブメモリ)。データの永続化には、上位ビジネス層での処理が必要です。
      int result = FeatureManagerProxy.getInstance().insert(userId, feature);
      if(result == 0){
            Log.d(TAG, "Face Feature Inserted Successfully");
      }
}

// 人物のフィーチャーを削除します
int result = FeatureManagerProxy.getInstance().delete(userId);
if(result == 0){
      Log.d(TAG, "Face Feature Deleted Successfully");
}

Camera.PreviewCallback mRgbCallback = new Camera.PreviewCallback(){
        @Override
        public void onPreviewFrame(byte[] data, Camera camera){
            // Identity Manager に RGB データのプレビューコールバックを転送します
            IdentifyManager.getInstance().handleRgbData(data);
        }
};
Camera.PreviewCallback mIrCallback = new Camera.PreviewCallback(){
        @Override
        public void onPreviewFrame(byte[] data, Camera camera){
            // Identity Manager に IR データのプレビューコールバックを転送します
            IdentifyManager.getInstance().handleIrData(data);
        }
};

 // デバイスのハードウェア環境に応じた、画像関連の設定を構成します
ImageConfig imageConfig = new ImageConfig.Builder()
          .previewW(1280)
          .previewH(720)
          .faceOrientation(FaceOrientation.UP)
          .pixelFormat(MidPixelFormat.NV21)
          .build();


// 初期化します
IdentifyManager.getInstance().init(imageConfig,identifyCallback);

// Identify Manager の認証モードを設定します
IdentifyManager.getInstance().setVerifyMode(VerifyModeEnum.MODE_1_N);
// 結果のコールバックを設定します
IdentifyManager.getInstance().setIdentifyCallback(identifyCallback);

//認証を有効にします
IdentifyManager.getInstance().start();

//認証を停止します
IdentifyManager.getInstance().stop();

// Identify Manager を解放します
IdentifyManager.getInstance().release();

IdentifyConfig identifyConfig = IdentifyManager.getInstance().getIdentifyConfig();
IdentifyConfig.hasLiveness = true; // 生体検知を有効にします
identifyConfig.isSingleLiveness = DeviceInfoUtils.isSenseIDProduct();   // モノキュラカメラによる生体検知では、本項目はIDシリーズのデバイスのみで有効にする必要があります
identifyConfig.isSenseGateConfig = DeviceInfoUtils.isSenseGateProduct();  // 使用しているデバイスが SenseGateシリーズの場合のみ、オンにします
identifyConfig.isContinueVerify = true; // IdentifyConfig.isContinueVerify = true; / / 連続して認証するかどうか。有効にすると、連続して認識されます(顔がカメラの視野に入っている必要があります)。continueVerifyIntervalTimeパラメーターと一緒に使用します。
identifyConfig.continueVerifyIntervalTime = 3000L;  // 同じ顔を続けて認証する間隔。isContinueVerifyがtrueに設定されている場合に有効になります。
identifyConfig.hasTemperatureDetection = false;
identifyConfig.isServerVerify = false;
IdentifyManager.getInstance().setIdentifyConfig(identifyConfig);

// 修正点は次のとおりです。1:N認証で、照合閾値が0.83fに、生体フィルタリング閾値が0.95f(超える場合は非生体になります)に変更されました。顔認証の最小値は、100ピクセルです。
ThresholdConfig thresholdConfig = IdentifyManager.getInstance().getThresholdConfig();
thresholdConfig.verifyScore = 0.83f;
thresholdConfig.livenessScore = 0.95f;
thresholdConfig.faceMinWidth =100;
thresholdConfig.verifyAreaRect = new RectF(0, 0, mPreviewHeight, mPreviewWidth);
IdentifyManager.getInstance().setThresholdConfig(thresholdConfig);

IIdentifyResultCallback identifyCallback = new IIdentifyResultCallback(){

    @Override
    public void onDrawFaces(@Nullable List<FaceInfo> list){
        // 顔検知のコールバック。顔設定フレームの描画に使用されます。
        // 認証が一時停止されても、このコールバックは発生することに注意する必要があります。その場合、プロセス内で顔はトラッキングされているものの、認識されていない状態となります。
    }

    @Override
    public void onClearScreen(){
        // スクリーンを消去するコールバック。カメラの視野に顔が入っていない場合、本コールバックでスクリーンを消去します。
    }

    @Override
    public void onUnknown(float faceW){
                // 顔が大きすぎたり、小さすぎたりして、生体であるかどうか判断できない場合は、本メソッドで通知されます
    }

    @Override
    public void onIdentifyResult(List<FrameIdentifyResult> frameIdentifyResults){
                //認証結果のコールバック
    }
};

// 結果を設定するコールバック
IdentifyManager.getInstance().setIdentifyCallback(identifyCallback);

// Identify Managerの初期化は、1:N認証の場合と同様です
// Identify Managerを1:Nから1:1に切り替える場合、まず単一の認証機能を設定してから、モードを切り替える必要があります

Bitmap singleTarget = BitmapFactory.decodeResource(getResource(), R.mipmap.face);
boolean setupResult = IdentifyManager.getInstance().setIdentifyTarget(singleTarget);
// Identify Managerの認証モードを設定します。設定する前に、各認証機能が正常に設定されているか確認します。
if(setupResult){
    IdentifyManager.getInstance().setVerifyMode(VerifyModeEnum.MODE_1_1);
}

//1. サーバー認証モードを有効にします
IdentifyManager.getInstance().setVerifyMode(VerifyModeEnum.MODE_SERVER_1_1);

//2. サーバー認証操作を実行します
IServerVerifyAction serverVerify = new IServerVerifyAction(){
        @Override
        public <T extends FaceSearchResult> T verify(@NonNull byte[] cameraData, byte[] feature, @Nullable FaceInfo rgbFace,int width, int height){

              // HTTPリクエストを介してデータをアップロードし、認証結果を取得します(適切なリクエストのタイムアウトを設定するようにご注意ください)
            // ..コード

            // 次の例のように、顔の検索結果を構築して取得します
            FaceSearchResult result = new FaceSearchResult();
            result.score = 0.93f;
            result.userID =12345;

            return(T)result;
        }
};

// 3. サーバー認証操作を設定します
IdentifyManager.getInstance().setServerVerifyAction(serverVerify);

// マスク着用認証を有効化します
IdentifyConfig identifyConfig = IdentifyManager.getInstance().getIdentifyConfig();
identifyConfig.isOpenWearMaskIdentify = true;
IdentifyManager.getInstance().setIdentifyConfig(identifyConfig);

// 認証結果のコールバックインターフェースを介して、顔認証結果を取得します
IIdentifyResultCallback identifyCallback = new IIdentifyResultCallback(){

    @Override
    public void onDrawFaces(@Nullable List<FaceInfo> list){
        // 顔検知のコールバック。顔設定フレームの描画に使用されます。
        // 認証が一時停止されても、このコールバックは発生することに注意する必要があります。その場合、プロセス内で顔はトラッキングされているものの、認識されていない状態となります。
    }

    @Override
    public void onClearScreen(){
        // スクリーンを消去するコールバック。カメラの視野に顔が入っていない場合、本コールバックでスクリーンを消去します。
    }

    @Override
    public void onUnknown(float faceW){
                // 顔が大きすぎたり、小さすぎたりして、生体であるかどうか判断できない場合は、本メソッドで通知されます
    }

    @Override
    public void onIdentifyResult(List<FrameIdentifyResult> frameIdentifyResults){
                //認証結果のコールバック
      for(int i = 0; i < frameIdentifyResults.size(); i++){
            FrameIdentifyResult frameIdentifyResult = frameIdentifyResults.get(i);
            List<FaceIdentifyResult> faceIdentifyResults = frameIdentifyResult.faceIdentifyResults;
            for(int j = 0; j < faceIdentifyResults.size(); j++){
                FaceIdentifyResult faceIdentifyResult = faceIdentifyResults.get(j);
                  // 顔認証結果を取得します
                  boolean mask = faceIdentifyResult.isMask();
            }
        }
    }
};

// 結果を設定するコールバック
IdentifyManager.getInstance().setIdentifyCallback(identifyCallback);

IdentifyConfig identifyConfig = IdentifyManager.getInstance().getIdentifyConfig();
identifyConfig.hasTemperatureDetection = true;    // 温度検知を有効にします
IdentifyManager.getInstance().setIdentifyConfig(identifyConfig);

ThresholdConfig thresholdConfig = IdentifyManager.getInstance().getThresholdConfig();
thresholdConfig.faceMinWidth = 200; // 温度検知では、近距離で、顔の幅を大きめに設定する必要があります
thresholdConfig.pitch = 20;   // 温度検知ではより厳しい条件が求められますが、前を向く顔であれば、より正確に温度を計測できます
thresholdConfig.roll = 20;
thresholdConfig.yaw = 20;
thresholdConfig.verifyAreaRect = new RectF(125, 400, 565, 835); // SensePassデバイスを例にとります       
IdentifyManager.getInstance().setThresholdConfig(thresholdConfig);

// カメラタイプを取得します
CameraType type = TemperatureCameraUtils.getCameraType();
// サーマルイメージングシステムオブジェクトを作成します
ITemperatureCamera mTemperatureCamera = TemperatureCameraFactory.getTemperatureCamera(type);
// 初期化します
mTemperatureCamera.initCamera(this);

// 温度比較アルゴリズムを初期化します(温度の調整用)
TemperConvertCallback temperConvertCallback = new TemperConvertCallback(){

            private float[] tempArray;

            @Override
            public float temperConvertCentigrade(float temper){

                return TemperatureCameraFactory.getTemperatureCamera(type).getCentigradeFromTemperatureData(temper);
            }

            @Override
            public float[] getTempMatrix(float[] y16Frame, int y16W, int y16H, float distance, int x, int y, int w, int h){

                int size = w * h;
                if(tempArray == null || tempArray.length != size){
                    tempArray = new float[size];
                }
                TemperatureCameraFactory.getTemperatureCamera(type).matrixTemperature(y16Frame, y16W, y16H, distance, x, y, w, h,                                         temperConvertCallback = tempArray);
                return tempArray;
            }
        };
int ret = TemperatureActionProxy.init(algorithmVersio, temperConvertCallbackn);
if(ret == 0){
        Log.d(TAG, "Temperature Measurement Algorithm Initialized Successfully");
}

ITemperatureSdkAction action = new ITemperatureSdkAction(){

            @Override
            public <T extends TrackAndTemperatureResult> List<T> temperCalculateAir(MatchFace[] matchFaces, @Nullable Bitmap temperatureBitmap, float[] temperatureData, int temperatureWidth, int temperatureHeight, FaceOrientation temperatureOrientation){
                // 使用している機器の周囲の温度
                // CameraType が CameraType.GUIDE120 または CameraType.IRAY の場合のコード例は次のとおりです
                   MatchFace matchFace = matchFaces[0];
                    float envTemperature = 25.1f;
                    TemperInfo temperInfo = TemperatureActionProxy.temperCalculateObtainRect(matchFace.rgbFace, temperatureData,
                                                                                     temperatureWidth, temperatureHeight, FaceOrientation.UP.getValue(), envTemperature, 0.1f);
                    TrackAndTemperatureResult trackAndTemperatureResult = new TrackAndTemperatureResult();
                    trackAndTemperatureResult.setFaceInfo(matchFace.rgbFace);
                    trackAndTemperatureResult.setIrFaceInfo(matchFace.irFace);
                    trackAndTemperatureResult.setTemperature(temperInfo.temper);

                    List<T> ts = new ArrayList<>();
                    ts.add((T)trackAndTemperatureResult);
                    return ts;
            }
        };
            }
        };
// Temperature Sdk Action を設定します
IdentifyManager.getInstance().setTemperatureSdkAction(action);

ITemperaturePreviewDataCallback mPreviewDataCallback =
          new ITemperaturePreviewDataCallback(){

          @Override
      public void onTemperaturePreviewData(
            Bitmap temperatureBitmap, float[] temperatureValue, int width, int height){

                // temperatureBitmap - 温度ビットマッププレビューの描画に使用できる熱力学線図
                // temperatureValue - 温度データ
                // 幅、高さ - 熱力学線図の熱の幅および高さ

                // Identify Manager に温度データを挿入します(温度検知機能を有効化後に温度データが挿入されない場合、認証は実行されません)
                IdentifyManager.getInstance().handleTemperatureData(
                  temperatureBitmap, temperatureValue,width, height, mCameraUseConfig.faceOrientation);
            }
        };

// コールバックを設定します
mTemperatureCamera.addTemperaturePreviewDataCallback(mPreviewDataCallback);

//認証結果コールバックインターフェースを介して、顔認証結果を取得します
IIdentifyResultCallback identifyCallback = new IIdentifyResultCallback(){

    @Override
    public void onDrawFaces(@Nullable List<FaceInfo> list){
        // 顔検知コールバック。顔設定フレームの描画に使用できます。
        // 認証が一時停止されてもこのコールバックは発生することに注意する必要があります。その場合、プロセス内で顔はトラッキングされているものの、認識されていない状態となります。
    }

    @Override
    public void onClearScreen(){
        // スクリーンを消去するコールバック。カメラの視野に顔が入っていない場合、本コールバックでスクリーンを消去します。
    }

    @Override
    public void onUnknown(float faceW){
                // 顔が大きすぎたり、小さすぎたりして、生体であるかどうか判断できない場合は、本メソッドで通知されます
    }

    @Override
    public void onIdentifyResult(List<FrameIdentifyResult> frameIdentifyResults){
                //認証結果のコールバック
              for(int i = 0; i < frameIdentifyResults.size(); i++){
            FrameIdentifyResult frameIdentifyResult = frameIdentifyResults.get(i);
            if(frameIdentifyResult == null
                    || frameIdentifyResult.faceIdentifyResults == null
                    || frameIdentifyResult.faceIdentifyResults.size()<= 0){
                continue;
            }
            List<FaceIdentifyResult> faceIdentifyResults = frameIdentifyResult.faceIdentifyResults;
            for(int j = 0; j < faceIdentifyResults.size(); j++){
                FaceIdentifyResult faceIdentifyResult = faceIdentifyResults.get(j);
                if(faceIdentifyResult == null || faceIdentifyResult.getIdentifyResultTypeEnum()== null){
                    continue;
                }
                TrackAndTemperatureResult trackAndTemperatureResult = faceIdentifyResult.getTrackAndTemperatureResult();
                float temperature = 0;
                if(trackAndTemperatureResult != null){
                    temperature = trackAndTemperatureResult.getTemperature();
                }
                Log.i(TAG, String.format(Locale.getDefault(), "userId-%d temperature is %f",
                                         faceIdentifyResult.getUserId(), temperature));
            }
        }
    }
};

// 結果を設定するコールバック
IdentifyManager.getInstance().setIdentifyCallback(identifyCallback);

// Passアクセスコントロール機能を使用する前に、本機能の初期化を呼び出す必要があります
DoorDeviceAccessProxy.init();

final DoorAccessConfig config = new DoorAccessConfig.Builder()
        // GPIO の B ポートの入力タイプを設定します。デフォルトでは GPIO_IN_NONE に設定されます。
        .setGpioInB(DoorAccessConfig.GPIO_IN_NONE)
        // GPIO の C ポートの入力タイプを設定します。デフォルトでは GPIO_IN_NONE に設定されます。
        .setGpioInC(DoorAccessConfig.GPIO_IN_NONE)
        // ドアオープン時間を設定します。ローカルリレーのみ(ここでは、開いた後、5 秒で閉じるように設定しています)。
        .setOpenDoorTime(5)
        // GPIO 出力タイプを設定します
        .setGpioOutA(DoorAccessConfig.GPIO_OUT_NONE)
        // RS485 データの読み書きをファームウェアで制御します(ファームウェアに対応している必要があります。対応していない場合は、false に設定してください)
        .setIsSupportRS485GpioAutoControl(true)
        // Wiegand 入力プロトコルタイプを設定します
        .setWiegandInput(DoorAccessConfig.WIEGAND26_24_BIT)
        // ドアオープンモードを設定します
        .setOpenDoorMode(DoorAccessConfig.OPEN_DOOR_MODE_RELAY)
        .Setthe Serial Port Baud Rate for RS485 Protocol
        .setRS485BaudRate(9600)
        .build();
DoorDeviceAccessProxy.setConfig(config);

// オープンドアモードを「ローカルリレー」に設定します
DoorAccessConfig mDoorAccessConfig = DoorDeviceAccessProxy.getConfig();
mDoorAccessConfig.setOpenDoorMode(DoorAccessConfig.OPEN_DOOR_MODE_RELAY);
DoorDeviceAccessProxy.setConfig(mDoorAccessConfig);

// 本メソッドはグローバルなドアオープンメソッドで、設定された方法に応じて自動的にドアオープン操作を実行します
// IC カード番号は入力パラメーターがWiegand Open Doorの場合のみ使用します。ここに直接転送します。
DoorDeviceAccessProxy.openDoor("");

DoorAccessConfig mDoorAccessConfig = DoorDeviceAccessProxy.getConfig();
// IP 番号を入力するだけです。デフォルトでポートは12345 に設定されています。初期化時に設定されている場合は、ここでは繰り返し設定不要です。
mDoorAccessConfig.setRelayIp("192.168.12.11");
// オープンドアモードをネットワークリレーに設定します
mDoorAccessConfig.setOpenDoorMode(DoorAccessConfig.OPEN_DOOR_MODE_IP_RELAY);
DoorDeviceAccessProxy.setConfig(mDoorAccessConfig);

// パラメーターは、クローズ遅延時間です。自由に設定できます。
DoorDeviceAccessProxy.openDoor("");

DoorAccessConfig config = DoorDeviceAccessProxy.getConfig();
// Wiegand 26標準カードリーダーを設定します
config.setWiegandInput(DoorAccessConfig.WIEGAND26_24_BIT);
DoorDeviceAccessProxy.setConfig(config);

DoorDeviceAccessProxy.setCardReaderCallback(
            new WiegandReaderDevice.CardReaderCallback(){

    @Override
    public void onRead(String cardNumber){
        // カード番号の読み取りに成功しました。cardNumberがカード番号です。
    }
});

DoorAccessConfig mDoorAccessConfig = DoorDeviceAccessProxy.getConfig();
// ここでは、周辺機器がBポートを介して、ドアボタンに接続されていると仮定します。Cポートを使用する場合は、doorAccessConfig.setGpioInC()を設定してください。
mDoorAccessConfig.setGpioInB(DoorAccessConfig.GPIO_IN_DOOR_BUTTON);
DoorDeviceAccessProxy.setConfig(mDoorAccessConfig);

// ドアボタンを使用する場合
PassDoorDeviceAccessProxy.setOnClickDoorButtonListener(
                new DoorButtonDevice.DoorButtonOnClickListener(){

        @Override
        public void onClick(){
            // ドアオープン信号を受け取ります
        }
});

// 消防アラートシグナル受信リスナーを使用する場合
PassDoorDeviceAccessProxy.setReceiveFireSignListener(
                new FireSignalDevice.ReceiveFireSignListener(){

        @Override
        public void onReceive(){
            // 消防アラートシグナルを受け取ります
        }
});

// ドアセンサーを使用する場合
PassDoorDeviceAccessProxy.setDoorStateCallback(
                new PassDoorDeviceAccessProxy.DoorMagnetismStateCallback(){

        @Override
        public void onDoorStateChanged(int state){
            if(state == '0'){
                // ドアの磁器ステータス: オフ
            } else {
                // ドアの磁器ステータス: オン
            }
        }
});

DoorAccessConfig sgDoorAccessConfig = DoorDeviceAccessProxy.getConfig();
// ここでは、ドアベルを使用していると仮定しています
sgDoorAccessConfig.setGpioOutA(DoorAccessConfig.GPIO_OUT_DOOR_BELL);
DoorDeviceAccessProxy.setConfig(sgDoorAccessConfig);

// ドアベルを鳴らす場合のパラメーターは時間です(ドアベルのメーカーは鳴動時間を指定するのではなく、回数を指定して鳴らすように設定している場合があるため、実際の鳴動時間には誤差が生じる可能性があります)
PassDoorDeviceAccessProxy.pressDoorBell(2000);

// スクリーンバックライトをオフにします
PassDoorDeviceAccessProxy.closeBackLight();

// スクリーンバックライトをオンにします
PassDoorDeviceAccessProxy.openBackLight();

// RS485を開始し、ボーレートを9600、読み取りバッファーサイズを32、タイムアウト時間を3秒にそれぞれ設定します
PassDoorDeviceAccessProxy..enableRS485(9600, 32,
            new RS485Device.RS485ReceiveListener(){

            @Override
            public void onReceive(byte[] data, long dataLength){
                // 受信データ
            }

        }, 3000, new SerialPortReader.OnReadTimeOutListener(){

            @Override
            public void onTimeout(byte[] data, long dataLength){
                // データ読み取りタイムアウト
            }
        }
});

// onKeyUp()イベントを介してアクティビティでリッスンします
public class ForceDisassemblyDemoActivity extends AppCompatActivity {

    // 冗長コードは省略します

    @Override
    public boolean onKeyUp(int keyCode, KeyEvent event){
        if(keyCode == KeyEvent.KEYCODE_F2){
            // 盗難アラートをlistenします
        }
        return super.onKeyUp(keyCode, event);
    }
}

SensorManager mSensorManager =(SensorManager)getSystemService(Context.SENSOR_SERVICE);
// 照明センサーを使用します。距離センターを使用するには、Sensor.TYPE_PROXIMITY パラメーターを使用します。
Sensor lightSensor = mSensorManager.getDefaultSensor(Sensor.TYPE_LIGHT);
if(lightSensor != null){

    mSensorManager.registerListener(new SensorEventListener(){
        @Override
        public void onSensorChanged(SensorEvent event){
            // event.value[0]を介して特定の値を取得し、特定の処理を実行します
        }

        @Override
        public void onAccuracyChanged(Sensor sensor, int accuracy){

        }
    }, lightSensor, SensorManager.SENSOR_DELAY_NORMAL);

} else {
     // センサーを使用できません
}

android {

    signingConfigs {
        system {
            keyAlias 'sensetime'
            keyPassword 'sensetime'
            storeFile file('./sensetime.jks')
            storePassword 'sensetime'
        }
    }

    buildTypes {
        debug {
            signingConfig signingConfigs.system
            // ...
        }
        release {
            signingConfig signingConfigs.system
            // ...
        }
    }
}

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.sensetime.wksample"
    android:sharedUserId="android.uid.system">
</manifest>

QRCodeDecoderProxy qRCodeDecoder = new QRCodeDecoderProxy(new ZBarDecoderImpl());
// previewData は、カメラのプレビューフレームデータです
qRCodeDecoder.decodeQRCode(previewData,1280, 720);

Door Access

Door Access Device Controling Pass and Thunder series devices

Description of functional types

DoorDeviceAccessProxy

Control the overall initialization, configuration, and resource release operations of communication devices such as GPIO ports and serial ports of the control device, and perform specific door opening operations.

Description of Member Function

DoorAccessConfig getConfig()

Get Door Access Configuration

Parameter

None

Return

Exception

None

DoorAccessDevice getDevice(int deviceType)

Get device reference according to device type

Parameter

Return

Exception

None

void changeOpenDoorDevice(int mode)

Change Open Door Mode

Parameter

Return

None

Exception

None

void closeRelayDoor()

Close Relay Door

Parameter

None

Return

None

Exception

None

void init()

Initialization without serial port number, refer to [void init(String uartName)](#void init(String uartName))

Parameter

None

Return

None

Exception

None

void init(String uartName)

Initialization with serial port number

Parameter

Return

None

Exception

None

void openDoor(String cardNumber)

Open the door, execute the door opening action according to the set open door mode

Parameter

Return

Exception

void release()

Release Resource

Parameter

None

Return

None

Exception

None

void setConfig(DoorAccessConfig config)

Set Door Access Configuration

Parameter

Return

None

Exception

None

void setCardReaderCallback(WiegandReaderDevice.CardReaderCallback cardReaderCallback)

Set Card Read Callback

Parameter

Return

None

Exception

None

void setCustomWiegandDataReceivedCallback(WiegandReaderDevice.OnDataReceivedCallback dataReceivedCallback)

Set Custom Wiegand Data Interface Callback

Parameter

Return

Exception

void setICardNumberAnalysis(WiegandDoorDevice.ICardNumberAnalysis cardNumberAnalysis)

Set Wiegand Card Number String Parsing Method

Parameter

Return

Exception

PassDoorDeviceAccessProxy

Control some door access devices of Pass and Thunder series

Description of Member Function

void closeBackLight()

Close Back Light

Parameter

None

Return

None

Exception

None

void enableRS485(RS485Device.RS485ReceiveListener listener)

Enable RS485

Parameter

Return

None

Exception

None

void enableRS485(int baudrate, int readBufferSize, RS485Device.RS485ReceiveListener listener)

Enable RS485

Parameter

Return

None

Exception

None

void enableRS485(int baudrate, int readBufferSize, RS485Device.RS485ReceiveListener listener, int readTimeout, SerialPortReader.OnReadTimeOutListener timeOutListener)

Enable RS485

Parameter

Return

None

Exception

None

void openBackLight()

Open Back Light

Parameter

None

Return

None

Exception

None

void pressBuzzer()

press Buzzer (Only support SensePass and SenseThunderE-mini)

Parameter

None

Return

None

Exception

None

void pressDoorBell(int pressDownDuration)

press Door Bell

Parameter

Return

None

Exception

None

void pressAlarmBell()

Press Alarm Bell to Turn the Alarm On

Parameter

None

Return

None

Exception

None

void releaseAlarmBell()

Release Alarm Bell

Parameter

None

Return

None

Exception

None

void releaseBuzzer()

Buzzer Off (Only supports SensePass020)

Parameter

None

Return

None

Exception

None

void setDoorStateCallback(DoorMagnetismStateCallback callback)

Set Door State Callback, Door Open/Close Status Listener

Parameter

Return

None

Exception

None

void setOnClickDoorButtonListener(DoorButtonDevice.DoorButtonOnClickListener listener)

Door Button On Click Listener

Parameter

Return

None

Exception

None

void setReceiveFireSignListener(FireSignalDevice.ReceiveFireSignListener listener)

Receive Fire Sign Listener

Parameter

Return

None

Exception

None

void sendDataByRS485(byte[] data)

Send Data By RS485

Parameter

Return

None

Exception

None

void turnOnIrLight()

Turn on IR Light, Support Pass and Thunder series

Parameter

None

Return

None

Exception

None

void turnOffIrLight()

Turn off IR Light, Support Pass and Thunder series

Parameter

None

Return

None

Exception

None

Description of Entities

DoorAccessConfig

Door Access Configuration

Description of Properties

OPEN_DOOR_MODE

Wiegand Input

GPIO Configuration

Settable Properties

Description of Method

DoorAccessDevice

Door Access Device

Description of Method

CardReaderCallback

WIEGAND Device Card Reader Callback

Description of Method

OnDataReceivedCallback

Wiegand Passthough Data Received Callback

Description of Method

ICardNumberAnalysis

Analysis of Customized Wiegand Card Number Data

Description of Method

DoorMagnetismStateCallback

Door Magnetism State Callback

Description of Method

ReceiveFireSignListener

Fire Sign Listener

Description of Method

ReceiveDismantleSignListener

Dismantle Sign Listener

Description of Method

SensorListener

Sensor Data change interface

Description of Method

OnSensorChangedListener

Ir Listener

Description of Method

RS485ReceiveListener

RS485 Data Read Listener

Description of Method

OnReadTimeOutListener

RS485 Data Read Time Out Callback

Description of Method

DoorButtonOnClickListener

Door Button On Click Listener

Description of Method

識別エンジン

人間の顔1:1 比較、ローカル1:N 識別、サーバ1:N識別、マスク検知にサポート

機能類の説明

IdentifyManager

識別エンジンを操作する入り口

メンバー関数の説明

boolean setIdentifyTarget(Bitmap avatar)

個人の識別フィーチャーを設定

パラメータ

戻り値

例外

なし

ImageConfig getImageConfig()

画像構成を取得

パラメータ

なし

戻り値

ImageConfig

例外

なし

IdentifyConfig getIdentifyConfig()

識別エンジンのワークフロー構成を取得

パラメータ

なし

戻り値

IdentifyConfig

例外

なし

ThresholdConfig getThresholdConfig()

しきい値構成を取得

パラメータ

なし

戻り値

ThresholdConfig

例外

なし

void addFaceFilterInterceptor(IFaceFilterInterceptor faceFilterInterceptor)

顔フィルターインターセプターを追加

パラメータ

戻り値

なし

例外

なし

void handleRgbData(byte[] data)

RGBデータをハンドル

パラメータ

戻り値

なし

例外

なし

void handleIrData(byte[] data)

IRデータをハンドル

パラメータ

戻り値

なし

例外

なし

void handleTemperatureData(Bitmap temperatureBitmap,float[] temperatureValue, int width, int height, FaceOrientation temperatureOrientation)

ヒートマップと関連データをハンドル

パラメータ

戻り値

なし

例外

なし

void init(ImageConfig imageConfig, IIdentifyResultCallback identifyResultCallback)

初期化

パラメータ

戻り値

なし

例外

なし

void pause()

顔認識を中止

パラメータ

なし

戻り値

なし

例外

なし

void resume()

顔認識を回復

パラメータ

なし

戻り値

なし

例外

なし

void release()

リソースを解放

パラメータ

なし

戻り値

なし

例外

なし

void removeFaceFilterInterceptor(IFaceFilterInterceptor faceFilterInterceptor)

顔フィルターインターセプターを削除

パラメータ

戻り値

なし

例外

なし

void removeIdentifyTarget()

設定した個人の識別フィーチャーを削除

パラメータ

なし

戻り値

なし

例外

なし

void start()

識別を開始

パラメータ

なし

戻り値

なし

例外

なし

void stop()

識別を停止

パラメータ

なし

戻り値

なし

例外

なし

void setIdentifyCallback(IIdentifyResultCallback iIdentifyCallback)

識別結果コールバックを設定

パラメータ

戻り値

なし

例外

なし

void setVerifyMode(VerifyModeEnum verifyMode)

識別エンジンの検証モードを設定

パラメータ

戻り値

なし

例外

なし

void setThresholdConfig(ThresholdConfig thresholdConfig)

しきい値構成を設定

パラメータ

戻り値

なし

例外

なし

void setIdentifyConfig(IdentifyConfig identifyConfig)

識別エンジンワークフロー構成を設定

パラメータ

戻り値

なし

例外

なし

void setServerVerifyAction(IServerVerifyAction serverVerifyAction)

サーバの検証ロジックを設定

パラメータ

戻り値

なし

例外

なし

void setTemperatureSdkAction(ITemperatureSdkAction temperatureSdkAction)

温度検知アルゴリズムの動作を設定

パラメータ

戻り値

なし

例外

なし

エンティティの説明

ImageConfig

プロパティの説明

MidPixelFormat

プロパティの説明

FaceOrientation

プロパティの説明

IdentifyConfig

プロパティの説明

ThresholdConfig

プロパティの説明

IFaceFilterInterceptor

メソッドの説明

FaceInfo

プロパティの説明

VerifyModeEnum

プロパティの説明

IIdentifyResultCallback

メソッドの説明

FaceFilterResult

プロパティの説明

AttributeFilterResult

プロパティの説明

AttributeResult

プロパティの説明

FrameIdentifyResult

プロパティの説明

FaceIdentifyResult

プロパティの説明

TrackAndTemperatureResult

プロパティの説明

IdentifyResultTypeEnum

プロパティの説明

FaceSearchResult

プロパティの説明

IServerVerifyAction

メソッドの説明

ITemperatureSdkAction

プロパティの説明

Identify Manager

Support Human Face 1:1 Verification, Local 1:N Identification, Server 1:N Identification and Face Mask Detection.

Description of functional types

IdentifyManager

Entrance for the Identify Manager

Description of Member Function

boolean setIdentifyTarget(Bitmap avatar)

Set Individual Identification Feature

Parameter

Return

Exception

None

ImageConfig getImageConfig()

Get Image Configuration

Parameter

None

Return

ImageConfig

Exception

None

IdentifyConfig getIdentifyConfig()

Get Identify Manager Workflow Configuration

Parameter

None

Return

IdentifyConfig

Exception

None

ThresholdConfig getThresholdConfig()

Get Threshold Configuration

Parameter

None

Return

ThresholdConfig

Exception

None

void addFaceFilterInterceptor(IFaceFilterInterceptor faceFilterInterceptor)

Add Face Filter Interceptor

Parameter

Return

None

Exception

None

void handleRgbData(byte[] data)

Handle rgb Data

Parameter

Return

None

Exception

None

void handleIrData(byte[] data)

Handle irb Data

Parameter

Return

None

Exception

None

void handleTemperatureData(Bitmap temperatureBitmap,float[] temperatureValue, int width, int height, FaceOrientation temperatureOrientation)

Handle Thermodynamic Diagram and Related Data

Parameter

Return

None

Exception

None

void init(ImageConfig imageConfig, IIdentifyResultCallback identifyResultCallback)

Initialize

Parameter

Return

None

Exception

None

void pause()

Pause Face Identification

Parameter

None

Return

None

Exception

None

void resume()

Resume Face Identification

Parameter

None

Return

None

Exception

None

void release()

Release Resource

Parameter

None

Return

None

Exception

None

void removeFaceFilterInterceptor(IFaceFilterInterceptor faceFilterInterceptor)

Remove Face Filter Interceptor

Parameter

Return

None

Exception

None

void removeIdentifyTarget()

Remove the Set Individual Identification Feature

Parameter

None

Return

None

Exception

None

void start()

Start Identification

Parameter

None

Return

None

Exception

None

void stop()

Stop Identification

Parameter

None

Return

None

Exception

None

void setIdentifyCallback(IIdentifyResultCallback iIdentifyCallback)

Set Identification Result Callback

Parameter

Return

None

Exception

None

void setVerifyMode(VerifyModeEnum verifyMode)

Set the Verification Mode for the Identification Manager

Parameter

Return

None

Exception

None

void setThresholdConfig(ThresholdConfig thresholdConfig)

Set Threshold Configuration

Parameter

Return

None

Exception

None

void setIdentifyConfig(IdentifyConfig identifyConfig)

Set Identification Manager Workflow Configuration

Parameter

Return

None

Exception

None

void setServerVerifyAction(IServerVerifyAction serverVerifyAction)

Set Server Verification Logic

Parameter

Return

None

Exception

None

void setTemperatureSdkAction(ITemperatureSdkAction temperatureSdkAction)

Set Temperature Measurement Sdk Action

Parameter

Return

None

Exception

None

Description of Entities

ImageConfig

Description of Properties

MidPixelFormat

Description of Properties

FaceOrientation

Description of Properties

IdentifyConfig

Description of Properties

ThresholdConfig

Description of Properties

IFaceFilterInterceptor

Description of Method

FaceInfo

Description of Properties

VerifyModeEnum

Description of Properties

IIdentifyResultCallback

Description of Method

FaceFilterResult

Description of Properties

AttributeFilterResult

Description of Properties

AttributeResult

Description of Properties

FrameIdentifyResult

Description of Properties

FaceIdentifyResult

Description of Properties

TrackAndTemperatureResult

Description of Properties

IdentifyResultTypeEnum

Description of Properties

FaceSearchResult

Description of Properties

IServerVerifyAction

Description of Method

ITemperatureSdkAction

Description of Properties

ドアアクセス

PassとThunderシリーズのドアアクセスデバイスをコントロール

機能類の説明

DoorDeviceAccessProxy

制御デバイスのGPIOポートやシリアルポートなどの通信デバイスの全体的な初期化、構成、およびリソース解放操作を制御し、特定のドアオープン操作を実行

メンバー関数の説明

DoorAccessConfig getConfig()

ドアアクセス構成を取得

パラメータ

なし

戻り値

例外

なし

DoorAccessDevice getDevice(int deviceType)

デバイスタイプによってデバイス引数を取得

パラメータ

戻り値

例外

なし

void changeOpenDoorDevice(int mode)

ドアオープンモードを変更

パラメータ

戻り値

なし

例外

なし

void closeRelayDoor()

リレードアを閉じます

パラメータ

なし

戻り値

なし

例外

なし

void init()

シリアルポートナンバーなしの初期化。[void init(String uartName)]\を参照

パラメータ

なし

戻り値

なし

例外

なし

void init(String uartName)

シリアルポートナンバーがある場合の初期化

パラメータ

戻り値

なし

例外

なし

void openDoor(String cardNumber)

ドアをオープン。設定したドアオープンモードに従いオープンを実行

パラメータ

戻り値

なし

例外

なし

void release()

リソースを解放

パラメータ

なし

戻り値

なし

例外

なし

void setConfig(DoorAccessConfig config)

ドアアクセス構成を設定

パラメータ

戻り値

なし

例外

なし

void setCardReaderCallback(WiegandReaderDevice.CardReaderCallback cardReaderCallback)

カード読み取りコールバックを設定

パラメータ

戻り値

なし

例外

なし

void setCustomWiegandDataReceivedCallback(WiegandReaderDevice.OnDataReceivedCallback dataReceivedCallback)

カスタムWiegandデータインタフェースコールバックを設定

パラメータ

戻り値

なし

例外

なし

void setICardNumberAnalysis(WiegandDoorDevice.ICardNumberAnalysis cardNumberAnalysis)

Wiegandカードナンバー解析方式を設定

パラメータ

戻り値

なし

例外

なし

PassDoorDeviceAccessProxy

SensePassとSenseThunderシリーズの一部ドアアクセスデバイスをコントロール

メンバー関数の説明

void closeBackLight()

バックライトをオフ

パラメータ

なし

戻り値

なし

例外

なし

void enableRS485(RS485Device.RS485ReceiveListener listener)

RS485を有効

パラメータ

戻り値

なし

例外

なし

void enableRS485(int baudrate, int readBufferSize, RS485Device.RS485ReceiveListener listener)

RS485を有効

パラメータ

戻り値

なし

例外

なし

void enableRS485(int baudrate, int readBufferSize, RS485Device.RS485ReceiveListener listener, int readTimeout, SerialPortReader.OnReadTimeOutListener timeOutListener)

RS485を有効

パラメータ

戻り値

なし

例外

なし

void openBackLight()

バックライトをオン

パラメータ

なし

戻り値

なし

例外

なし

void pressBuzzer()

ブザーをオン（SensePassとSenseThunderE-miniにのみ対応）

パラメータ

なし

戻り値

なし

例外

なし

void pressDoorBell(int pressDownDuration)

ドアベルを押す

パラメータ

戻り値

なし

例外

なし

void pressAlarmBell()

アラートをオンにするためにアラートベルを押下

パラメータ

なし

戻り値

なし

例外

なし

void releaseAlarmBell()

アラートベルを解除

パラメータ

なし

戻り値

なし

例外

なし

void releaseBuzzer()

ブザーをオフに（SensePass020にのみサポート）

パラメータ

なし

戻り値

なし

例外

なし

void setDoorStateCallback(DoorMagnetismStateCallback callback)

ドアステータスのコールバックを設定し、ドアの開閉ステータスをモニタリング

パラメータ

戻り値

なし

例外

なし

void setOnClickDoorButtonListener(DoorButtonDevice.DoorButtonOnClickListener listener)

ドアボタンのクリック状態のリスナー

パラメータ

戻り値

なし

例外

なし

void setReceiveFireSignListener(FireSignalDevice.ReceiveFireSignListener listener)

Receive 消防シグナルのリスナー

パラメータ

戻り値

なし

例外

なし

void sendDataByRS485(byte[] data)

RS485でデータ送信

パラメータ

戻り値

なし

例外

なし

void turnOnIrLight()

IRライトをオン。SensePassとSenseThunderシリーズをサポート

パラメータ

なし

戻り値

なし

例外

なし

void turnOffIrLight()

IRライトをオフに。SensePassとSenseThunderシリーズをサポート

パラメータ

なし

戻り値

なし

例外

なし

エンティティの説明

DoorAccessConfig

ドアアクセス構成

プロパティの説明

ドアオープンモード

Wiegand入力

GPIO構成

設定可能なプロパティ

メソッドの説明

DoorAccessDevice

ドアアクセスデバイス

メソッドの説明

CardReaderCallback

WIEGANDデバイスカードリーダーのコールバック

メソッドの説明

OnDataReceivedCallback

Wiegandパススルーデータ受信のコールバック

メソッドの説明

ICardNumberAnalysis

カスタマイズされたWiegandカードナンバーデータの解析

メソッドの説明

DoorMagnetismStateCallback

ドアマグネットステータスのコールバック

メソッドの説明

ReceiveFireSignListener

消防シグナルのリスナー

メソッドの説明

ReceiveDismantleSignListener

盗難アラートのリスナー

メソッドの説明

SensorListener

センサーデータ変更インターフェース

メソッドの説明

OnSensorChangedListener

IRリスナー

メソッドの説明

RS485ReceiveListener

RS485データ読み取りリスナー

メソッドの説明

OnReadTimeOutListener

RS485データ読み取りタイムアウトのコールバック

メソッドの説明

DoorButtonOnClickListener

ドアボタンのクリック状態をモニタリング

メソッドの説明

MqttApiClient

MQTT Interface implementation

MqttApiClient

Member Function

Description

Version introduced

void connectMqtt(IMqttActionListener listener, IConnectionLost connectionLost, boolean useTokenConnect, SocketFactory socketFactory)

Connect MQTT

Description of Member Function

void connectMqtt(IMqttActionListener listener, IConnectionLost connectionLost, boolean useTokenConnect, SocketFactory socketFactory)

Connect MQTT

Parameter

Return

None

Exception

None

void disConnectMqtt(IMqttActionListener listener)

Disconnect MQTT

Parameter

Return

None

Exception

None

void getUserListInGroup(int groupId, MessageCallback callback)

Get User List In a Group

Parameter

Return

None

Exception

None

void registerGroupChangeListener(MessageCallback callback)

Parameter

Return

None

Exception

None

void registerUserInGroupChangeListener(int groupId, MessageCallback callback)

Parameter

Return

None

Exception

None

void registerWarningAction(MessageCallback callback)

Parameter

Return

None

Exception

None

void registerAccessStrategy(MessageCallback callback)

Parameter

Return

None

Exception

None

void registerUpgrade(MessageCallback callback)

Parameter

Return

None

Exception

None

void registerDeviceStatus(MessageCallback callback)

Parameter

Return

None

Exception

None

void registerDeviceConfig(MessageCallback callback)

Parameter

Return

None

Exception

None

void registerDeviceNotify(MessageCallback callback)

Parameter

Return

None

Exception

None

void registerKeepDoorOpenOrCloseSchedule(MessageCallback callback)

Parameter

Return

None

Exception

None

void unRegisterGroupChangeListener()

Unregister Device and User In Group Change Callback

Parameter

None

Return

None

Exception

None

void unegisterUserInGroupChangeListener(int groupId)

Unregister User In Group Change Callback

Parameter

Return

None

Exception

None

void unegisterGetUserListInGroup(int groupId)

Unregister User List of a Group

Parameter

Return

Exception

void unRegisterWarningAction()

Unregister Warning Action Change Callback

Parameter

None

Return

None

Exception

None

void unRegisterAccessStrategy()

Unregister Access Strategy Change Callback

Parameter

None

Return

None

Exception

None

void unRegisterUpgrade()

Unregister APP and ROM Update Callback

Parameter

Return

Exception

void unRegisterDeviceStatus()

Unregister Device Status Change Callback

Parameter

None

Return

None

Exception

None

void unRegisterDeviceConfig()

Unregister Device Configuration Change Callback

Parameter

None

Return

None

Exception

None

void unRegisterDeviceNotify()

Unregister Device Server End Notification Push Callback

Parameter

None

Return

None

Exception

None

void unRegisterKeepDoorOpenOrCloseSchedule()

Unregister Device Keep Door Open Or Close Schedule Push Callback

Parameter

None

Return

None

Exception

None

Description of Entities

LanguageTypeEnum

Description of Properties

ConnectConfigEntity

Description of Properties

Result

Description of Properties

Description of Method

AlarmReportParameter

Description of Properties

VerticesItem

Description of Properties

GuestDetailInfo

Description of Properties

GroupsItem

Description of Properties

TslCheckExistResult

Description of Properties

TslLanguageCheckExistResult

Description of Properties

FaceSearchResult

Description of Properties

SearchResultItem

Description of Properties

Content

Description of Properties

FaceSearchParameter

Description of Properties

ImagesItem

Description of Properties

TargetInfo

Description of Properties

Angle

Description of Properties

Rectangle

Description of Properties

VerticesItem

Description of Properties

LandmarksItem

Description of Properties

CameraInfo

Description of Properties

GroupIndex

Description of Properties

UserIndex

Description of Properties

UserInfoResult

Description of Properties

UserInfoParameter

Description of Properties

DeviceGroups

Description of Properties

DeviceDetailInfo

Description of Properties

DeviceTypeMaxOnline

Description of Properties

ServiceConfigItem

Description of Properties

Options

Description of Properties

Company

Description of Properties

RsaResult

Description of Properties

UserDetailInfo

Description of Properties

DeptItem

Description of Properties

ServerVersion

Description of Properties

TimeTable

Description of Properties

SpecialDay

Description of Properties

QRResult

Description of Properties

IdentifyQRCodeParameter

Description of Properties

LoginResult

Description of Properties

UserRspVO

Description of Properties

DepartmentRouteItem

Description of Properties

Device

Description of Properties

MisrecognitionRecordParameter

Description of Properties

RegisterResult

Description of Properties

RegisterParameter

Description of Properties

UserStatusParameter

Description of Properties

ExceptionListItem

Description of Properties

UserSyncStatusParameter

Description of Properties

UserStatusListItem

Description of Properties

DeviceReportEventParamer

Description of Properties

DoorMagnetismReportEventContent

Description of Properties

BluetoothReportEventContent

Description of Properties

ThermalImagerReportEventContent

Description of Properties

RecordResult

Description of Properties

RecordParameter

Description of Properties

DeviceVersionInfoParameter

Description of Properties

IdentifyDataParameter

Description of Properties

Depth

Description of Properties

TslUploadParameter

Description of Properties

TslLanguageUploadParameter

Description of Properties

MessageParameter

Description of Properties

MessageEventEnum

Description of Properties

IConnectionLost

Description of Method

MessageCallback

Description of Method

MqttApiClient

MQTTインターフェースの実装

MqttApiClient

メンバー関数

説明

導入バージョン

void connectMqtt(IMqttActionListener listener, IConnectionLost connectionLost, boolean useTokenConnect, SocketFactory socketFactory)

MQTT接続

2.0.0

メンバー関数の説明

void connectMqtt(IMqttActionListener listener, IConnectionLost connectionLost, boolean useTokenConnect, SocketFactory socketFactory)

MQTT接続

パラメータ

戻り値

なし

例外

なし

void disConnectMqtt(IMqttActionListener listener)

MQTT接続を切断

パラメータ

戻り値

なし

例外

なし

void getUserListInGroup(int groupId, MessageCallback callback)

あるグループでの登録者リストを取得

パラメータ

戻り値

なし

例外

なし

void registerGroupChangeListener(MessageCallback callback)

デバイスと登録者グループの変更コールバックを登録

パラメータ

戻り値

なし

例外

なし

void registerUserInGroupChangeListener(int groupId, MessageCallback callback)

登録者グループの登録者変更コールバックを登録

パラメータ

戻り値

なし

例外

なし

void registerWarningAction(MessageCallback callback)

アラートステータス変更コールバックを登録

パラメータ

戻り値

なし

例外

なし

void registerAccessStrategy(MessageCallback callback)

アクセスルール変更コールバックを登録

パラメータ

戻り値

なし

例外

なし

void registerUpgrade(MessageCallback callback)

APPとROMアップデートコールバックを登録

パラメータ

戻り値

なし

例外

なし

void registerDeviceStatus(MessageCallback callback)

デバイスステータスコールバックを登録

パラメータ

戻り値

なし

例外

なし

void registerDeviceConfig(MessageCallback callback)

デバイス構成変更コールバックを登録

パラメータ

戻り値

なし

例外

なし

void registerDeviceNotify(MessageCallback callback)

デバイスサーバエンドの通知配信構コールバックを登録

パラメータ

戻り値

なし

例外

なし

void registerKeepDoorOpenOrCloseSchedule(MessageCallback callback)

デバイスのドア常時開／閉タイムテーブルの配信コールバックを登録

パラメータ

戻り値

なし

例外

なし

void unRegisterGroupChangeListener()

デバイスと登録者グループの変更コールバックの登録を取り消す

パラメータ

なし

戻り値

なし

例外

なし

void unegisterUserInGroupChangeListener(int groupId)

登録者グループの登録者変更コールバックの登録を取り消す

パラメータ

戻り値

なし

例外

なし

void unegisterGetUserListInGroup(int groupId)

あるグループでの登録者リストの登録を取り消す

パラメータ

戻り値

なし

例外

なし

void unRegisterWarningAction()

アラートステータス変更コールバックの登録を取り消す

パラメータ

なし

戻り値

なし

例外

なし

void unRegisterAccessStrategy()

アクセスルール変更コールバックの登録を取り消す

パラメータ

なし

戻り値

なし

例外

なし

void unRegisterUpgrade()

APPとROMアップデートコールバックの登録を取り消す

パラメータ

なし

戻り値

なし

例外

なし

void unRegisterDeviceStatus()

デバイスステータスコールバックの登録を取り消す

パラメータ

なし

戻り値

なし

例外

なし

void unRegisterDeviceConfig()

デバイス構成変更コールバックの登録を取り消す

パラメータ

なし

戻り値

なし

例外

なし

void unRegisterDeviceNotify()

デバイスサーバエンドの通知配信構コールバック登録を取り消す

パラメータ

なし

戻り値

なし

例外

なし

void unRegisterKeepDoorOpenOrCloseSchedule()

デバイスのドア常時開/閉タイムテーブルの配信コールバック登録を取り消す

パラメータ

なし

戻り値

なし

例外

なし

エンティティの説明

LanguageTypeEnum

プロパティの説明

ConnectConfigEntity

プロパティの説明

Result

プロパティの説明

メソッドの説明

AlarmReportParameter

プロパティの説明

VerticesItem

プロパティの説明

GuestDetailInfo

プロパティの説明

GroupsItem

プロパティの説明

TslCheckExistResult

プロパティの説明

TslLanguageCheckExistResult

プロパティの説明

FaceSearchResult

プロパティの説明

SearchResultItem

プロパティの説明

Content

プロパティの説明

FaceSearchParameter

プロパティの説明

ImagesItem

プロパティの説明

TargetInfo

プロパティの説明

Angle

プロパティの説明

Rectangle

プロパティの説明

VerticesItem

プロパティの説明

LandmarksItem

プロパティの説明

CameraInfo

プロパティの説明

GroupIndex

プロパティの説明

UserIndex

プロパティの説明

UserInfoResult

プロパティの説明

UserInfoParameter

プロパティの説明

DeviceGroups

プロパティの説明

DeviceDetailInfo

プロパティの説明

DeviceTypeMaxOnline

プロパティの説明

ServiceConfigItem

プロパティの説明

Options

プロパティの説明

Company

プロパティの説明

RsaResult

プロパティの説明

UserDetailInfo

プロパティの説明

DeptItem

プロパティの説明

ServerVersion

プロパティの説明

TimeTable

プロパティの説明

SpecialDay

プロパティの説明

QRResult

プロパティの説明

IdentifyQRCodeParameter

プロパティの説明

LoginResult

プロパティの説明

UserRspVO

プロパティの説明

DepartmentRouteItem

プロパティの説明

Device

プロパティの説明

MisrecognitionRecordParameter

プロパティの説明

RegisterResult

プロパティの説明

RegisterParameter

プロパティの説明

UserStatusParameter

プロパティの説明

ExceptionListItem

プロパティの説明

UserSyncStatusParameter

プロパティの説明

UserStatusListItem

プロパティの説明

DeviceReportEventParamer

プロパティの説明

DoorMagnetismReportEventContent

プロパティの説明

BluetoothReportEventContent

プロパティの説明

ThermalImagerReportEventContent

プロパティの説明

RecordResult

プロパティの説明

RecordParameter

プロパティの説明

DeviceVersionInfoParameter

プロパティの説明

IdentifyDataParameter

プロパティの説明

Depth

プロパティの説明

TslUploadParameter

プロパティの説明

TslLanguageUploadParameter

プロパティの説明

MessageParameter

プロパティの説明

MessageEventEnum

プロパティの説明

IConnectionLost

メソッドの説明

MessageCallback

メソッドの説明

2.0.0

Introduction

[日本語]開発者向けドキュメント

リリースノート

Thunder SDKパッケージ

API仕様書

フィーチャーマネジメント

クラスの説明

FeatureManagerProxy

メンバー関数の説明

int delete(int userId)

byte[] getFeature(Bitmap avatar)

int insert(int userId, byte[] feature)

QRコード

機能類の説明

QRCodeDecoderProxy

LinkSDK

サンプルソフトウェア

ソフトウェアの主な機能の紹介

[ENGLISH]dev-documents

Release Note

Thunder SDK Package Introduction

API reference

SDK Authorization

Description of functional types

WuKong

Description of Member Function

void init (Context context)

void auth (String licFileName, boolean isLeafLic, String productName, PassModel modelConfig, IAuthCallback authCallback)

void release ()

Feature Management

Description of Class

FeatureManagerProxy

QR code

Description of functional types

QRCodeDecoderProxy

Description of Member Function

String decodeQRCode(byte[] nv21, int w, int h)

String decodeQRCode(Bitmap bitmap)

LinkSDK

Sample Software Introduction

Introduction to the main functions of the software

Face Recognition

1:1 Face Verification

1:N Face Identification

Server-side Identification

QR Code Identification

Temperature Measurement + Identification

Operate hardware devices

Login SenseLink

Upload record and TSL model

[日本語]開発者向けドキュメント

Introduction

API仕様書

Release Note

リリースノート

フィーチャーマネジメント

クラスの説明

FeatureManagerProxy

メンバー関数の説明

int delete(int userId)

byte[] getFeature(Bitmap avatar)

int insert(int userId, byte[] feature)

API reference

LinkSDK

LinkSDK

[ENGLISH]dev-documents

Thunder SDK Package Introduction

Sample Software Introduction

Introduction to the main functions of the software

Face Recognition

1:1 Face Verification

1:N Face Identification

Server-side Identification

QR Code Identification

Temperature Measurement + Identification

Operate hardware devices

Login SenseLink

Upload record and TSL model

Feature Management