GodotBLE
by Fantety
17
GodotBLE
一个为Godot4开发的低功率蓝牙插件，可以帮助你的游戏联合更多有趣的设备
插件地址：GodotBLE - Godot Asset Library
概述
这个插件依赖于 SimpleBLE, 使用GDExtension, 但是仅仅支持低功率蓝牙，并不支持经典蓝牙。
平台支持
| 平台 | 版本 |
|---|---|
| Windows | Windows 10+ |
| Linux | 暂时不支持 |
| MacOS | 暂时不支持 |
提供的节点
| 节点 | 描述 |
|---|---|
| GodotBLE | 所有功能都包含在这一个节点当中 |
如何在Godot中加载GodotBLE
首先在godot项目中的任意位置创建一个*.gdextension文件
gdextension文件内容参考
[configuration]
entry_symbol = "gdble_library_init"
compatibility_minimum = "4.4"
[libraries]
windows.debug.x86_64 = "res://bin/windows/libgdble.windows.template_debug.x86_64.dll"
[dependencies]
windows.debug = {
"res://bin/simpleble.dll" : "",
"res://bin/simpleble-c.dll" : ""
}
windows.release = {
"res://bin/simpleble.dll" : "",
"res://bin/simpleble-c.dll" : ""
}
[icons]
GodotBLE = "./bluetooth.svg"可以看到上面的内容包含了三个dll文件，按照gdextension文件所写的路径把这三个文件放到正确的地方就好了。
这个三个文件可以在Release中下载。
怎样在 GDScript 中使用GodotBLE?
在 GodotBLE 节点中提供以下一些函数及方法:
| 方法 | 描述 |
|---|---|
| init_adapter_list() | 用于初始化蓝牙设备适配器 |
| set_adapter(int index) | 选择适配器 |
| start_scan() | 开始扫描环境当中的蓝牙设备 |
| stop_scan() | 停止扫描环境当中的蓝牙设备 |
| bluetooth_enabled() | 返回一个布尔值，用于判断蓝牙适配器是否启用。 |
| get_adapters_index_from_identifier(String identifier) | 根据适配器名称获取其在适配器列表中的索引。 |
| get_device_index_from_identifier(String identifier) | 根据设备名称获取其在设备列表中的索引。 |
| connect_to_device(int index) | 连接到指定的蓝牙设备。 |
| show_all_services() | 显示已连接蓝牙设备的所有服务。 |
| show_all_devices() | 显示当前设备列表中的所有设备。 |
| get_current_adapter_index() | 获取当前所选适配器的索引。 |
| get_current_device_index() | 获取当前连接设备的索引。 |
| read_data_from_service(int index) | 读取数据，index为为characteristic的索引，返回值为字符串 |
| write_data_to_service(int index, String data) | 写入数据，index为characteristic的索引 |
由 GodotBLE 节点提供的信号：
| 信号 | 描述 |
|---|---|
| on_device_found | 发现新设备时触发该信号。返回两个字符串，一个是设备名称，另一个是设备地址。 |
| on_device_update | 设备信息更新时触发该信号。返回两个字符串，一个是设备名称，另一个是设备地址。 |
| scan_start (v0.1.1) | 当扫描设备开始时会发送此信号 |
| scan_stop (v0.1.1) | 当扫描设备停止时会发送此信号 |
示例代码：
extends GodotBLE
signal start_write
func _ready() -> void:
print(init_adapter_list())
set_adapter(0)
start_scan()
pass
func _process(delta: float) -> void:
pass
func _on_on_device_found(identifier: String, address: String) -> void:
print(identifier,'\t',address)
if identifier=='ESP32':
stop_scan()
print(get_device_index_from_identifier('ESP32'))
if connect_to_device(get_device_index_from_identifier('ESP32'))==0:
print("success connnect")
pass
print(show_all_services())
print(get_current_device_index())
emit_signal("start_write")
pass
pass # Replace with function body.
func _on_start_write() -> void:
print("start_write")
print(write_data_to_service(3,"r#hello"))
pass # Replace with function body.Download
Version0.1.0
Download Now
Support
If you need help or have questions about this plugin, please contact the author.
Contact Author