Bluez文档中蓝牙API函数位置及编译报错问题问询

嘿，我之前也踩过这个坑！问题核心是你混淆了Bluez提供的两类完全不同的API：底层的HCI原生C接口，和高层的DBus服务接口。咱们一步步理清楚：

先搞懂StartDiscovery的归属 #

Bluez官方文档里提到的StartDiscovery并不是直接的C库函数，它是Bluez通过DBus暴露的高层适配器接口方法（属于org.bluez.Adapter1这个DBus对象接口）。你当前包含的<bluetooth/bluetooth.h>、<bluetooth/hci.h>、<bluetooth/hci_lib.h>都是用于底层HCI硬件操作的头文件，里面根本没有这个函数的声明，所以编译必然报错。

下面分两种场景给你解决方案：

场景1：用底层HCI C API实现设备发现 #

如果你想直接通过Bluez的底层C接口做蓝牙设备发现，应该使用hci_start_discovery()函数——这个函数已经在你包含的<bluetooth/hci_lib.h>里声明了。

简单示例代码： #

#include <stdio.h>
#include <bluetooth/bluetooth.h>
#include <bluetooth/hci.h>
#include <bluetooth/hci_lib.h>

int main() {
    // 获取默认蓝牙设备ID
    int dev_id = hci_get_route(NULL);
    // 打开蓝牙设备socket
    int sock = hci_open_dev(dev_id);
    if (sock < 0) {
        perror("Failed to open HCI device");
        return 1;
    }

    // 启动设备发现：参数依次为socket、查询时长、查询类型、查询间隔、查询窗口
    int ret = hci_start_discovery(sock, 8, 0, 0, 0);
    if (ret < 0) {
        perror("Failed to start discovery");
        hci_close_dev(sock);
        return 1;
    }

    printf("Discovery started successfully\n");
    hci_close_dev(sock);
    return 0;
}

编译命令： #

别忘了链接Bluez的蓝牙库：

gcc your_program.c -o your_program -lbluetooth

场景2：调用DBus的StartDiscovery方法（对应文档里的方法） #

如果你的目标是调用Bluez文档里提到的StartDiscovery，那你需要通过DBus和Bluez守护进程通信——这不是直接调用一个C函数，而是要借助DBus客户端库来实现。

需要做的准备： #

• 包含DBus相关头文件：比如用libdbus的话要包含<dbus/dbus.h>，用GLib的GDBus（更易用）的话要包含<gio/gio.h>
• 编译时链接对应的DBus库：比如-ldbus-1（libdbus）或者-lgio-2.0 -lglib-2.0（GDBus）

大致实现步骤（以GDBus为例）： #

1. 连接到系统DBus总线
2. 获取Bluez的适配器对象（默认路径通常是/org/bluez/hci0）
3. 调用org.bluez.Adapter1接口下的StartDiscovery方法

这种方式更贴近Bluez官方文档描述的高层操作，但需要你熟悉DBus的基本使用逻辑。

总结一下：你看到的StartDiscovery是DBus接口方法，不是直接的C函数；如果想用底层C API做发现，用hci_start_discovery()；如果要调用文档里的那个StartDiscovery，就得借助DBus库来实现。

内容的提问来源于stack exchange，提问作者Jack Frye