组件目录
活动启动器 经典蓝牙服务器 经典蓝牙客户端 低功耗蓝牙 HTTP客户端 MQTT客户端 UART串口通信 ESP智能配网

活动启动器 ActivityStarter

可以使用StartActivity方法启动活动的组件。

属性

  • 动作 Action 文本 指定将用于启动活动的动作。
  • 活动类名 ActivityClass 文本 指定将要启动的特定组件的类部分。
  • 活动包名 ActivityPackage 文本 指定将启动的特定组件的包部分。
  • 数据类型 DataType 文本 指定要传递给活动的 MIME 类型。
  • 数据URI DataUri 文本 指定将用于启动活动的数据URI。
  • 扩展键 ExtraKey 文本 指定将传递给活动的额外键。已过时。应改用Extras
  • 扩展值 ExtraValue 文本 指定将传递给活动的额外值。已过时。应改用Extras
  • 其他属性列表 Extras 列表 只代码 返回将作为额外数据传递给活动的键值对列表。
  • 结果 Result 文本 只代码, 只读 返回活动结果。
  • 结果名称 ResultName 文本 指定用于从活动中检索结果的名称。
  • 结果类型 ResultType 文本 只代码, 只读 从活动中返回 MIME 类型。
  • 结果URI地址 ResultUri 文本 只代码, 只读 返回活动的URI。

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 活动调用结束 AfterActivity 结果 result: 文本 此 ActivityStarter 返回后引发的事件。
  • 取消启动 ActivityCanceled 如果此`ActivityStarter`因活动被取消而返回，则会引发此事件。

方法

  • 处理活动信息 ResolveActivity 文本 返回与此ActivityStarter对应的活动的名称；如果找不到对应的活动，则返回空字符串。
  • 启动活动对象 StartActivity 启动与此ActivityStarter相对应的活动。

经典蓝牙服务器 BluetoothServer

使用BluetoothServer组件将您的设备转换为服务器，接收来自使用Bluetooth Client组件的其他应用程序的连接。

属性

  • 地址 Address 文本 只代码, 只读 暂无描述
  • 是否可用 Available 布尔 只代码, 只读 如果设备上的蓝牙可用，则返回true，否则返回false。
  • 字符编码 CharacterEncoding 文本 返回发送和接收文本时使用的字符编码。
  • 分隔符字节码 DelimiterByte 数字 返回在调用 ReceiveText、ReceiveSignedBytes 或 ReceiveUnsignedBytes 时，当 numberOfBytes 参数为负数时所使用的分隔符字节。
  • 名称 DeviceName 文本 只代码, 只读 暂无描述
  • 是否启用 Enabled 布尔 只代码, 只读 如果蓝牙已启用，则返回true，否则返回false。
  • 是否高位优先 HighByteFirst 布尔 指定发送和接收数字时，是否以最高有效字节在前。
  • 是否正在等待 IsAccepting 布尔 只代码, 只读 如果此BluetoothServer组件正在接受传入连接，则返回true。
  • 是否已连接 IsConnected 布尔 只代码, 只读 如果已建立与蓝牙设备的连接，则返回true。
  • 是否启用安全连接 Secure 布尔 指定是否应使用安全连接。

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 已断开连接 Disconnected 设备地址 deviceAddress: 文本, 设备名称 deviceName: 文本 暂无描述

方法

  • 开启 Enable 暂无描述
  • 关闭 Disable 暂无描述
  • 请求权限 RequestPermissions 回调 callback: 过程 暂无描述
  • 发送文本 SendText 文本 text: 文本 向已连接的蓝牙设备发送文本。
  • 发送单字节数字 Send1ByteNumber 数字 number: 文本 向已连接的蓝牙设备发送一个1字节的数字。
  • 发送双字节数字 Send2ByteNumber 数字 number: 文本 向已连接的蓝牙设备发送一个2字节的数字。
  • 发送四字节数字 Send4ByteNumber 数字 number: 文本 向已连接的蓝牙设备发送一个4字节的数字。
  • 发送字节列表 SendBytes 列表 list: 列表 向已连接的蓝牙设备发送一个字节值列表。
  • 可接收字节数 BytesAvailableToReceive 数字 返回输入流中可用的字节数。
  • 接收文本 ReceiveText 文本 字节数 numberOfBytes: 数字 从已连接的蓝牙设备接收文本。如果 numberOfBytes 小于 0，则持续读取，直至接收到一个定界符字节值。
  • 接收单字节带符号数字 ReceiveSigned1ByteNumber 数字 从已连接的蓝牙设备接收一个已签名的1字节数字。
  • 接收单字节无符号数字 ReceiveUnsigned1ByteNumber 数字 从已连接的蓝牙设备接收一个未签名的1字节数字。
  • 接收双字节带符号数字 ReceiveSigned2ByteNumber 数字 从已连接的蓝牙设备接收一个已签名的2字节数字。
  • 接收双字节无符号数字 ReceiveUnsigned2ByteNumber 数字 从已连接的蓝牙设备接收一个无符号的2字节数字。
  • 接收四字节带符号数字 ReceiveSigned4ByteNumber 数字 从已连接的蓝牙设备接收一个已签名的4字节数字。
  • 接收四字节无符号数字 ReceiveUnsigned4ByteNumber 数字 从已连接的蓝牙设备接收一个无符号的4字节数字。
  • 接收带符号字节到列表 ReceiveSignedBytes 列表 字节数 numberOfBytes: 数字 从已连接的蓝牙设备接收多个已签名的字节值。如果 numberOfBytes 小于 0，则持续读取直至收到一个分隔符字节值。
  • 接收无符号字节到列表 ReceiveUnsignedBytes 列表 字节数 numberOfBytes: 数字 从已连接的蓝牙设备接收多个未签名的字节值。如果 numberOfBytes 小于 0，则继续读取，直到收到一个分隔符字节值。
  • 等待连接 AcceptConnectionAsync 服务名 serviceName: 文本, 回调 callback: 过程 以指定名字启动服务等待连接，连接成功后调用回调函数
  • 等待连接 AcceptConnectionWithUUIDAsync 服务名 serviceName: 文本, 唯一编号 uuid: 文本, 回调 callback: 过程 以指定名字和UUID启动服务等待连接，连接成功后调用回调函数
  • 断开连接 Disconnect 断开与已连接的蓝牙设备的连接。
  • 停止接受连接 StopAccepting 停止接受传入连接。
  • 设为可发现 SetDiscoverable 秒数 seconds: 数字, 回调 callback: 过程 默认最多开启300秒

经典蓝牙客户端 BluetoothClient

使用BluetoothClient将您的设备连接到使用蓝牙的其他设备。此组件使用串行端口配置文件（SPP）进行通信。如果您有兴趣使用低功耗蓝牙，请参阅蓝牙LE扩展。

属性

  • 地址 Address 文本 只代码, 只读 暂无描述
  • 地址及名称列表 AddressesAndNames 列表 只代码, 只读 已配对蓝牙设备的地址和名称
  • 是否可用 Available 布尔 只代码, 只读 如果设备上的蓝牙可用，则返回true，否则返回false。
  • 字符编码 CharacterEncoding 文本 返回发送和接收文本时使用的字符编码。
  • 分隔符字节码 DelimiterByte 数字 返回在调用 ReceiveText、ReceiveSignedBytes 或 ReceiveUnsignedBytes 时，当 numberOfBytes 参数为负数时所使用的分隔符字节。
  • 名称 DeviceName 文本 只代码, 只读 暂无描述
  • 是否出错时断开连接 DisconnectOnError 布尔 当发生错误时，自动断开BluetoothClient的连接。
  • 是否启用 Enabled 布尔 只代码, 只读 如果蓝牙已启用，则返回true，否则返回false。
  • 是否高位优先 HighByteFirst 布尔 指定发送和接收数字时，是否以最高有效字节在前。
  • 是否已连接 IsConnected 布尔 只代码, 只读 如果已建立与蓝牙设备的连接，则返回true。
  • 是否正在连接 IsConnecting 布尔 只代码, 只读 暂无描述
  • 是否正在扫描 IsDiscovering 布尔 只代码, 只读 暂无描述
  • 是否启用安全连接 Secure 布尔 指定是否应使用安全连接。

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 已断开连接 Disconnected 设备地址 deviceAddress: 文本, 设备名称 deviceName: 文本 暂无描述

方法

  • 开启 Enable 暂无描述
  • 关闭 Disable 暂无描述
  • 请求权限 RequestPermissions 回调 callback: 过程 暂无描述
  • 发送文本 SendText 文本 text: 文本 向已连接的蓝牙设备发送文本。
  • 发送单字节数字 Send1ByteNumber 数字 number: 文本 向已连接的蓝牙设备发送一个1字节的数字。
  • 发送双字节数字 Send2ByteNumber 数字 number: 文本 向已连接的蓝牙设备发送一个2字节的数字。
  • 发送四字节数字 Send4ByteNumber 数字 number: 文本 向已连接的蓝牙设备发送一个4字节的数字。
  • 发送字节列表 SendBytes 列表 list: 列表 向已连接的蓝牙设备发送一个字节值列表。
  • 可接收字节数 BytesAvailableToReceive 数字 返回输入流中可用的字节数。
  • 接收文本 ReceiveText 文本 字节数 numberOfBytes: 数字 从已连接的蓝牙设备接收文本。如果 numberOfBytes 小于 0，则持续读取直至收到一个定界符字节值。
  • 接收单字节带符号数字 ReceiveSigned1ByteNumber 数字 从已连接的蓝牙设备接收一个已签名的1字节数字。
  • 接收单字节无符号数字 ReceiveUnsigned1ByteNumber 数字 从已连接的蓝牙设备接收一个未签名的1字节数字。
  • 接收双字节带符号数字 ReceiveSigned2ByteNumber 数字 从已连接的蓝牙设备接收一个已签名的2字节数字。
  • 接收双字节无符号数字 ReceiveUnsigned2ByteNumber 数字 从已连接的蓝牙设备接收一个无符号的2字节数字。
  • 接收四字节带符号数字 ReceiveSigned4ByteNumber 数字 从已连接的蓝牙设备接收一个已签名的4字节数字。
  • 接收四字节无符号数字 ReceiveUnsigned4ByteNumber 数字 从已连接的蓝牙设备接收一个无符号的4字节数字。
  • 接收带符号字节到列表 ReceiveSignedBytes 列表 字节数 numberOfBytes: 数字 从已连接的蓝牙设备接收多个已签名的字节值。如果 numberOfBytes 小于 0，则继续读取，直到接收到一个定界符字节值。
  • 接收无符号字节到列表 ReceiveUnsignedBytes 列表 字节数 numberOfBytes: 数字 从已连接的蓝牙设备接收多个未签名的字节值。如果 numberOfBytes 小于 0，则持续读取直至收到一个定界符字节值。
  • 是否已配对 IsDevicePaired 布尔 地址 address: 文本 检查具有指定地址的蓝牙设备是否已配对。
  • 连接 ConnectAsync 地址 address: 文本, 回调 callback: 过程 连接到指定地址的蓝牙设备，连接成功后调用回调函数
  • 与设备连接 ConnectWithUUIDAsync 地址 address: 文本, 唯一编号 uuid: 文本, 回调 callback: 过程 以指定的地址和UUID连接到蓝牙设备，连接成功后调用回调函数
  • 断开连接 Disconnect 断开与已连接的蓝牙设备的连接。
  • 开始扫描 StartScanning 找到设备回调 foundDeviceCallback: 过程, 完成回调 finishCallback: 过程 暂无描述
  • 停止扫描 StopScanning 暂无描述
  • 配对 Pair 地址 address: 文本, 回调 callback: 过程 暂无描述
  • 取消配对 Unpair 地址 address: 文本, 回调 callback: 过程 暂无描述

低功耗蓝牙 BluetoothLE

低功耗蓝牙，也称为BLE，是一种新的蓝牙协议，功耗更低。

属性

  • 广播扫描时长 AdvertisementScanPeriod 数字 只代码, 只读 广播扫描时长
  • 广播地址列表 AdvertiserAddresses 列表 只代码, 只读 扫描广播发现的设备地址列表
  • 是否自动重连 AutoReconnect 布尔 是否自动重连，如果设置为“真”，但连接因为信号原因断开时自动重连。
  • 已连接设备名称 ConnectedDeviceName 文本 只代码, 只读 当前已连接设备的广播名称
  • 已连接设备信号强度 ConnectedDeviceRssi 数字 只代码, 只读 已连接设备的信号强度
  • 连接超时（秒） ConnectionTimeout 数字 尝试连接的超时时间
  • 服务UUID与特征UUID与特征名称列表的列表 DeviceCharacteristics 列表 只代码, 只读 服务UUID与特征UUID与特征名称的列表
  • 地址与名称与信号强度列表的字符串 DeviceList 文本 只代码, 只读 返回 BLE 设备列表的字符串，多个设备地址、名称和信号强度以英文逗号连接.
  • 服务UUID与名称列表的列表 DeviceServices 列表 只代码, 只读 服务UUID与名称的列表
  • 地址与名称与信号强度列表的列表 DeviceYailList 列表 只代码, 只读 返回 BLE 设备列表的列表，每个列表项包括设备地址、名称和信号强度
  • 是否正在广播 IsDeviceAdvertising 布尔 只代码, 只读 当前设备是否正在发送广播
  • 是否已连接 IsDeviceConnected 布尔 只代码, 只读 是否已连接 BLE 设备
  • 是否需要使用定位 LocationNeeded 布尔 暂无描述
  • 是否使用字符串结束符 NullTerminateStrings 布尔 是否以 0 值作为发送数据的结束标记
  • 是否正在扫描 Scanning 布尔 只代码, 只读 是否正在寻找设备
  • 特征UUID与特征名称列表的字符串 SupportedCharacteristicsList 文本 只代码, 只读 特征UUID与特征名称列表的字符串
  • 服务UUID与名称列表的字符串 SupportedServicesList 文本 只代码, 只读 服务UUID与名称列表的字符串

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 已连接 Connected 成功连接到设备时触发
  • 连接失败 ConnectionFailed 原因 reason: 文本 连接设备失败时触发
  • 已断开连接 Disconnected 断开连接时触发
  • 找到设备 DeviceFound 地址 address: 文本, 名称 name: 文本, 信号强度 rssi: 数字, 传输功率 txPower: 数字 找到设备时触发
  • 信号强度改变 RssiChanged 信号强度 rssi: 数字 信号强度改变时触发
  • MTU改变 MTUChanged 大小 size: 数字 MTU改变时触发
  • 收到字节列表 BytesReceived 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 字节数据列表 byteValues: 列表 收到字节或字节列表
  • 输出字节列表 BytesWritten 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 字节数据列表 byteValues: 列表 完成字节或字节列表输出
  • 收到短整型数据 ShortsReceived 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 短整型数据列表 shortValues: 列表 收到短整型或短整型列表
  • 输出短整型数据 ShortsWritten 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 短整型数据列表 shortValues: 列表 完成短整型或短整型列表输出
  • 收到整型数据 IntegersReceived 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 整型数据列表 intValues: 列表 收到整型或整型列表
  • 输出整型数据 IntegersWritten 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 整型数据列表 intValues: 列表 完成整型或整型列表输出
  • 收到浮点数据 FloatsReceived 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 浮点数据列表 floatValues: 列表 收到浮点数或浮点数列表
  • 输出浮点数据 FloatsWritten 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 浮点数据列表 floatValues: 列表 完成浮点数或浮点数列表输出
  • 收到字符数据 StringsReceived 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 字符串数据列表 stringValues: 列表 收到字符或字符列表
  • 输出字符数据 StringsWritten 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 字符串数据列表 stringValues: 列表 完成字符或字符列表输出
  • 收到广播 AdvertiserFound 地址 address: 文本, 名称 name: 文本, 信号强度 rssi: 数字, 传输功率 txPower: 数字, 数据字典 dataDictionary: dictionary 找到广播设备时触发

方法

  • 开始扫描 StartScanning 寻找附近的低功耗蓝牙设备
  • 停止扫描 StopScanning 停止寻找低功耗蓝牙设备
  • 连接 Connect 序号 index: 数字 连接到设备列表中指定序号的设备，序号从 1 开始
  • 连接到 ConnectWithAddress 地址 address: 文本 连接到指定地址的设备
  • 连接到 ConnectMatchingName 名称 name: 文本 连接到指定名字的设备
  • 断开连接 Disconnect 断开当前连接的设备
  • 断开连接 DisconnectWithAddress 地址 address: 文本 断开与指定设备的连接
  • 获取服务UUID ServiceByIndex 文本 序号 index: 数字 返回设备列表中指定序号设备的服务UUID
  • 获取特征UUID与特征名称列表 GetCharacteristicsForService 列表 服务UUID serviceUuid: 文本 返回指定服务的特征列表，列表项为特征UUID和特征名字对
  • 获取特征UUID CharacteristicByIndex 文本 序号 index: 数字 返回当前连接设备中指定序号的特征UUID
  • 扫描特定服务 ScanForService 服务UUID serviceUuid: 文本 寻找附近以指定服务UUID等待连接的设备
  • 获取字节列表 ReadBytes 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔 从指定特征读取 8bit 整数的字节或字节列表，阻塞等待直至收到数据后触发对应事件
  • 监听接收字节列表 RegisterForBytes 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔 功能描述同上，不阻塞等待
  • 输出字节列表 WriteBytes 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔, 数据 values: 任意 向指定特征写单字节或字节列表，阻塞等待。如果“有符号”则数据范围为 -128 到 127，否则为 0 到 255。
  • 输出字节列表并等待响应 WriteBytesWithResponse 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔, 数据 values: 任意 功能描述同上，但是等待响应，得到响应后触发对应事件
  • 获取短整型数据 ReadShorts 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔 从指定特征读取 16bit 整数的短整型或短整型列表，阻塞等待直至收到数据后触发对应事件
  • 监听接收短整型数据 RegisterForShorts 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔 功能描述同上，不阻塞等待
  • 输出短整型数据 WriteShorts 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔, 数据 values: 任意 向指定特征写短整型或短整型列表，阻塞等待。如果“有符号”则数据范围为 -32768 到 32767，否则为 0 到 65535。
  • 输出短整型数据并等待响应 WriteShortsWithResponse 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔, 数据 values: 任意 功能描述同上，但是等待响应，得到响应后触发对应事件
  • 获取整型数据 ReadIntegers 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔 从指定特征读取 32bit 整数的整型或整型列表，阻塞等待直至收到数据后触发对应事件
  • 监听接收整型数据 RegisterForIntegers 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔 功能描述同上，不阻塞等待
  • 输出整型数据 WriteIntegers 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔, 数据 values: 任意 向指定特征写整型或整型列表，阻塞等待。如果“有符号”则数据范围为 -2147483648 到 2147483647，否则为 0 到 4294967295。
  • 输出整型数据并等待响应 WriteIntegersWithResponse 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否有符号 signed: 布尔, 数据 values: 任意 功能描述同上，但是等待响应，得到响应后触发对应事件
  • 获取浮点数据 ReadFloats 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否为短浮点数据 shortFloat: 布尔 从指定特征读取浮点数或浮点数列表，阻塞等待直至收到数据后触发对应事件。如果为“短浮点数”，则每个 16bit，否则每个 32bit。
  • 监听接收浮点数据 RegisterForFloats 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否为短浮点数据 shortFloat: 布尔 功能描述同上，不阻塞等待
  • 输出浮点数据 WriteFloats 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否为短浮点数据 shortFloat: 布尔, 数据 values: 任意 向指定特征写浮点数或浮点数列表，阻塞等待。如果为“短浮点数”，则每个数压缩到 16bit，否则每个数使用 32bit。
  • 输出浮点数据并等待响应 WriteFloatsWithResponse 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否为短浮点数据 shortFloat: 布尔, 数据 values: 任意 功能描述同上，但是等待响应，得到响应后触发对应事件
  • 获取字符串数据 ReadStrings 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否为UTF16数据 utf16: 布尔 从指定特征读取不是结束符的字符或字符列表，阻塞等待直至收到数据后触发对应事件。如果设置为 UTF16，则以 UTF-16LE 解码，否则为 UTF8。
  • 监听接收字符串数据 RegisterForStrings 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否为UTF16数据 utf16: 布尔 功能描述同上，不阻塞等待
  • 输出字符串数据 WriteStrings 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否为UTF16数据 utf16: 布尔, 数据 values: 任意 向指定特征写字符或字符列表，阻塞等待。如果设置为 UTF16，则以 UTF-16LE 编码发送，否则为 UTF8。
  • 输出字符串数据并等待响应 WriteStringsWithResponse 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本, 是否为UTF16数据 utf16: 布尔, 数据 values: 任意 功能描述同上，但是等待响应，得到响应后触发对应事件
  • 停止监听接收数据 UnregisterForValues 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本 停止等待指定特征的数据
  • 开始广播 StartAdvertising 数据 inData: 文本, 服务UUID serviceUuid: 文本 携带数据发送蓝牙广播
  • 停止广播 StopAdvertising 停止正在进行的广播
  • 扫描广播 ScanAdvertisements 扫描时长 scanPeriod: 数字 寻找附近的蓝牙广播
  • 停止扫描广播 StopScanningAdvertisements 停止寻找蓝牙广播
  • 获取广播数据 AdvertisementData 文本 地址 address: 文本, 服务UUID serviceUuid: 文本 获取指定地址和服务UUID的广播数据，如果没有则返回空文本。
  • 获取广播数据字典 AdvertiserDataDictionary dictionary 地址 address: 文本 获取指定地址广播数据字典，为服务UUID和数据对。
  • 获取广播服务UUID列表 AdvertiserServiceUuids 列表 地址 address: 文本 获取广播设备的服务UUID列表
  • 连接到 ConnectToDeviceWithServiceAndName 服务UUID serviceUuid: 文本, 名称 name: 文本 连接到指定服务UUID和名字的设备
  • 获取设备信号强度 FoundDeviceRssi 数字 序号 index: 数字 获取设备列表中指定序号设备的信号强度
  • 获取设备名称 FoundDeviceName 文本 序号 index: 数字 获取设备列表中指定序号设备的名称
  • 获取设备地址 FoundDeviceAddress 文本 序号 index: 数字 获取设备列表中指定序号设备的地址
  • 设置MTU RequestMTU 大小 size: 数字 请求设置MTU，成功则触发“MTU改变”事件。默认为 23，实际可用 20。蓝牙 4.2 以上支持设置大小，推荐值为 247，实际可用 244。
  • 获取信号强度 ReadConnectedRssi 读取连接设备的信号强度，成功则触发“信号强度改变”事件
  • 特征可读 CanReadCharacteristic 布尔 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本 检测指定服务UUID和特征UUID是否可读
  • 特征可监听 CanRegisterForCharacteristic 布尔 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本 检测指定服务UUID和特征UUID是否可监听
  • 特征可写 CanWriteCharacteristic 布尔 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本 检测指定服务UUID和特征UUID是否可写
  • 特征可阻塞写 CanWriteCharacteristicWithResponse 布尔 服务UUID serviceUuid: 文本, 特征UUID characteristicUuid: 文本 检测指定服务UUID和特征UUID是否可写并等待响应

HTTP客户端 Web

为HTTP GET、POST、PUT和DELETE请求提供函数的不可见组件。

属性

  • 是否允许使用Cookies AllowCookies 布尔 指定是否应允许使用Cookie
  • 是否忽略SSL证书错误 IgnoreSslErrors 布尔 确定是否忽略SSL错误。设置为true可忽略错误。使用此选项可接受来自网站的自行签署式证书。
  • 请求头双层列表或字典 RequestHeaders 列表 只代码 设置 请求 表头s.
  • 响应文件路径 ResponseFileName 文本 应保存响应的文件名。如果SaveResponse为true且ResponseFileName为空，则将生成一个新的文件名。
  • 响应内容编码 ResponseTextEncoding 文本 指定响应文本编码。
  • 是否保存响应信息 SaveResponse 布尔 指定是否 响应 应该 是保存d 文件.
  • 通讯超时（毫秒） Timeout 数字 返回每个请求在超时前等待响应的毫秒数。如果设置为0，则请求将无限期等待响应。
  • 网址 Url 文本 指定 URL.

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 获得文本 GotText 网址 url: 文本, 响应代码 responseCode: 数字, 响应类型 responseType: 文本, 响应头字典 responseHeaders: dictionary, 响应内容 responseContent: 文本 表示请求已完成的事件。
  • 获得文件 GotFile 网址 url: 文本, 响应代码 responseCode: 数字, 响应类型 responseType: 文本, 响应头字典 responseHeaders: dictionary, 文件路径 filePath: 文本 表示请求已完成的事件。

方法

  • 设置出错回调 SetOnErrorCallback 回调 callback: 过程 仅对当前请求有效，设置请求出错时的回调函数
  • 设置获得响应回调 SetGotResponseCallback 回调 callback: 过程 仅对当前请求有效，设置收到服务器响应时的回调函数，不设置则触发 GotText 或 GotFile 事件
  • 设置发送文件回调 SetSendingFileCallback 回调 callback: 过程 仅对当前请求有效，在发送文件的过程中回调设置的函数
  • 设置保存文件回调 SetSavingResponseCallback 回调 callback: 过程 仅对当前请求有效，当选择保存响应为文件时，在接收文件的过程中回调设置的函数 注意：当服务器没有返回内容长度时，totalBytes 为 -1
  • 设置请求标识 SetRequestID 请求标识 requestId: 文本 仅对当前请求有效，设置请求的标识，以便必要时中止请求
  • 中止请求 AbortRequest 请求标识 requestId: 文本 中止指定的请求
  • 执行GET请求 MethodGet 使用Url属性执行HTTP GET请求并检索响应。
    如果SaveResponse属性为true，则响应将被保存在一个文件中，并且会触发GotFile事件。可以使用ResponseFileName属性指定文件名。
    如果SaveResponse属性为false，则会触发GotText事件。
  • 执行POST文本请求 PostText 文本 text: 文本 使用Url属性和指定的文本执行HTTP POST请求。文本的字符使用UTF-8编码。如果SaveResponse属性为true，则响应将保存在文件中，并触发GotFile事件。responseFileName属性可用于指定文件的名称。如果SaveResponse属性为false，将触发GotText事件。
  • 执行POST文本请求 PostTextWithEncoding 文本 text: 文本, 字符编码 encoding: 文本 使用Url属性和指定的文本执行HTTP POST请求。文本的字符使用给定的编码进行编码。如果SaveResponse属性为true，则响应将保存在文件中，并触发GotFile事件。ResponseFileName属性可用于指定文件的名称。如果SaveResponse属性为false，将触发GotText事件。
  • 执行POST文件请求 PostFile 路径 path: 文本 使用Url属性和指定文件中的数据执行HTTP POST请求。如果SaveResponse属性为true，则响应将被保存在一个文件中，并且会触发GotFile事件。可以使用ResponseFileName属性指定文件名。如果SaveResponse属性为false，则会触发GotText事件。
  • 执行多块POST请求 MultipartPost 字段双层列表或字典 formFields: 列表, 文件双层列表或字典 formFiles: 列表 参数分别是表单字段键值对，和文件域名字和文件路径值对
  • 执行PUT文本请求 PutText 文本 text: 文本 使用Url属性和指定的文本执行HTTP PUT请求。文本的字符使用UTF-8编码。如果SaveResponse属性为true，则响应将保存在文件中，并触发GotFile事件。responseFileName属性可用于指定文件的名称。如果SaveResponse属性为false，将触发GotText事件。
  • 执行PUT文本请求 PutTextWithEncoding 文本 text: 文本, 字符编码 encoding: 文本 使用Url属性和指定的文本执行HTTP PUT请求。文本的字符使用给定的编码进行编码。如果SaveResponse属性为true，则响应将保存在文件中，并触发GotFile事件。ResponseFileName属性可用于指定文件的名称。如果SaveResponse属性为false，将触发GotText事件。
  • 执行PUT文件请求 PutFile 路径 path: 文本 使用Url属性以及指定文件中的数据执行HTTP PUT请求。如果SaveResponse属性为true，则响应将被保存在一个文件中，并且会触发GotFile事件。可以使用ResponseFileName属性来指定文件名。如果SaveResponse属性为false，则会触发GotText事件。
  • 执行多块PUT请求 MultipartPut 字段双层列表或字典 formFields: 列表, 文件双层列表或字典 formFiles: 列表 参数分别是表单字段键值对，和文件域名字和文件路径值对
  • 执行PATCH文本请求 PatchText 文本 text: 文本 使用Url属性和指定的文本执行HTTP PATCH请求。文本的字符使用UTF-8编码。如果SaveResponse属性为true，则响应将保存在文件中，并触发GotFile事件。responseFileName属性可用于指定文件的名称。如果SaveResponse属性为false，将触发GotText事件。
  • 执行PATCH文本请求 PatchTextWithEncoding 文本 text: 文本, 字符编码 encoding: 文本 使用Url属性和指定的文本执行HTTP PATCH请求。文本的字符使用给定的编码进行编码。如果SaveResponse属性为true，则响应将保存在文件中，并触发GotFile事件。ResponseFileName属性可用于指定文件的名称。如果SaveResponse属性为false，将触发GotText事件。
  • 执行PATCH文件请求 PatchFile 路径 path: 文本 使用Url属性和指定文件中的数据执行HTTP PATCH请求。如果SaveResponse属性为true，则响应将被保存在一个文件中，并且会触发GotFile事件。可以使用ResponseFileName属性指定文件名。如果SaveResponse属性为false，则会触发GotText事件。
  • 执行多块PATCH请求 MultipartPatch 字段双层列表或字典 formFields: 列表, 文件双层列表或字典 formFiles: 列表 参数分别是表单字段键值对，和文件域名字和文件路径值对
  • 执行DELETE请求 MethodDelete 使用Url属性执行HTTP DELETE请求并检索响应。
    如果SaveResponse属性为true，则响应将被保存在一个文件中，并且会触发GotFile事件。可以使用ResponseFileName属性指定文件名。
    如果SaveResponse属性为false，则会触发GotText事件。
  • 清除Cookies ClearCookies 清除此Web组件的所有Cookie。
  • 创建请求数据 BuildRequestData 文本 字段双层列表或字典 formFields: 列表 将表示名称和值对的两个元素子列表的列表转换为格式为application/x-www-form-urlencoded媒体类型的字符串，适合传递给PostText。
  • URL编码 UriEncode 文本 文本 text: 文本 对给定的文本值进行编码，以便其能在URL中使用。
  • URL解码 UriDecode 文本 文本 text: 文本 对已编码的文本值进行解码。
  • 解码HTML文本 HtmlTextDecode 文本 HTML文本 htmlText: 文本 对给定的HTML文本值进行解码。HTML字符实体（如&、<、>、'和"）将被替换为对应的字符。诸如&#xhhhh;和&#nnnn;之类的实体将被转换为相应的字符。

MQTT客户端 MqttClient

MQTT客户端

属性

  • 客户端标识 ClientId 文本 客户端标识
  • 连接超时（秒） ConnectionTimeout 数字 连接超时（秒）
  • 是否忽略SSL证书错误 IgnoreSslErrors 布尔 暂无描述
  • 保持连接间隔（秒） KeepAliveInterval 数字 心跳间隔（秒）
  • 是否自动重连 MqttAutoReconnect 布尔 连接非正常断开后是否自动重连
  • 密码 Password 文本 密码
  • 服务器URI ServerUri 文本 服务器 URI
  • 用户名称 Username 文本 用户名
  • 等待超时（秒） WaitTimeout 数字 等待超时（秒）

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 收到消息 MessageReceived 主题 topic: 文本, 消息 message: 任意 收到消息，如果订阅字节列表则消息为字节列表，否则为字符串
  • 消息已发送 MessageSent 主题 topic: 文本, 消息 message: 任意 消息发送完成
  • 连接中断 ConnectionLost 消息 message: 文本 连接断开
  • 已连接 Connected 连接成功
  • 订阅成功 Subscribed 主题 topic: 文本, 消息可靠性级别 qos: 数字 订阅成功
  • 退订成功 Unsubscribed 主题 topic: 文本 退订成功

方法

  • 连接 Connect 暂无描述
  • 连接 ConnectWithWill 遗嘱主题 willTopic: 文本, 消息 message: 任意, 是否在服务器保留消息 retained: 布尔, 消息可靠性级别 qos: 数字 连接并寄存遗嘱消息，消息可以是文本或字节列表。客户端非正常断开时服务器自动往遗嘱主题发送消息
  • 断开连接 Disconnect 暂无描述
  • 是否已连接 IsConnected 布尔 暂无描述
  • 发布 Publish 主题 topic: 文本, 消息 message: 文本, 是否在服务器保留消息 retained: 布尔, 消息可靠性级别 qos: 数字 消息可靠性级别（QoS） 0：客户端只发送一次；1：确保服务器收到消息（可能重复）；2：确保服务器收到消息（不重复）
  • 订阅 Subscribe 主题 topic: 文本, 消息可靠性级别 qos: 数字 消息可靠性级别（QoS） 0：服务器只发送一次；1：确保客户端收到消息（可能重复）；2：确保客户端收到消息（不重复）
  • 发布字节列表 PublishBytes 主题 topic: 文本, 字节列表 byteList: 列表, 是否在服务器保留消息 retained: 布尔, 消息可靠性级别 qos: 数字 发布字节列表到主题
  • 订阅字节列表 SubscribeBytes 主题 topic: 文本, 消息可靠性级别 qos: 数字 订阅字节列表消息的主题
  • 退订 Unsubscribe 主题 topic: 文本 暂无描述

UART串口通信 Serial

串行组件

属性

  • 波特率 BaudRate 数字 返回 当前 baud 速率
  • 数据位 DataBits 数字 暂无描述
  • 是否已初始化 IsInitialized 布尔 只代码, 只读 初始化串行后返回true。
  • 是否已连接 IsOpen 布尔 只代码, 只读 当串行连接处于打开状态时，返回true。
  • 校验位 ParityBit 数字 0：无奇偶校验 1：奇数奇偶校验 2：偶数奇偶校验 3：标记奇偶校验 4：空格奇偶校验
  • 读缓存区大小（字节） ReadBufferSize 数字 返回读取缓冲区的大小（以字节为单位）
  • 读超时（毫秒） ReadTimeout 数字 暂无描述
  • 停止位 StopBits 数字 1：1个停止位 2：2个停止位 3：1.5个停止位
  • 写缓存区大小（字节） WriteBufferSize 数字 返回写缓冲区的大小（以字节为单位）
  • 写超时（毫秒） WriteTimeout 数字 暂无描述

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 初始化成功 Initialized 串行初始化

方法

  • 初始化串口连接 InitializeSerial 初始化串行连接。
  • 打开连接 OpenSerial 布尔 打开串行连接。打开时返回true。
  • 关闭连接 CloseSerial 布尔 关闭串行连接。当连接关闭时返回true。
  • 读文本数据 ReadSerial 文本 从串口读取数据。
  • 写文本数据 WriteSerial 文本 text: 文本 将给定数据写入串行端口。
  • 写文本数据并追加换行 PrintSerial 文本 text: 文本 将给定数据写入串行端口，并在末尾添加新行。
  • 读字节列表数据 ReadSerialList 列表 数据长度 dataLength: 数字 从缓存读出指定长度的字节数据到列表中返回
  • 写字节列表数据 WriteSerialList 字节列表 byteList: 列表 将字节列表数据写到串口
  • 清空读缓存 PurgeReadBuffer 暂无描述
  • 清空写缓存 PurgeWriteBuffer 暂无描述
  • 获取CTS GetCTS 布尔 暂无描述
  • 获取DSR GetDSR 布尔 暂无描述
  • 设置DTR SetDTR 值 value: 布尔 暂无描述
  • 设置RTS SetRTS 值 value: 布尔 暂无描述
  • 设置中断 SetBreak 值 value: 布尔 暂无描述

ESP智能配网 EspSmartConfig

为 ESP8266/ESP32 等支持 ESP SmartConfig 协议的设备配置无线网络连接

属性

  • 是否显示进度对话框 ShowProgressDialog 布尔 显示正在广播进度对话框

事件

  • 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
  • 设备已连接 DeviceConnected IP地址 ip: 文本, MAC地址 mac: 文本 暂无描述
  • 广播已取消 BroadcastingCanceled 暂无描述
  • 网络状态改变 NetworkStatusChanged 暂无描述
  • 配网失败 ConfigureFailed 暂无描述
  • 配网成功 ConfigureSucceeded 暂无描述

方法

  • 获取当前连接无线网络信息 GetConnectedWiFiInfo 列表 信息列表，分别为：SSID, BSSID, IpAddress, MacAddress, IsHiddenSSID, Frequency, LinkSpeed, Rssi
  • 是否连接2.4G无线网络 Is2gWiFiConnected 布尔 暂无描述
  • 是否已开启定位服务 IsLocationEnabled 布尔 暂无描述
  • 开始配网广播 StartBroadcasting WiFi名称 ssid: 文本, BSSID bssid: 文本, 密码 password: 文本, 配网设备数 devicesToConfig: 数字, 是否广播模式 isMulticast: 布尔 暂无描述
  • 开始一次配网广播 StartBroadcastOnce 密码 password: 文本, 是否广播模式 isMulticast: 布尔 暂无描述
  • 停止配网广播 StopBroadcasting 暂无描述