Android API开发之蓝牙开发之Android蓝牙开发基础知识

本章节讲述Android蓝牙 开发的基础知识

 

1.权限

 

在android 清单文件中加入相应的权限

 

允许程序连接到已配对的蓝牙设备

<uses-permissionandroid:name="Android.permission.BLUETOOTH" />
 

 

允许程序发现和配对蓝牙设备
<uses-permissionandroid:name="android.permission.BLUETOOTH_ADMIN" />
 

 

在Android5.0之前，是默认申请GPS硬件功能的。而在Android 5.0 之后，需要在manifest 中申明GPS硬件模块功能的使用

<uses-feature android:name="android.hardware.location.gps" />

 

 

在 Android 6.0 及以上，还需要打开位置权限。如果应用没有位置权限，蓝牙扫描功能不能使用（其它蓝牙操作例如连接蓝牙设备和写入数据不受影响）
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

 

 

 

2.API

 

Android所有关于蓝牙开发的类都在android.bluetooth包下，如下图，只有8个类

 

 

2.1.BluetoothAdapter

 

顾名思义，蓝牙适配器，直到我们建立bluetoothSocket连接之前，都要不断操作它。BluetoothAdapter里的方法很多，常用的有以下几个：

2.1.1.cancelDiscovery() 根据字面意思，是取消发现，也就是说当我们正在搜索设备的时候调用这个方法将不再继续搜索

2.1.2.disable()关闭蓝牙

2.1.3.enable()打开蓝牙，这个方法打开蓝牙不会弹出提示，更多的时候我们需要问下用户是否打开，以下这两行代码同样是打开蓝牙，不过会提示用户：

Intemtenabler=new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
startActivityForResult(enabler,reCode);//同startActivity(enabler);

2.1.4. getAddress()获取本地蓝牙地址
      

2.1.5.getDefaultAdapter()获取默认BluetoothAdapter，实际上，也只有这一种方法获取BluetoothAdapter
      

2.1.6.getName()获取本地蓝牙名称
      

2.1.7.getRemoteDevice(String address)根据蓝牙地址获取远程蓝牙设备
      

2.1.8.getState()获取本地蓝牙适配器当前状态（感觉可能调试的时候更需要）
     

2.1.9.isDiscovering()判断当前是否正在查找设备，是返回true
      

2.1.10.isEnabled()判断蓝牙是否打开，已打开返回true，否则，返回false
     

2.1.11.listenUsingRfcommWithServiceRecord(String name,UUID uuid)根据名称，UUID创建并返回BluetoothServerSocket，这是创建BluetoothSocket服务器端的第一步
      

2.1.12.startDiscovery()开始搜索，这是搜索的第一步

 

 

 

2.2.BluetoothDevice

看名字就知道，这个类描述了一个蓝牙设备

 

2.2.1.createRfcommSocketToServiceRecord(UUIDuuid)根据UUID创建并返回一个BluetoothSocket
 

2.2.2.getState() 蓝牙状态这里要说一下，只有在 BluetoothAdapter.STATE_ON 状态下才可以监听，具体可以看andrid api;

这个方法也是我们获取BluetoothDevice的目的——创建BluetoothSocket

这个类其他的方法，如getAddress(),getName(),同BluetoothAdapter

 

 

3.3.BluetoothServerSocket

如果去除了Bluetooth相信大家一定再熟悉不过了，既然是Socket，方法就应该都差不多，这个类一种只有三个方法两个重载的accept(),accept(inttimeout)两者的区别在于后面的方法指定了过时时间，需要注意的是，执行这两个方法的时候，直到接收到了客户端的请求（或是过期之后），都会阻塞线程，应该放在新线程里运行！


还有一点需要注意的是，这两个方法都返回一个BluetoothSocket，最后的连接也是服务器端与客户端的两个BluetoothSocket的连接

 

 

4.BluetoothSocket 
  

跟BluetoothServerSocket相对，是客户端一共5个方法，不出意外，都会用到
      

4.1.close(),关闭
      

4.2.connect()连接
      

4.3.getInptuStream()获取输入流
      

4.4.getOutputStream()获取输出流
      

4.5.getRemoteDevice()获取远程设备，这里指的是获取bluetoothSocket指定连接的那个远程蓝牙设备

 

 

 

3.简单使用

 

3.1.获取蓝牙适配器

BluetoothAdapter mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();

 

3.2.开启蓝牙 

 

if(!mBluetoothAdapter.isEnabled()){  
//弹出对话框提示用户是后打开  
Intent enabler = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);  
startActivityForResult(enabler, REQUEST_ENABLE);  
} 

 

3.3.获取本地蓝牙信息

 

//获取本机蓝牙名称  
String name = mBluetoothAdapter.getName();  
//获取本机蓝牙地址  
String address = mBluetoothAdapter.getAddress();  
//获取已配对蓝牙设备  
Set<BluetoothDevice> devices = mBluetoothAdapter.getBondedDevices();  
for(BluetoothDevice bonddevice:devices){  
    Log.d(TAG, "bonded device name ="+bonddevice.getName()+" address"+bonddevice.getAddress());  
} 

 

3.4.搜索设备

mBluetoothAdapter.startDiscovery();

3.5.停止搜索

mBluetoothAdapter.cancelDiscovery();

搜索蓝牙设备，该过程是异步的，通过下面注册广播接受者，可以监听是否搜到设备。

IntentFilter filter = new IntentFilter();  
//发现设备  
filter.addAction(BluetoothDevice.ACTION_FOUND);  
//设备连接状态改变  
filter.addAction(BluetoothDevice.ACTION_BOND_STATE_CHANGED);  
//蓝牙设备状态改变  
filter.addAction(BluetoothAdapter.ACTION_STATE_CHANGED);  
registerReceiver(mBluetoothReceiver, filter);  

 

 

3.6.监听扫描结果 

通过广播接收者查看扫描到的蓝牙设备，每扫描到一个设备，系统都会发送此广播（BluetoothDevice.ACTION_FOUNDE）。其中参数intent可以获取蓝牙设备BluetoothDevice。
该demo中是连接指定名称的蓝牙设备，BLUETOOTH_NAME为"Galaxy Nexus",如果扫描不到，记得改这个蓝牙名称

 

private BroadcastReceiver mBluetoothReceiver = new BroadcastReceiver(){  
        @Override  
        public void onReceive(Context context, Intent intent) {  
            String action = intent.getAction();  
            Log.d(TAG,"mBluetoothReceiver action ="+action);  
            if(BluetoothDevice.ACTION_FOUND.equals(action)){//每扫描到一个设备，系统都会发送此广播。  
                //获取蓝牙设备  
                BluetoothDevice scanDevice = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);  
                if(scanDevice == null || scanDevice.getName() == null) return;  
                Log.d(TAG, "name="+scanDevice.getName()+"address="+scanDevice.getAddress());  
                //蓝牙设备名称  
                String name = scanDevice.getName();  
                if(name != null && name.equals(BLUETOOTH_NAME)){  
                    mBluetoothAdapter.cancelDiscovery();  
                    //取消扫描  
                    mProgressDialog.setTitle(getResources().getString(R.string.progress_connecting));                   //连接到设备。  
                    mBlthChatUtil.connect(scanDevice);  
                }  
            }else if (BluetoothAdapter.ACTION_DISCOVERY_FINISHED.equals(action)){  
  
            }  
        }  
          
 };  

 

 

3.7.设置蓝牙可见性

 

有时候扫描不到某设备，这是因为该设备对外不可见或者距离远，需要设备该蓝牙可见，这样该才能被搜索到。可见时间默认值为120s，最多可设置300。

 

if (mBluetoothAdapter.isEnabled()) {  
    if (mBluetoothAdapter.getScanMode() !=   
            BluetoothAdapter.SCAN_MODE_CONNECTABLE_DISCOVERABLE) {  
        Intent discoverableIntent = new Intent(  
                BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);  
        discoverableIntent.putExtra(  
                BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 120);  
        startActivity(discoverableIntent);  
    }  
}