Android Things Bluetooth GATT Server 示例项目教程

Android Things Bluetooth GATT Server 示例项目教程

sample-bluetooth-le-gattserverBuild a Bluetooth GATT server with Android Things项目地址:https://gitcode.com/gh_mirrors/sa/sample-bluetooth-le-gattserver

1. 项目目录结构及介绍

sample-bluetooth-le-gattserver/
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── gitignore
├── java/
│   ├── MainActivity.java
│   ├── BluetoothLeService.java
│   └── ...
├── kotlin/
│   └── ...
└── ...

目录结构说明

• CONTRIBUTING.md: 贡献指南文件，描述如何为项目贡献代码。
• LICENSE: 项目使用的开源许可证文件，本项目使用 Apache-2.0 许可证。
• README.md: 项目的主文档文件，包含项目的概述、安装和使用说明。
• gitignore: Git 忽略文件配置，指定哪些文件或目录不需要被 Git 追踪。
• java/: 包含项目的主要 Java 源代码文件。
• kotlin/: 包含项目可能使用的 Kotlin 源代码文件（本项目中未使用）。

2. 项目启动文件介绍

MainActivity.java

MainActivity.java 是项目的启动文件，负责初始化应用程序并启动蓝牙 GATT 服务。以下是该文件的主要功能：

public class MainActivity extends Activity {
    private BluetoothLeService mBluetoothLeService;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化蓝牙服务
        mBluetoothLeService = new BluetoothLeService(this);
        mBluetoothLeService.initialize();
    }

    @Override
    protected void onResume() {
        super.onResume();
        // 启动蓝牙服务
        mBluetoothLeService.start();
    }

    @Override
    protected void onPause() {
        super.onPause();
        // 停止蓝牙服务
        mBluetoothLeService.stop();
    }
}

功能说明

• onCreate(): 初始化应用程序界面，并初始化蓝牙服务。
• onResume(): 当应用程序进入前台时，启动蓝牙服务。
• onPause(): 当应用程序进入后台时，停止蓝牙服务。

3. 项目的配置文件介绍

AndroidManifest.xml

AndroidManifest.xml 是 Android 项目的配置文件，定义了应用程序的基本信息、权限和组件。以下是该文件的主要内容：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.bluetooth.le">

    <uses-permission android:name="android.permission.BLUETOOTH"/>
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
    </application>
</manifest>

配置说明

• 权限声明:

  • BLUETOOTH: 允许应用程序连接到蓝牙设备。
  • BLUETOOTH_ADMIN: 允许应用程序发现和配对蓝牙设备。
  • ACCESS_FINE_LOCATION: 允许应用程序访问精确的位置信息，用于蓝牙设备扫描。

• 应用程序组件:

  • MainActivity: 定义了应用程序的主活动，是应用程序的入口点。

通过以上配置，项目能够正常运行并使用蓝牙 GATT 服务进行设备间的通信。

sample-bluetooth-le-gattserverBuild a Bluetooth GATT server with Android Things项目地址:https://gitcode.com/gh_mirrors/sa/sample-bluetooth-le-gattserver