用於處理藍牙低功耗 (BLE) 連線的通訊類別。更多...

#include <BleComm.h>

類別BleComm的繼承圖:

實體方法
(NSArray< NSString * > *)	- availableDevices
	取得可用的 BLE 設備清單。

(void)	- open:
	連線指定名稱的 BLE 設備。

(bool)	- isConnected
	檢查 BLE 連線是否目前有效。

(void)	- close
	中斷目前的 BLE 連線。

(void)	- write:
	將資料寫入已連線的 BLE 裝置。

(NSData *)	- read
	讀取從 BLE 裝置接收的資料。

(void)	- waitForDataWithTimeout:
	在逾時時間內等待來自 BLE 裝置的資料。

(NSData *)	- writeAndWaitForResponse:responseStartTimeOut:responseEndTimeOut:completionToken:
	傳送資料到 BLE 裝置並等待回應。

(NSData *)	- writeAndWaitForResponseJson:responseStartTimeOut:responseEndTimeOut:completionToken:
	傳送 JSON 資料到 BLE 裝置並等待回應。

實體方法繼承自 AComm
(void)	- open
	打開通信接口。

(void)	- readToBinaryWriter:
	將數據讀入二進制寫入器（輸出流）。

(void)	- writeFromBinaryReader:
	將數據從二進制讀取器（輸入流）寫入通信接口。

(void)	- writeAndWaitForResponseToBinaryWriter:fromBinaryReader:responseStartTimeout:responseEndTimeout:completionToken:
	將數據寫入通信接口並等待響應，使用二進制流。

屬性(properties)
CBCentralManager *	centralManager

NSMutableArray< NSString * > *	discoveredDevices

NSMutableArray< CBPeripheral * > *	foundPeripherals

CBPeripheral *	connectedPeripheral

NSMutableArray< CBCharacteristic * > *	writeCharacteristics

NSMutableArray< CBCharacteristic * > *	readCharacteristics

NSMutableData *	receivedData

void(^	_Nullable )(void)
	所有 BLE 特徵值準備完成後會觸發的 callback。在呼叫 `open:` 之前設定，可確保後續可以安全地進行資料操作。

屬性(properties) 繼承自 AComm
int	maxPacketSize
	通信的最大數據包大小。

NSString *	descriptor
	通信接口的描述符。

int	bytesAvailable
	可讀取的字節數。

BOOL	isConnected
	指示連接是否建立的標誌。

屬性(properties) 繼承自 <IComm>
NSString *	descriptor
	通信接口的描述符。

int	bytesAvailable
	可讀取的字節數。

詳細描述

用於處理藍牙低功耗 (BLE) 連線的通訊類別。

此類別繼承自 AComm，並實作 CBCentralManagerDelegate 和 CBPeripheralDelegate 協定。它提供探索、連線、傳送與接收 BLE 周邊設備資料的方法。

方法文件

◆ availableDevices

- (NSArray< NSString * > *) availableDevices

取得可用的 BLE 設備清單。

傳回值: 包含設備名稱的 NSString 陣列。

◆ close

- (void) close

中斷目前的 BLE 連線。

依據AComm重新實作.

◆ isConnected

- (bool) isConnected

檢查 BLE 連線是否目前有效。

傳回值: 若已連線則回傳 true，否則回傳 false。

依據<IComm>重新實作.

◆ open:

- (void) open: (NSString *) deviceName

連線指定名稱的 BLE 設備。

參數

deviceName 要連線的設備名稱。

◆ read

- (NSData *) read

讀取從 BLE 裝置接收的資料。

傳回值: 包含接收資料的 NSData 物件。

依據AComm重新實作.

◆ waitForDataWithTimeout:

- (void) waitForDataWithTimeout: (NSTimeInterval) msTimeOut

在逾時時間內等待來自 BLE 裝置的資料。

參數

msTimeOut 等待的最長時間（毫秒）。

依據AComm重新實作.

◆ write:

- (void) write: (NSData *) text

將資料寫入已連線的 BLE 裝置。

參數

text 要寫入的資料。

依據AComm重新實作.

◆ writeAndWaitForResponse:responseStartTimeOut:responseEndTimeOut:completionToken:

- (NSData *) writeAndWaitForResponse:	(NSData *)	text
responseStartTimeOut:	(NSTimeInterval)	responseStartTimeOut
responseEndTimeOut:	(NSTimeInterval)	responseEndTimeOut
completionToken:	(NSString *)	completionToken

傳送資料到 BLE 裝置並等待回應。

參數

text	要傳送的資料。
responseStartTimeOut	等待回應開始的最長時間（毫秒）。
responseEndTimeOut	等待回應結束的最長時間（毫秒）。
completionToken	表示回應完成的字串標記。

傳回值: 包含回應資料的 NSData 物件。

依據AComm重新實作.

◆ writeAndWaitForResponseJson:responseStartTimeOut:responseEndTimeOut:completionToken:

- (NSData *) writeAndWaitForResponseJson:	(NSData *)	text
responseStartTimeOut:	(NSTimeInterval)	responseStartTimeOut
responseEndTimeOut:	(NSTimeInterval)	responseEndTimeOut
completionToken:	(NSString *)	completionToken

傳送 JSON 資料到 BLE 裝置並等待回應。

參數

text	要傳送的 JSON 資料。
responseStartTimeOut	等待回應開始的最長時間（毫秒）。
responseEndTimeOut	等待回應結束的最長時間（毫秒）。
completionToken	表示回應完成的字串標記。

傳回值: 包含回應資料的 NSData 物件。

屬性(property)說明文件

◆ _Nullable

- (void(^ _Nullable) (void))

readwritenonatomiccopy

所有 BLE 特徵值準備完成後會觸發的 callback。在呼叫 open: 之前設定，可確保後續可以安全地進行資料操作。

◆ centralManager

- (CBCentralManager*) centralManager

readwritenonatomicstrong

負責 BLE 操作的中心管理器。

◆ connectedPeripheral

- (CBPeripheral*) connectedPeripheral

readwritenonatomicstrong

當前連線的周邊設備。

◆ discoveredDevices

- (NSMutableArray<NSString *>*) discoveredDevices

readwritenonatomicstrong

已探索到的設備名稱清單。

◆ foundPeripherals

- (NSMutableArray<CBPeripheral *>*) foundPeripherals

readwritenonatomicstrong

已探索到的周邊設備清單。

◆ readCharacteristics

- (NSMutableArray<CBCharacteristic *>*) readCharacteristics

readwritenonatomicstrong

可用於讀取的 BLE 特徵值。

◆ receivedData

- (NSMutableData*) receivedData

readwritenonatomicstrong

從 BLE 設備接收的累積資料。

◆ writeCharacteristics

- (NSMutableArray<CBCharacteristic *>*) writeCharacteristics

readwritenonatomicstrong

可用於寫入的 BLE 特徵值。

此類別(class) 文件是由下列檔案中產生:

/Users/bob_huang/Documents/Project/sdk_json_Objective-C_IOS/sdk_json_Objective-C_IOS/Comm/BleComm.h

實體方法

屬性(properties)

詳細描述

方法文件

◆ availableDevices

◆ close

◆ isConnected

◆ open:

◆ read

◆ waitForDataWithTimeout:

◆ write:

◆ writeAndWaitForResponse:responseStartTimeOut:responseEndTimeOut:completionToken:

◆ writeAndWaitForResponseJson:responseStartTimeOut:responseEndTimeOut:completionToken:

屬性(property)說明文件

◆ _Nullable

◆ centralManager

◆ connectedPeripheral

◆ discoveredDevices

◆ foundPeripherals

◆ readCharacteristics

◆ receivedData

◆ writeCharacteristics