📚 课程目录第3章蓝牙开关控制

3. 蓝牙开关控制

任务说明

本案例实现Android系统中蓝牙的开启与关闭控制，并实时监听蓝牙状态变化。核心目标：通过代码调用系统蓝牙接口完成开关操作，同时注册BroadcastReceiver监听ACTION_STATE_CHANGED广播，在界面显示当前蓝牙状态。案例覆盖权限声明、蓝牙适配器操作、动态广播注册与注销的完整闭环。

实现方案

使用BluetoothAdapter执行开关操作，通过registerReceiver动态注册广播接收器监听蓝牙状态变化。界面提供两个按钮分别触发开启与关闭，状态文本实时刷新。代码在onDestroy中注销接收器防止内存泄漏。

代码实现


// MainActivity.java
package com.example.btcontrol;

import android.bluetooth.BluetoothAdapter;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.os.Bundle;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {
    private BluetoothAdapter bluetoothAdapter;
    private TextView statusText;
    private final BroadcastReceiver bluetoothStateReceiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            if (BluetoothAdapter.ACTION_STATE_CHANGED.equals(intent.getAction())) {
                int state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR);
                updateStatus(state);
            }
        }
    };

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

        bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
        statusText = findViewById(R.id.status_text);
        Button btnOn = findViewById(R.id.btn_on);
        Button btnOff = findViewById(R.id.btn_off);

        if (bluetoothAdapter == null) {
            statusText.setText("设备不支持蓝牙");
            btnOn.setEnabled(false);
            btnOff.setEnabled(false);
            return;
        }

        btnOn.setOnClickListener(v -> {
            if (!bluetoothAdapter.isEnabled()) {
                bluetoothAdapter.enable();
            } else {
                Toast.makeText(this, "蓝牙已开启", Toast.LENGTH_SHORT).show();
            }
        });

        btnOff.setOnClickListener(v -> {
            if (bluetoothAdapter.isEnabled()) {
                bluetoothAdapter.disable();
            } else {
                Toast.makeText(this, "蓝牙已关闭", Toast.LENGTH_SHORT).show();
            }
        });

        // 初始化当前状态
        updateStatus(bluetoothAdapter.getState());
    }

    @Override
    protected void onStart() {
        super.onStart();
        IntentFilter filter = new IntentFilter(BluetoothAdapter.ACTION_STATE_CHANGED);
        registerReceiver(bluetoothStateReceiver, filter);
    }

    @Override
    protected void onStop() {
        super.onStop();
        unregisterReceiver(bluetoothStateReceiver);
    }

    private void updateStatus(int state) {
        String status;
        switch (state) {
            case BluetoothAdapter.STATE_ON:
                status = "蓝牙已开启";
                break;
            case BluetoothAdapter.STATE_TURNING_ON:
                status = "蓝牙正在开启...";
                break;
            case BluetoothAdapter.STATE_OFF:
                status = "蓝牙已关闭";
                break;
            case BluetoothAdapter.STATE_TURNING_OFF:
                status = "蓝牙正在关闭...";
                break;
            default:
                status = "未知状态";
        }
        statusText.setText(status);
    }
}


// activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="24dp"
    android:gravity="center_horizontal">

    <TextView
        android:id="@+id/status_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="未知状态"
        android:textSize="20sp"
        android:textStyle="bold"
        android:layout_marginBottom="32dp"/>

    <Button
        android:id="@+id/btn_on"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="开启蓝牙"
        android:layout_marginBottom="16dp"/>

    <Button
        android:id="@+id/btn_off"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="关闭蓝牙"/>
</LinearLayout>


// AndroidManifest.xml 关键权限
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />

状态变化时序

编译与运行

环境要求：Android Studio 4.0+，minSdkVersion 21，targetSdkVersion 33，真机或模拟器需支持蓝牙（模拟器需配置虚拟蓝牙）。

步骤：

新建工程，将MainActivity.java与activity_main.xml放入对应目录；
在AndroidManifest.xml中添加蓝牙权限（Android 12+需在运行时申请BLUETOOTH_CONNECT权限）；
连接真机或启动模拟器，点击Run安装应用；
点击“开启蓝牙”按钮，观察系统蓝牙开关是否打开；点击“关闭蓝牙”按钮，观察开关是否关闭。

验证方法

功能验证：点击“开启蓝牙”后，系统设置中蓝牙开关应自动打开，界面状态文本依次显示“蓝牙正在开启...”→“蓝牙已开启”；点击“关闭蓝牙”后，开关自动关闭，状态文本依次显示“蓝牙正在关闭...”→“蓝牙已关闭”。

判定标准：状态文本变化与系统蓝牙实际状态一致；快速连续点击开关按钮时，广播接收器能正确捕获中间状态（TURNING_ON/TURNING_OFF）；应用退出后无崩溃或内存泄漏日志。

权限说明：Android 12（API 31）及以上系统要求动态申请BLUETOOTH_CONNECT权限，需在onCreate中添加运行时权限请求逻辑，否则enable()调用将抛出SecurityException。