MinewSensorKit SDK

# MTSensorKit Documentation
This set of SDK only supports the Bluetooth Sensor device produced by Minew, 現在は温度と湿度のセンサーとドアのセンサーです. SDK は、開発者が携帯電話とセンサー間のすべての作業を処理するのに役立ちます。, 含む: スキャン装置, デバイスを接続する, デバイスへのデータの書き込み, デバイスからデータを受信する, 等.

## Preliminary work

Overall framework: MTCentralManager はデバイス管理クラスです, APP の実行中は常にシングルトンです。. MTPeripheral はデバイス インスタンス クラスです. このスイートは、デバイスごとに MTPeripheral インスタンスを生成し、デバイスの監視と操作を容易にします。.
MTセントラルマネージャー : デバイス管理クラス, 周囲のセンサーデバイスをスキャンできます, そしてそれらを接続することができます, それらを確認してください, 等.

**MTPペリフェラル** : デバイスインスタンスクラス. MTCentralManager が物理デバイスを検出したとき, MTCentralManager は MTPeripheral インスタンスを生成します, 物理デバイスに相当します.

**MTブロードキャストハンドラー** : デバイスブロードキャストクラス, デバイスがブロードキャストするときにデータを取得できる.

**MTConnectionHandler** : デバイスからデータを送受信するためのデバイス接続クラス.

**MTUまで** : データ書き込み命令.

## 始めましょう
### 開発環境:
-Xcode10 +, 現在の SDK は Xcode11 でコンパイルされています, 開発にはXcode10以降を使用してください; -iOS11, 最小システムバージョンはiOS11です;
### プロジェクトにインポートする:

1. CocoaPods
MTSensorKit is available through CocoaPods. インストールするには, 次の行を Podfile に追加するだけです, そしてインポートします <MTSensorKit>:

```c
pod 'MTSensorKit'
```

2. Manually
Copy the development kit files: MTSensorKit.framework ファイルをプロジェクトのプロジェクト ディレクトリにコピーする, そしてそれらをプロジェクトに追加します.

PS:
!!! iOS10以降の場合, Apple が Bluetooth API に許可制限を追加しました. プロジェクトの info.plist ファイルに文字列を追加する必要があります: プライバシー -Bluetooth周辺機器の使用説明-"使用方法の説明".
!!! iOS13以降の場合, Apple が Bluetooth API に許可制限を追加しました. プロジェクトの info.plist ファイルに文字列を追加する必要があります: プライバシー-Bluetooth Always 使用説明-"使用方法の説明".
### 開発を開始する
#### Scanning equipment
First you need to get the singleton of MTCentralManager, 次に、電話の現在の Bluetooth ステータスを確認します。, その後、デバイスをスキャンできます.

「」c
// Get Manager singleton
MTCentralManager * マネージャー = [MTCentralManager 共有インスタンス];

発送後 (発送時期 (DISPATCH_TIME_NOW, (int64_t) (1 * NSEC_PER_SEC)), ディスパッチ_get_main_queue (), ^ {
    // The current state of the Bluetooth switch on the mobile phone
    if (self-> manager.status == PowerStatePoweredOn) {
        // デバイススキャンを開始する
        [マネージャースタートスキャン: ^ (NSArray <MTPeripheral *> * デバイス) {
        //ブロードキャスト属性の種類に応じて, 必要なセンサータイプをフィルタリングできます.
        self-> deviceAry = devices;
    }];
    }
});
// スキャンされたデバイスは、manager.scannedPeris を使用して取得することもできます。
// 携帯電話の Bluetooth ステータスに応答する必要がある場合. コールバックを聞いてください.
[マネージャーが変更したBluetoothステータス: ^ (電源状態のステータス) {
  スイッチ (状態) {
    ケース PowerStatePoweredOn:
        NSLog (@ "Bluetooth ステータスがパワーオンに変わります");
        壊す;
    ケース PowerStatePoweredOff:
        NSLog (@ "Bluetooth ステータスが電源オフに変わります");
        壊す;
    ケース PowerStateUnknown:
        NSLog (@ "Bluetooth ステータスが不明に変更される");
	}
}];
```

**PS: SDK 全体は、電話機の Bluetooth 状態がパワーオンの場合にのみ機能します。**
#### Connect to device
```c
// The scanned device can be obtained from the previous step
MTPeripheral * デバイス = デバイスAry [0];
// デバイスを接続する
[マネージャーがペリフェラルに接続: デバイス];
// デバイスの接続ステータスをリッスンする.
[p.connector の DidChangeConnection: ^ (接続接続) {
    もし (接続 == 検証済み) {
      // 検証成功, successfully connected to the device
        NSLog (@ "有効化された");
      //パスワードを書く必要がある, パスワードが正常に検証された後に他の操作を実行する
    }
    もし (接続 == 切断されました) {
        NSLog (@ "デバイスが切断されました。");
    }
}];
「」
#### Write data to the device
Take the next step, 携帯電話がデバイスとの接続を正常に確立し、認証が成功したとき, デバイスは読み取りと書き込みができます.
1. Write data

```c
//Obtain the corresponding command data through MTUtils, 例えば:
NSData *データ = [MTUtils 検証パスワード:@"123456"];
[self-> _ per.connector writeData: データ完成: ^ (BOOL の成功, NSエラー * _null 以外のエラー) {
   もし (エラー) {
       NSLog (@ "データの書き込みに失敗しました:% @", エラー);
   }
   それ以外 {
       NSLog (@ "データ書き込み成功");
   }
}];
「」

2. Receive data

```c
[_per.connector の DidReceiveData: ^ (NSデータ * _null 以外の日付) {
   もし (データ) {
       NSLog (@ "データの受信に成功しました:% @", データ);
    }
    それ以外 {
       NSLog (@ "データの受信に失敗しました");
    }
   }
}];
「」
## スケジュール

### MTCentralManager プロパティの説明

| 名前 | タイプ | 説明 |
| -------- | -------- | -------- |
| 状態     | 電源状態     | 携帯電話のBluetoothステータス     |
| スキャンされたペリス     | NSArray     | スキャンされたデバイス    |

### MTPeripheral プロパティの説明
| 名前	 | タイプ  |	説明 |
| -------- | -------- | -------- |
| 識別子	| NS文字列	| デバイス識別子 |
| 放送	| MTブロードキャストハンドラー	| MTBroadcastHandler のオブジェクト |
| コネクタ |	MTConnectionハンドラー	| MTConnectionHandler のオブジェクト |

### MTBroadcastHanler プロパティの説明
| 名前	 | タイプ  |	説明 |
| -------- | -------- | -------- |
| 名前	| NS文字列	| 装置名 | 
| RSSI	| NS整数	| デバイスの RSSI | 
| バッテリー	| NS文字列	| デバイスのバッテリー | 
| マック	| NS文字列	| デバイス Mac | 
| 識別子	| NS文字列	| デバイス識別子 | 
| 温度	| ダブル	| デバイスの温度 | 
| 地上で	| ダブル	| デバイスの湿度 | 
| リセット情報	| uint8_t	| デバイス温度単位フラグ | 
| タイプ	| センサーの種類	| デバイスタイプ | 
| byステータス	| NS文字列	| デバイスのドアのステータス| 
| 警告ステータス	| uint8_t	| デバイスのアラームステータス |

| 名前	 | タイプ  |	説明 |
| -------- | -------- | -------- |
| 名前	| NS文字列	| 装置名 | 
| RSSI	| NS整数	| デバイスの RSSI | 
| マック	| NS文字列	| デバイス Mac | 
| 識別子	| NS文字列	| デバイス識別子 | 
| 会社バージョン	| NS文字列	| ファームバージョン | 
| ハードウェアバージョン	| NS文字列	| ハードウェアバージョン | 
| 画面情報	| NS文字列	| 画面情報 | 
| バッテリー	| NS文字列	| バッテリー | 
| チップ温度	| ダブル	| チップ温度 | 
| 心拍数	| NS文字列	| 心拍数 | 
| タグRss	| NS文字列	| タグRss | 
| チップ情報	| NS文字列	| チップ情報 | 
| 画像IDデータ	| NSデータ	| 画像IDデータ | 
| エラーコード	| NS整数	| エラーコード | 
| 周辺機器サポート	| NS文字列	| 周辺機器サポート | 
	
### MTConnectionHandler プロパティの説明
| 名前	 | タイプ  |	説明 |
| -------- | -------- | -------- |
| マックストリング	| NS文字列	| デバイス Mac | 
| 繋がり	| 繋がり	| デバイスの接続ステータス |