| 中文版 | 日本語版 | English Version |

• SesameSDKは、iOS & Androidアプリケーション向けのシンプルで強力な無料のBluetooth/IoT（Internet of Things）ライブラリです。Sesame公式アプリケーションもこのSesameSDKを使用して構築されており、芝麻アプリケーションのすべての機能はこのSesameSDKで実現できます。SesameSDKでは以下が可能です：

• Sesameデバイスの登録（Sesame 5、Sesame 5 Pro、Sesame Bike2、Sesame BLE Connector1、Sesame open sensor、Sesame Touch 1 Pro、Sesame Touch 1、WIFI Module2）

• ロックとアンロック

• 履歴の取得

• SesameOS3のアップデート

• SesameOS3デバイスの各種設定

• バッテリー残量の取得

• プロジェクトSesameOs3は主にSesame 5、Sesame 5 Pro、Sesame Bike2、Sesame BLE Connector1、Sesame open sensor、Sesame Touch 1 Pro、Sesame Touch 1、WIFI Module2などのハードウェアデバイスをBluetooth経由で接続します。ユーザーがiOSアプリケーションソフトウェアを通じてハードウェアをスマートに操作できるようサポートします。

block-beta
	columns 5
	space space bike["Bike"]space  finger(["Finger, Card,\nPw, +Face"])
	space:5
	wifi["Wifi Module2"] space sesame["Sesame 4/5"] space touch["Touch/Touch Pro"]
	space:5
	bot["Bot"] space mobile["Mobile Phone"] space open["Open Sensor"]
	
	bike-->sesame
	finger-->touch
	wifi-->sesame
	sesame-->touch touch-->sesame
	bot-->mobile mobile-->bot
	mobile-->open open-->mobile
	
	wifi-->bot bot-->wifi
	wifi-->mobile mobile-->wifi
	sesame-->mobile mobile-->sesame
	
	sesame-->open open-->sesame
	touch-->mobile mobile-->touch
	
	
	style sesame fill:#90EE90

flowchart TB
    A(((New Arrival)))
    B[Sesame USA]
    C[A1 + C1 mini]
    D[Wifi Module 2]
    E[Bot2]
    style A fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff,stroke-dasharray: 5 5
    classDef back fill:#969,stroke:#333,stroke-dasharray: 5 5
    class B,C,D,E back

• [Sesame 5]：このインスタンスオブジェクトはSesame5、Sesame5 Pro製品に適用されます
• [Sesame Bike 2]：このインスタンスオブジェクトはSesame Bike 2製品に適用されます
• [Sesame WiFi Module 2]：このインスタンスオブジェクトはSesame WiFi Module 2製品に適用されます
• [Sesame Touch Pro]：このインスタンスオブジェクトはSesame BLE Connector1、Sesame Touch 1 Pro、Sesame Touch 1製品に適用されます
• [Sesame Open Sensor 1]：このインスタンスオブジェクトはSesame Open Sensor 1製品に適用されます
• [クラスオブジェクト]

• iOS 12以上のAppleデバイスをサポート

1. SchemeをSesameSDKに切り替え、Any iOS Deviceを選択
2. command + shift + kでproductフォルダをクリア
3. command + bでSDKをビルド
4. 完了後、Xcode -> SDKプロジェクト -> Productsフォルダ内のSesameSDK.frameworkを右クリックしてFinderで開き、SesameSDK.frameworkを取得

• SesameWatchKitSDK

1. SchemeをSesameWatchKitSDKに切り替え、Any watch OS Deviceを選択
2. command + shift + kでproductフォルダをクリア
3. command + bでSDKをビルド
4. 完了後、Xcode -> SDKプロジェクト -> Productsフォルダ内のSesameWatchKitSDK.frameworkを右クリックしてFinderで開き、SesameWatchKitSDK.frameworkを取得

• iOS版
• Android版
• ESP32版

Sesame BLE通信

Sesame APIインターフェースドキュメントへ

CHBluetoothCenterクラスの説明 このアプリのCore Dataローカルストレージ管理センターで、sharedでシングルトンを作成し、パフォーマンス向上のためにデータをキャッシュします。CHDeviceKeyをCore Dataに保存する前にCHDeviceMO(MO = manage object)に変換する必要があります。CHDeviceMOはローカルデータベース内のSesameデバイスを表します。

• backgroundContext Core DataのNSManagedObjectContextで、バックグラウンドスレッドでのデータ操作を可能にします
• persistentContainer
• cacheDevices CHDeviceMOを保存するための配列

• iOSのバックグラウンドでデバイスを取得

//---初始化---
func initDevices()
// 從 Core Data 中提取所有的 CHDeviceMO 並將它們儲存到 cacheDevices

private init()
//設置 Core Data 的存儲、獲取數據模型、轉換名稱、設置存儲的位置等。
//---

func appendDevice(_ CHDeviceKey: CHDeviceKey)
//把`CHDeviceKey`轉成`CHDeviceMO`，並添加到 Core Data 和快取中。

func getDevice(deviceID: UUID?) -> CHDeviceMO?
//根據設備 UUID 在緩存中搜尋特定 CHDeviceMO 對象

func deleteDevice(_ device: CHDeviceMO)
// 刪除指定`DeviceMO`

func saveifNeed()
//如果有任何未保存的變更，則保存到 Core Data

func lastCachedevices() -> [CHDeviceMO]
//從 Core Data 中抓到所有`DeviceMO`

func logout()
//刪除所有` CHDeviceMO` 對象並清空緩存

すべてのSesameデバイスが実装する必要があるプロパティとメソッド

• delegate: CHDeviceStatusDelegateのデリゲートで、デバイスの状態変化を監視します
• rssi: Bluetooth信号強度インジケータ（RSSI）= Sesameとスマートフォンの距離
• deviceId: Sesameの固有識別子（UUID）
• isRegistered: そのSesameが登録済みかどうか
• txPowerLevel: SesameのBluetoothパワーレベル
• productModel: Sesame製品モデル
• deviceStatus: CHDeviceStatusの値で、デバイスの現在の状態を示します
• deviceShadowStatus: AWS IoTシャドウ状態（オプション）
• mechStatus: Sesameの機械状態（オプション）

- getKey() -> CHDeviceKey? //如果裝置已註冊，則會返回鑰匙；否則，會返回 nil

- connect(result: @escaping (CHResult<CHEmpty>))// 建立藍芽連線到裝置

- dropKey(result: @escaping (CHResult<CHEmpty>)): // 刪除鑰匙

- disconnect(result: @escaping (CHResult<CHEmpty>))// 斷開與Sesame藍芽連線

- getVersionTag(result: @escaping (CHResult<String>)) // 取得固件版本號

- updateFirmware(result: @escaping CHResult<CBPeripheral?>) // 更新Sesame固件

- getTimeSignature() -> String //???

- reset(result: @escaping CHResult<CHEmpty>) //(循序圖)
- register(result: @escaping CHResult<CHEmpty>) //(循序圖)

- createGuestKey(result: @escaping CHResult<String>) // (循序圖)

- getGuestKeys(result: @escaping CHResult<[CHGuestKey]>) // (循序圖)

- removeGuestKey(_ guestKeyId: String, result: @escaping CHResult<CHEmpty>) // 移除(revoke?)訪客鑰匙

- updateGuestKey(_ guestKeyId: String, name: String, result: @escaping CHResult<CHEmpty>)

getFirZip() -> URL: 取得Sesame的固件壓縮檔的 URL
errorFromResultCode(_ resultCode: SesameResultCode) -> Error: 將 SesameResultCode 轉換為 Error。

Sesame3/4/5/5 Pro, Bot1, Bike1/2

public protocol CHSesameLock: CHDevice {
    var mechStatus: CHSesameProtocolMechStatus? { get set }
    func getHistoryTag() -> Data?
    func setHistoryTag(\_ tag: Data, result: @escaping (CHResult<CHEmpty>))
}

Wifi2, Sesame Touch/Touch Pro, Open Sensor, Ble Connector

public protocol CHSesameConnector {
    var sesame2Keys: [String: String] { get }
    func insertSesame(_ device: CHDevice, result: @escaping CHResult<CHEmpty>)
    func removeSesame(tag: String, result: @escaping CHResult<CHEmpty>)
}

https://github.com/CANDY-HOUSE/SesameSDK_iOS_with_DemoApp/tree/master/doc/重點數據結構

• Bluetooth: CoreBluetooth

https://developer.apple.com/documentation/corebluetooth

• ローカルストレージ: CoreData

https://developer.apple.com/documentation/coredata

• サーバーサイド: AWS SDK for iOS Swift Package Manager

• 使用ライブラリ: AWSMobileClientXCF https://aws-amplify.github.io/aws-sdk-ios/docs/reference/AWSMobileClient/index.html

• Siri & ショートカット: Intents

公式ドキュメント https://developer.apple.com/documentation/appintents 参考記事 https://medium.com/simform-engineering/how-to-integrate-siri-shortcuts-and-design-custom-intents-tutorial-e53285b550cf

• モバイル通知

https://developer.apple.com/documentation/usernotifications