用於處理藍牙低功耗 (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:
	将数据写入通信接口并等待响应，使用二进制流。

属性
CBCentralManager *	centralManager

NSMutableArray< NSString * > *	discoveredDevices

NSMutableArray< CBPeripheral * > *	foundPeripherals

CBPeripheral *	connectedPeripheral

NSMutableArray< CBCharacteristic * > *	writeCharacteristics

NSMutableArray< CBCharacteristic * > *	readCharacteristics

NSMutableData *	receivedData

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

属性继承自 AComm
int	maxPacketSize
	通信的最大数据包大小。

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

int	bytesAvailable
	可读取的字节数。

BOOL	isConnected
	指示连接是否建立的标志。

属性继承自 <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 物件。

属性说明

◆ _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 特徵值。

该类的文档由以下文件生成:

/Users/bob_huang/Documents/Project/sdk_json_Objective-C/AutoIdSDK/Comm/BleComm.h

实例方法

属性

详细描述

成员函数文档

◆ availableDevices

◆ close

◆ isConnected

◆ open:

◆ read

◆ waitForDataWithTimeout:

◆ write:

◆ writeAndWaitForResponse:responseStartTimeOut:responseEndTimeOut:completionToken:

◆ writeAndWaitForResponseJson:responseStartTimeOut:responseEndTimeOut:completionToken:

属性说明

◆ _Nullable

◆ centralManager

◆ connectedPeripheral

◆ discoveredDevices

◆ foundPeripherals

◆ readCharacteristics

◆ receivedData

◆ writeCharacteristics