← 返回内置版参考 · 二进制数据专题 · 全部使用指导

低功耗蓝牙内置版使用指导

准备与工作原理

在通信连接分类拖入内置的低功耗蓝牙，重命名为 BluetoothLowEnergy1，再加入案例中的按钮、文本输入框与一个标签 标签1。

准备真实 BLE 外设，填广播名称及固件定义的服务、通知、写入特征 UUID。名称可包含匹配，确保附近没有同名设备；通知特征需要外设支持 notify。这里用 UTF-8（utf16 为 false），外设二进制协议请改用读写字节积木。案例二的 Connected 事件替换案例一同名事件，不要重复放两个同名事件积木。

案例一：按名称连接设备

when 按钮_连接.Click() {
  BluetoothLowEnergy1.ConnectMatchingName(文本输入框_设备名称.Text)
}
when BluetoothLowEnergy1.Connected() {
  标签1.Text = "已连接"
}
when BluetoothLowEnergy1.ConnectionFailed(原因) {
  标签1.Text = 原因
}

案例二：订阅与写入文本

when BluetoothLowEnergy1.Connected() {
  BluetoothLowEnergy1.RegisterForStrings(文本输入框_服务UUID.Text, 文本输入框_通知UUID.Text, false)
}
when 按钮_发送.Click() {
  BluetoothLowEnergy1.WriteStrings(文本输入框_服务UUID.Text, 文本输入框_写入UUID.Text, false, 文本输入框_发送.Text)
}
when BluetoothLowEnergy1.StringsReceived(服务UUID, 特征UUID, 字符串值) {
  标签1.Text = join(字符串值)
}
when 按钮_断开.Click() {
  BluetoothLowEnergy1.Disconnect()
}

常见问题与验收

• 先确认连接成功事件或连接属性，再订阅、发送；收到消息时检查主题/服务和实际内容。
• 对比成功与失败事件。没有消息时，核对服务器或外设端配置，不仅检查应用按钮是否被点击。
• 断开后再次连接并收发一条消息；远端离线时应显示失败或断开状态。
• 真机联机调试需包含本内置组件的新伴侣；拓展版项目的积木名称可能不同，按内置版 API核对。

完整协议背景、硬件准备及更多案例见专题文档。